Skip to main content

A utility for quickly generating projects on aiogram 3

Project description

๐Ÿš€ TelegramBotCLI

A lightweight command-line utility for quickly generating professional project structures for Aiogram 3 bots. Stop wasting time on boilerplate and start coding your logic instantly.

โœจ Features

  • Instant Structure: Creates folders for handlers, database (SQLModel), and keyboards in one command.
  • Smart OS Detection: Automatically suggests the correct run command (python vs python3) based on your system.
  • Ready-to-Go Templates: Includes pre-configured .env, .gitignore, and basic bot logic with commands.
  • Built-in Keyboards: Comes with examples for both standard and inline keyboards.

๐Ÿ“ฆ Installation

Install the tool directly from PyPI:

pip install telegrambotcli

๐ŸŒžHow to start

Write in terminal telegrambotcli


## ๐Ÿ“‚ Generated Project Structure

When you run the tool, it creates a clean, modular architecture:

```text
your_project/
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ handlers/
โ”‚   โ”‚   โ”œโ”€โ”€ database/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ database.py   # SQLModel engine & session setup
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ __init__.py
โ”‚   โ”‚   โ”œโ”€โ”€ keyboards/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ builders.py   # Reply & Inline keyboard templates
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ __init__.py
โ”‚   โ”‚   โ”œโ”€โ”€ main.py           # Command handlers (/start, /keyboard, etc.)
โ”‚   โ”‚   โ””โ”€โ”€ __init__.py
โ”‚   โ””โ”€โ”€ __init__.py
โ”œโ”€โ”€ bot.py                    # Main entry point (Dispatcher & Polling)
โ”œโ”€โ”€ .env                      # Environment variables (Tokens, DB URLs)
โ””โ”€โ”€ .gitignore                # Pre-configured for Python & VSCode

๐Ÿง‘โ€๐Ÿ’ปGitHub repository

Sourse code

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

telegrambotcli-0.4.2.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

telegrambotcli-0.4.2-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file telegrambotcli-0.4.2.tar.gz.

File metadata

  • Download URL: telegrambotcli-0.4.2.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for telegrambotcli-0.4.2.tar.gz
Algorithm Hash digest
SHA256 65ce481054c589a23460c9910190e92d011b6a41bbfa29f26454a03e0633135f
MD5 771fc99d8829a0e26d6d11f754091de2
BLAKE2b-256 2d96eb7929bbf39aad0d7fa244b3b2dac7a4b3ceff48dd137108879a3ee1c354

See more details on using hashes here.

File details

Details for the file telegrambotcli-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: telegrambotcli-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for telegrambotcli-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bcdf4ea63f828fd70bef9f6044bf4cc405104be7834e8bb03e448ae42db66c0a
MD5 0858db64462a6cf95b92d0027e73f0b7
BLAKE2b-256 106e224910e60d27062a3bd1c569769d8bdca6edcf02d3d2d3c1b6d54f236109

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page