create-tg-bot 0.1.3

A modular, CLI-first Python boilerplate for building Telegram bots. Fast setup, clean architecture, and open-source ready.

create-tg-bot

📖 This README is also available in 🇷🇺 Russian

create-tg-bot is a CLI tool for rapidly creating clean-architecture Telegram bots using Python.

---

🚀 Features

• Quickly scaffold a new project structure
• SQLite and PostgreSQL support
• Environment variable and .env management
• Generates Dockerfile and GitHub Actions workflows
• Automatic database migrations (Alembic)
• Optional development and production bot tokens
• Ready for PyPI publishing
• Includes testing with pytest

---

📦 Installation

pip install create-tg-bot

---

🛠️ Usage

create-tg-bot <project_name>

Example

create-tg-bot my_bot_project

This creates a fully-structured bot project and initializes it with environment setup, dependency installation, migrations, and Git repository initialization.

---

📁 Project Structure

project/
├── .env
├── alembic.ini
├── config.py
├── main.py
├── models/
├── services/
├── crud/
├── migrations/
├── templates/
├── requirements.txt
└── .github/workflows/

---

🧪 Development Notes

• Uses setuptools_scm for automatic versioning
• Templates live in create_tg_bot/templates
• CLI interface powered by Click

---

📄 License

This project is licensed under the MIT License.

---

👤 Author

Emil Astanov