How timmy-web/poe-telegram-chatbot works
Project type and purpose
• This is a Python-based integration service (a Telegram chatbot) that leverages the Poe API to mediate AI-powered conversations (GPT-4, Claude-3-Opus).
• It is not a traditional multi-tier web app; it’s a stateless bot service that receives messages via the Telegram Bot API, forwards them to Poe, and returns AI responses.
File structure
• Top level:
• .github/ – CI/CD workflows (build & push Docker images).
• Dockerfile – image definition for the bot service.
• docker-compose.yml – local or multi-container deployment orchestration.
• bot.py – the single Python entry point containing Telegram & Poe API integration and the dialogue management logic.
• requirements.txt – Python dependencies.
• README.md – project overview, setup, usage.
• No database or persistent layer; all context is held in memory in bot.py.
• Configuration driven entirely by environment variables (TELEGRAM_BOT_TOKEN, POE_API_KEY).
README for additional insights
• Supports switching AI models at runtime (/gpt4, /claude3).
• Maintains session context for “continuous dialogue.”
• Provides both local (direct Python) and containerized deployment.
Final recommendation
• Be exhaustive: place every logical piece (message flow, config, container boundary, CI/CD).
• Avoid over-simplification: even though it’s a small project, separate the orchestration logic, APIs, and deployment layers.