Telegram Bot Template

✨ Features

Built with Copier, this template lets you toggle features during setup - choose what you need and generate files instantly! Ready for Docker 🐳 and Coolify ☁️ deployment.

Core Infrastructure

• Docker Compose 🐳 Launch bot + services with one command
• Python 3.9–3.13 🐍 Choose your Python version easily
• uv 🚀 Fast dependency management powered by Rust
• Poetry 📦 Manage dependencies safely with virtual environments
• pip 📜 Classic Python package installer

Telegram Bot Framework

• Aiogram ⚡ Modern async bot framework with state management
• Aiogram Dialog 🖼️ Create menus and interactive interfaces
• Redis ❤️ Keep bot data safe between restarts

Database & ORM

• PostgreSQL 🐘 Powerful database for complex projects
• SQLAlchemy 🛠️ Work with databases using Python code
• Alembic ⏳ Track and apply database changes easily

Middlewares

• Dependency Injection 💉 Share tools/data across bot handlers
• Throttling 🛑 Stop spam with automatic speed limits
• Database Sessions ♻️ Auto-manage database connections
• Loguru 📜 Simple logging with colors and fun

Tooling

• Pydantic Settings ✅ Safe config management with type checking
• Dynaconf ⚙️ Configs for dev/test/prod environments
• Ruff 🪶 Super-fast code linting and cleanup
• Justfile 🪄 Short commands for complex tasks
• Cache Decorator ⚡ Speed up functions with Redis caching

Roadmap 🗺️

Help shape the future! Planned improvements:

• Bot Internationalization 🌐 Support multiple languages for global audiences
• Prompts Internationalization 📋 Translate copier prompts
• Dependabot 🤖 Add dependencies auto-update to generated project for security and freshness
• Testing ✅ Add testing framework
• Flake8 / wemake 🧹 Alternative strict linting for code quality fans

Got ideas? Star ⭐ the repo or open an issue to collaborate! 🚀

⭐ Star History

👷 Contributing

First off, thanks for taking the time to contribute! Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork this repository
2. Create a branch
3. Commit your changes
4. Push your commits to the branch
5. Submit a pull request

📝 License

Distributed under the Apache License 2.0. See LICENSE for more information.