AI-powered Telegram bot built with aiogram and Gemini.
- Python 3.13+
- uv
- Docker (for PostgreSQL)
- Telegram bot token (@BotFather)
- Google API key
cp env.example .env # Configure your credentials
make dev-setup # Creates venv, starts DB, runs migrations
make run # Start the botKey environment variables in .env:
| Variable | Description |
|---|---|
TELEGRAM_BOT_TOKEN |
Bot token from @BotFather |
DATABASE_URL |
PostgreSQL connection string |
GOOGLE_API_KEY |
Google AI API key |
LOGFIRE_TOKEN |
Logfire observability token |
ENVIRONMENT |
dev or prod |
See env.example for the complete list.
Run make help to see all available targets.