Eva

Telegram bot that checks users who sent join requests to private groups and channels using captcha.
Send /feedback command to @storoxbot to get support.

Translations

The native language of author is Russian. So I will be grateful if you help me correct inaccuracies in the translation or even add your language ​​to the bot. Thank you ✨

Installation

Warning: you must have installed at least 3.10 python version!

1. Clone this repo:
   git clone https://github.com/utkasoftware/eva-bot && cd eva-bot

2. Install postgresql and create database for Eva. Installation guide

3. Rename mv {example.,}config.ini config file and fill it in. You need bot token from @BotFather and API ID & HASH from Telegram

4. Install requirements pip install -r requirements.txt

5. Run Eva:
   python -m eva

For debugging and viewing the methods call log, you can use the --dev parameter

Contributing

Please read before contributing.

PRs

It is advisable to use your modified clones instead of PRs. That will be better for everyone.

If you still want to send a pull request, then read the following:

Always test your changes.

Do not submit something without at least running the module.

Do not make large changes before discussing them first.

We want to know what exactly you are going to make to give you an advice and make sure you are not wasting your time on it.

Do not make formatting PRs.

We know that our code might be not clean enough, but we don't want to merge, view or get notified about 1-line PR which fixes trailing whitelines. Please don't waste everyone's time with pointless changes.

We use this instead of self

Do not ask why, it's a too long story.

todo

See issues/todo-list