Skip to main content

Authentication gateway bot for the Unimore Informatica Telegram group

Project description

Thor Bot

Gatekeeper bot for the Unimore Informatica unofficial Telegram group network

[ Website | PyPI ]

NOTE: This bot will be replaced soon with its rewrite, Loki Bot. Development on this version has ceased.

The OpenGraph image of this page, with the project logo in the foreground and a blurred version of the Thor website in the background.


If added as an administrator to a Telegram group, this bot will instantly kick any joining member who hasn't passed verification.

Verification is performed by:

  1. visiting the bot's homepage
  2. pressing the "Verify" button
  3. logging in via Google with a account
  4. following the deep link to Telegram
  5. pressing the "Start" button in the bot chat
  6. answering the few questions the bot asks about the user's configuration

Additionally, verified users of the bot may choose to make their real name available for lookups via a bot command.

Verified members joining a monitored group which made their real name available are announced by the bot in the group.

Installation via PyPI

This method is recommended only for development purposes.

  1. Create a new venv and enter it:

    $ python -m venv venv
    $ source venv/bin/activate
  2. Download through PyPI:

    $ pip install thorunimore
  3. Install the packages required to connect to the desired SQL database:

    • For PostgreSQL:
      $ pip install psycopg2-binary
  4. Set the following environment variables:

    • The URI of the SQL database you want to use

      export SQLALCHEMY_DATABASE_URI="postgresql://steffo@/thor_dev"
    • A Google OAuth 2.0 client id and client secret

      export GOOGLE_CLIENT_ID=""
      export GOOGLE_CLIENT_SECRET="aaaaaaaaaaaaaaaaaaaaaaaa"
    • A random string of characters used to sign Telegram data

      export SECRET_KEY="Questo è proprio un bel test."
    • api_id and api_hash for a Telegram application

      export TELEGRAM_API_ID="1234567"
      export TELEGRAM_API_HASH="abcdefabcdefabcdefabcdefabcdefab"
    • The username and token of the Telegram bot

      export TELEGRAM_BOT_USERNAME="thorunimorebot"
    • The desired logging level and format

      export LOG_LEVEL="DEBUG"
      export LOG_FORMAT="{asctime}\t| {name}\t| {message}"
    • The url at which web is hosted

      export BASE_URL=""
    • The url to join the Telegram group

      export GROUP_URL=""
  5. Run both of the project's processes simultaneously:

    $ python -m thorunimore.telegram &
    $ python -m thorunimore.web &

Configuring as a SystemD unit

This section assumes the project's files are located in /opt/thorunimore.

  1. Install gunicorn in the previously created venv:

    $ pip install gunicorn
  2. Create the bot-thorunimore systemd unit by creating the /etc/systemd/system/bot-thorunimore.service file:

    Description=A moderator bot for the Unimore Informatica group postgresql.service
    ExecStart=/opt/thorunimore/venv/bin/python -OO -m thorunimore.telegram
  3. Create the web-thorunimore systemd unit by creating the /etc/systemd/system/web-thorunimore.service file:

    Description=Thorunimore Gunicorn Server postgresql.service
    ExecStart=/opt/thorunimore/venv/bin/gunicorn -b thorunimore.web.__main__:reverse_proxy_app
  4. Create the /etc/systemd/system/bot-thorunimore.d/override.conf and /etc/systemd/system/web-thorunimore.d/override.conf containing the previously configured variables, so that they are passed to the SystemD unit:

    Environment="SECRET_KEY=Questo è proprio un bel server."
    Environment="LOG_FORMAT={asctime}\t| {name}\t| {message}"
  5. Start (and optionally enable) both services:

    # systemctl start "bot-thorunimore" "web-thorunimore"
    # systemctl enable "bot-thorunimore" "web-thorunimore"
  6. Reverse-proxy the web service with a web server such as Apache HTTPd:

    <VirtualHost *:80>
    ServerName ""
    Redirect permanent "/" ""
    <VirtualHost *:443>
    ServerName ""
    ProxyPass "/" ""
    ProxyPassReverse "/" ""
    RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
    SSLEngine on
    SSLCertificateFile "/root/*"
    SSLCertificateKeyFile "/root/**"
    # a2ensite rp-thorunimore

Installation via Docker

This method is recommended for production deployments.

  • Two Docker images are provided, thorunimore-web and thorunimore-telegram, which only require configuration of the environment and setup of a reverse proxy.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

thorunimore-1.2.13.tar.gz (32.5 kB view hashes)

Uploaded source

Built Distribution

thorunimore-1.2.13-py3-none-any.whl (34.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page