Production-Ready Bots
in 10 Minutes

# 1. Load config and environment variables
from os import getenv
from dotenv import load_dotenv
load_dotenv()
API_TOKEN = getenv("TELEGRAM_TOKEN")
DB_URL = getenv("DATABASE_URL")

# 2. Initialize AIOGram, State Machine, Redis, PostgreSQL
import logging
from aiogram import Bot, Dispatcher
from aiogram.fsm.storage.redis import RedisStorage
from sqlalchemy.ext.asyncio import create_async_engine
from sqlalchemy.orm import sessionmaker

# ... 100+ lines for connection setup and middleware

# 3. Middleware for session and transaction management
class DbSessionMiddleware:
    # ... 50 lines of code
# ...

# 4. /start command handler
async def cmd_start(message, session):
    # ... 20 lines of logic
    await message.answer("Hello!")

# 5. Main startup loop
async def main():
    # ... 50 lines for deploy and process management
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())
            

# 1. Define routes and state (FastAPI-like)
from botscale import Router, settings
from botscale.db import Session
from botscale.types import Message

router = Router()

# 2. Handler using DI for Session
@router.message("/start")
async def start_handler(message: Message, db: Session):
    # db - ready and active SQLModel session
    user = db.get_user(message.from_user.id)
    if not user:
        db.create_user("new")

    await message.answer("Hello, this is BotScale!")

# 3. Settings
settings.telegram_token = "env(TELEGRAM_TOKEN)"
settings.db_url = "env(DATABASE_URL)"

# 4. Main entry point (framework handles the rest)
from botscale import App
app = App(routers=[router])

# Run: botscale run