https://github.com/ninofiliu/gettor-bot

A Signal chatbot to broadcast Tor bridges in countries where Tor relays are blocked/monitored
https://github.com/ninofiliu/gettor-bot

chatbot privacy security signalapp tor

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/ninofiliu/gettor-bot
• Owner: ninofiliu
• License: mit
• Created: 2022-05-21T08:47:41.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-07-03T17:27:51.000Z (over 2 years ago)
• Last Synced: 2023-03-06T20:34:06.592Z (almost 2 years ago)
• Topics: chatbot, privacy, security, signalapp, tor
• Language: Python
• Homepage:
• Size: 30.3 KB
• Stars: 10
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gettor-bot

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

🥇 Ranked 1st at the [DemHack 4](https://demhack.ru/) hackathon 🥇

## Installation

1. Install [signald](https://signald.org/)

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

   ```sh

   git clone [email protected]: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](https://github.com/lwesterhof/semaphore) manually instead

```sh

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

```sh

python ./main.py +330123456789

```

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

```sh

usermod -a -G signald $(whoami)

```