README.md

gettor-bot

A Signal chatbot to broadcast Tor bridges in countries where Tor relays are blocked/monitored

🥇 Ranked 1st at the DemHack 4 hackathon 🥇

Installation

1. Install signald
2. Start the signald daemon
3. Register or link a phone number to signald
4. Clone this repo, setup the python virtual environment, install deps, and setup the database

   git clone git@github.com:ninofiliu/gettor-bot
   cd gettor-bot
   python -m venv .env
   source .env/bin/activate
   pip install -r requirements.txt
   python setup_db.py

If you encounter

ImportError: cannot import name 'Bot' from 'semaphore'

while installing requirements, build semaphore manually instead

cd path/to/cloned/semaphore
pip install wheel
make build
make install
cd path/to/cloned/gettor-bot
pip install -r requirements.txt

Getting started

Inside the virtual env, run the main script with the phone number you're using with signald

python ./main.py +330123456789

If you encounter permission issues while doing this, add yourself to the signald group and restart your computer:

usermod -a -G signald $(whoami)