✨Dvurechensky✨

• Telegram Bot Template
  • Structure
    • ✅ Pros:
    • ⚠️ Cons/Notes:
  • Documentation
  • Features
    • Prerequisites
    • Getting Credentials
      • Bot Token
      • API Credentials
  • Usage
  • Logging

bot/
 ├─ config/
 ├─ core/
 ├─ services/
 ├─ utils/
 ├─ main.py
 └─ __init__.py

• core/ — core layer: DB managers, services, tests. Everything responsible for logic and infrastructure.
• services/ — separate layer for specific functionality: callbacks, commands, keyboards, states, API. Each service is isolated and easily extendable.
• utils/ — helper functions/utilities.
• config/ — bot configuration (tokens, settings). Separated from logic.
• main.py — entry point.

• Clean layered architecture.
• Easy to scale and add new commands/services.
• Good separation of logic and services.
• Suitable for team development — no one breaks the core while working on keyboards or callbacks.

• If the project grows significantly, services/ may become too large and harder to navigate. Could be improved later with submodules or package namespaces.

• Full changelog
• Tasks
• Full Linux machine cleanup after usage
• Installation
• Proxy server setup
• SMTP - port availability check
• CREDENTIALS
• Systemd info

• ✨ Feature 1
• 👹 Feature 2
• 🔐 Feature 3
• 💀 Feature 4
• 💬 Feature 5
• ☔ Feature 6
• 🛡️ Feature 7
• 💾 Feature 8
• 📋 Feature 9
• 🌁 Feature 10

• Python 3.8+
• Telegram account
• Bot token from @BotFather
• API credentials from my.telegram.org

• Message @BotFather in Telegram
• Send /newbot
• Follow the instructions to create your bot
• Copy the token into your .env file
• To get CHAT_ID — go to https://api.telegram.org/bot<YOUR_TOKEN_BOT>/getUpdates, first send /start to your bot and send 1 message in the chat where the bot is added as an administrator
• API_HASH — obtained from your Telegram developer account at my.telegram.org

BOT_TOKEN=YOUR_BOT_TOKEN
API_ID=YOUR_API_ID
API_HASH=YOUR_API_HASH

• Visit https://my.telegram.org
• Log in using your phone number
• Go to API Development tools
• Select Create new application
• Copy API ID, BOT TOKEN, and API Hash into your .env file
• Specify allowed Telegram usernames in ADMIN_USERNAMES who will use your bot and become its administrators

• Start the bot: /start
• View help: /help
• List your services: 🌀 My Services

All actions are logged in:

• app.log (file)
• Console output

✨Dvurechensky✨