# ircBridgeV3 
## WORK IN PROGRESS

### IRC bridge to site chatbox
#### Version 3

**This app is built to join and listen on the selected IRC channel handling cross communications between the channel and site chatbox.**

V3 - Breaks all the parts into modular scripts to help with debugging and future proofing. The main solution it provides is running a single bot listener but four gunicorn workers for multi-threaded handling of API calls through the use of a Redis publishing system. This allows for a much more active chat as the site grows. 

**Includes:**
- User verification and validation
- Staff channel management
- Cross application communications

**Depends:**
- Redis server (This set up uses an alternate port and password set in redis.conf)

**To install:**
>[!NOTE]
>These instructions are set up to install the app into it's own virtual environment
- Clone the project
- Move the service files to `/etc/systemd/system/<filename>.service`
- Set appropriate settings in config.yml and gunicorn_config.py
- Set up python venv in dir
  - `$ cd <directory>`
  - `$ python -m venv venv`
  - `$ source venv/bin/activate`
  - `$ pip install -r requirements.txt`
  - `$ deactivate`
- Edit the service files to reflect proper paths
- Enable and start the service
  - `$ sudo systemctl enable ircbridge.service ircbridgebot.service`
  - `$ sudo systemctl start ircbridge.service ircbridgebot.service`
  - Use `journalctl -u ircbridge -f` to monitor