This repository contains multiple self-contained Telegram bots, each organized in its own folder with its own dependencies and utilities.
Each bot includes:
- its own
requirements.txt - its own code and utilities
- no shared dependencies
- isolated environment support
This repo acts as a monorepo, but each bot behaves like an independent project.
py-telegram-bots/
├── bot_a/
│ ├── main.py
│ ├── requirements.txt
│ ├── handlers/
│ └── utils/
├── bot_b/
│ ├── main.py
│ ├── requirements.txt
│ └── utils/
└── bot_c/
├── main.py
├── requirements.txt
└── utils/Each folder represents one standalone bot.
If you only want one specific bot, you do NOT need to clone the whole repository.
Use Git sparse checkout to download only the folder you want:
git clone --filter=blob:none --sparse https://github.com/Poxygen0/py-telegram-bots.git
cd py-telegram-bots
git sparse-checkout set bot_name_hereReplace bot_name_here with the name of the bot folder, for example:
bot_a
bot_b
bot_c✔ This will download only that folder, not the entire repo.
✔ Other bot folders will not be downloaded.
After cloning the bot folder you want:
cd bot_name_here
pip install -r requirements.txt
python main.py- Python 3.8+
- A Telegram Bot Token (via @BotFather)
- Some bots may require your
API ID&API HASHfrom telegram - Bot-specific Python packages listed in each bot’s
requirements.txt
To add a new bot:
- Create a new folder with the bot’s name.
- Add bot code (
main.pyrecommended). - Add a
requirements.txt. - Keep utilities inside that bot’s folder.
- Commit and push.
Example:
py-telegram-bots/
└── new_bot/
├── main.py
├── requirements.txt
└── utils/- Fork the repository
- Create a branch
- Add or update bots
- Submit a pull request
MIT License. Do whatever you want with the code.