Recommendation before use

🔥🔥 Use PYTHON 3.10 🔥🔥

🇷 🇺 README in russian available here

Features

Feature	Supported
Multithreading	✅
Proxy binding to session	✅
User-Agent binding to session	✅
Support for pyrogram .session / telethon .session	✅
Registration in bot	✅
Auto-tasks	✅
Daily rewards	✅

Settings

Settings	Description
API_ID / API_HASH	Platform data from which to run the Telegram session (by default - android)
SLEEP_TIME	Sleep time between cycles (by default - [7200, 10800])
START_DELAY	Delay between sessions at start (by default - [5, 25])
AUTO_TASK	Auto tasks (default - True)
JOIN_CHANNELS	Auto-join for tg channels tasks (default - False)
REF_ID	Ref link for registration

Quick Start 📚

To fast install libraries and run bot - open run.bat on Windows or run.sh on Linux

Prerequisites

Before you begin, make sure you have the following installed:

Python version 3.10

Obtaining API Keys

Go to my.telegram.org and log in using your phone number.
Select "API development tools" and fill out the form to register a new application.
Record the API_ID and API_HASH provided after registering your application in the .env file.

Installation

You can download the repository by cloning it to your system and installing the necessary dependencies:

git clone https://github.com/Desamod/CatsGangBot
cd CatsGangBot

Then you can do automatic installation by typing:

Windows:

run.bat

Linux:

run.sh

Linux manual installation

python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
cp .env-example .env
nano .env  # Here you must specify your API_ID and API_HASH, the rest is taken by default
python3 main.py

You can also use arguments for quick start, for example:

~/CatsGangBot >>> python3 main.py --action (1/2)
# Or
~/CatsGangBot >>> python3 main.py -a (1/2)

# 1 - Run clicker
# 2 - Creates a session

Windows manual installation

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
copy .env-example .env
# Here you must specify your API_ID and API_HASH, the rest is taken by default
python main.py

You can also use arguments for quick start, for example:

~/CatsGangBot >>> python main.py --action (1/2)
# Or
~/CatsGangBot >>> python main.py -a (1/2)

# 1 - Run clicker
# 2 - Creates a session

Usages

When you first launch the bot, create a session for it using the 'Creates a session' command. It will create a 'sessions' folder in which all accounts will be stored, as well as a file accounts.json with configurations. If you already have sessions (pyrogram / telethon), simply place them in a folder 'sessions' and run the clicker. During the startup process you will be able to configure the use of a proxy for each session. User-Agent is created automatically for each account.

Here is an example of what accounts.json should look like:

[
  {
    "session_name": "name_example",
    "user_agent": "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.6422.165 Mobile Safari/537.36",
    "proxy": "type://user:pass:ip:port"  # "proxy": "" - if you dont use proxy
  }
]

Contacts

For support or questions, you can contact me

Desamod / CatsGangBot

readme