How 6felix9/telegram-gpt works
Telegram GPT Bot listens to chat messages, applies access and activation rules, and routes requests through an agent that can answer from conversation context, images, and web tools. Passive text and voice history, image descriptions, rolling summaries, admin settings, and natural-language schedules are distinct capabilities. The graph shows documented and indexed calls; less-visible scheduler, provider, and transcription wiring is omitted where evidence is insufficient.
Main entry points: agent.py Agent orchestration · message_handlers.py Message intake · __init__.py Database facade · scheduler.py Schedule runner
Components 25
Telegram interface
- Telegram bot runtime
bot.py - Message intake
handlers/message_handlers.py - Request processor
handlers/request_processor.py - Admin commands
handlers/command_handlers.py - Access checks
handlers/authorization.py
Agent and context
- Agent orchestration
agent.py - Prompt construction
prompt_builder.py - Model selection
model_registry.py - Context trimming
token_budget.py - Rolling summaries
conversation_summary.py
Chat capabilities
- Web tools
tools.py - Image handling
image_store.py - Voice transcription
transcription.py - Schedule runner
scheduler.py - Schedule tools
scheduling.py
Persistence
- Database facade
database/__init__.py - Message history
database/message_repository.py - Schedule records
database/schedule_repository.py - Model and access settings
database/settings_repository.py - PostgreSQL connections
database/db_connection.py
Other components
- Telegram users
- Telegram
- PostgreSQL / Neon
- Model providers
- Web search services
Connections 33
- Telegram users → Telegram: sends messages
README.md - Telegram → Telegram bot runtime: delivers updates
bot.py - Telegram bot runtime → Message intake: registers handlers
bot.py - Telegram bot runtime → Schedule runner: starts runner
bot.py - Message intake → Access checks: checks access
handlers/message_handlers.py - Message intake → Request processor: hands off requests
handlers/message_handlers.py - Message intake → Database facade: stores passive messages
handlers/message_handlers.py - Message intake → Prompt construction: builds chat context
handlers/message_handlers.py - Message intake → Agent orchestration: persists images
handlers/message_handlers.py - Message intake → Voice transcription: transcribes voice
handlers/message_handlers.py - Request processor → Agent orchestration: runs requests
handlers/request_processor.py - Admin commands → Access checks: gates admin actions
handlers/command_handlers.py - Admin commands → Agent orchestration: clears or switches agent
handlers/command_handlers.py - Admin commands → Database facade: updates settings
handlers/command_handlers.py - Agent orchestration → Prompt construction: builds system prompt
agent.py - Agent orchestration → Context trimming: trims context
agent.py - Agent orchestration → Rolling summaries: compacts history
agent.py - Agent orchestration → Web tools: binds tools
agent.py - Agent orchestration → Model selection: resolves models
agent.py - Agent orchestration → Model providers: requests completions
- Web tools → Web search services: searches web
- Schedule runner → Agent orchestration: runs scheduled prompts
scheduler.py - Schedule runner → Database facade: loads schedules
- Schedule runner → Telegram: posts results
- Schedule tools → Database facade: creates schedules
scheduling.py - Message intake → Database facade: looks up replied images
handlers/message_handlers.py - Database facade → Message history: delegates history
database/__init__.py - Database facade → Schedule records: delegates schedules
database/__init__.py - Database facade → Model and access settings: delegates settings
database/__init__.py - Message history → PostgreSQL connections: queries through
database/message_repository.py - Schedule records → PostgreSQL connections: queries through
database/schedule_repository.py - Model and access settings → PostgreSQL connections: queries through
database/settings_repository.py - PostgreSQL connections → PostgreSQL / Neon: opens pooled connections
database/db_connection.py