EduuRobot Telegram bot source code.
Find a file
Amano's Weblate (bot) 269a886d9b
chore: new translations update (#403)
Co-authored-by: Alisson Lauffer <alissonvitortc@gmail.com>
2025-08-25 00:00:15 -03:00
.github build(deps): bump actions/setup-python from 4 to 5 2024-06-01 15:33:33 -03:00
eduu chore: update translations and fix minor text issues 2025-07-27 02:27:53 -03:00
locales chore: new translations update (#403) 2025-08-25 00:00:15 -03:00
.deepsource.toml Enable mypy typechecker 2020-10-11 08:49:58 -03:00
.editorconfig weather: inline mode 2023-05-14 02:47:04 -03:00
.gitignore chore: migrate project to pyproject.toml 2023-01-10 23:27:51 -03:00
CODEOWNERS chore: update code owners list 2023-07-24 19:25:21 -03:00
config.py.example treewide: drop version in favor of revision number and move eduu.db and config.py to root 2023-01-10 22:21:47 -03:00
LICENSE treewide: bump minimum Python version to 3.9 and update copyright year 2024-06-01 14:27:44 -03:00
pyproject.toml build(deps): update dependencies to latest versions 2025-07-26 23:35:21 -03:00
README.rst update readme to reflect Weblate migration 2024-06-15 17:14:33 -03:00

EduuRobot

License Codacy Weblate Black Telegram Channel Telegram Chat

A multipurpose Telegram Bot made with Hydrogram and asynchronous programming.

Requirements

  • Python 3.10+
  • An Unix-like operating system (Windows support isn't tested. In case you find any issues inside Windows, please file an issue)

Setup

  1. Create a virtualenv (This step is optional, but highly recommended to avoid dependency conflicts)
    • python3 -m venv .venv (You don't need to run it again)
    • . .venv/bin/activate (You must run this every time you open the project in a new shell)
  2. Install the required modules with pip3 install -Ue ..
  3. Go to https://my.telegram.org/apps and create a new app.
  4. Create a new config.py file from the config.py.example file (cp config.py.example config.py).
  5. Place your token, IDs and api keys to your config.py file.

Running

  • To run the bot you just need to run python3 -m eduu. In case you installed from a virtualenv, run . .venv/bin/activate before this.
  • Running it on screen or tmux is highly recommended if you want to keep the bot running on a server.

Note

If you find any bugs/issues with the bot you have three options:

  • Create a new issue in our GitHub describing the issue.
  • Send the /bug command to bot's chat describing the issue.
  • If you know how to fix the issue, fork our repo and open up a pull request.

Translations

Translations should be done in our Weblate project, as Weblate checks for grammar issues, provides improved context about the string being translated and so on, thus possibly providing better quality translations. But you can also submit a pull request if you prefer translating that way.

Special thanks

  • @Halokv: Arabic translation
  • @SGANoud: Dutch translation
  • @iiiiii1wepfj: Hebrew translation
  • @HafitzSetya: Indonesian translation
  • @Pato05: Italian translation
  • @Quiec: Russian and Turkish translations
  • And many other people I couldn't list here.

© 2024 - Amano LLC™