From 734d5e7f84002a6422dfc85d2daa5f5899f65c5a Mon Sep 17 00:00:00 2001 From: Pratyush Desai Date: Fri, 16 Jul 2021 17:56:45 +0530 Subject: [PATCH] add README --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..92966f4 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# IRC Web Registration + +## Introduction + +This is a basic still WIP framework for registering an account on an ircd using a webform. + +## Features + +- It relies on the WIP IRCv3.2 spec [draft/account-registration](https://github.com/ProgVal/ircv3-specifications/blob/register/extensions/account-registration.md) +- It utilizes the flask framework and `WEBIRC` to relay remote host ip address. +- Can be tweaked to allow registration attempts from exit-nodes and other unsavory hosts allowing them to securely work with the `require-sasl` constraint if needed. + +## Requirements + +This will work with python3.6 and above. + +It is recommended to work within a virtual environment. + +1. `mkdir ircwebreg && cd ircwebreg` +2. Clone this repository. +3. `python3 -m venv venv` +4. `source venv/bin/activate` +5. `pip install -r requirements.txt` + +## Installation and Setup + +Todo! + +### Note + +Only works with setups not requiring verification at this moment.