Telegram Personal Assistant
Multimodal Telegram assistant that processes text, images, voice, video, and documents. Searches the web, saves notes and knowledge, and schedules follow-up reminders with persistent sessions.
connic init my-project --templates=telegram-personal-assistantOverview
A multimodal personal assistant living inside Telegram that handles text, images, voice memos, audio, video, and documents. Middleware injects the current UTC time into each message for schedule calculations and routes replies back via chat ID. Persistent sessions keyed by chat ID maintain conversation history across messages. The agent searches the web for real-time information, reads full pages, saves and retrieves quick notes via the database, stores longer-form knowledge for semantic retrieval, and schedules follow-up reminders using trigger_agent_at with relative delays up to 7 days. Replies are formatted with Telegram HTML tags and sent via the outbound connector.
Use cases
Personal assistant with reminders
A chatbot that remembers your preferences, saves notes, answers questions with web search, and schedules follow-up reminders up to 7 days ahead.
Team knowledge bot
Deploy in a group chat to collect and recall team knowledge, meeting notes, and reference material across conversations.
Research companion
Search the web, read full pages, store findings in the knowledge base, and retrieve them later with natural language queries.
Architecture
Scaffolded project structure
Running connic init my-project --templates=telegram-personal-assistant creates this file tree.
telegram-personal-assistant/
agents/
telegram-assistant.yaml
tools/
assistant_tools.py
middleware/
telegram-assistant.py
requirements.txt
README.mdGet started
Install the template, create a Connic project, and deploy. Choose Git (automatic on push) or CLI (works with any provider).
Prerequisites
- Python 3.10+
- A Connic account (create a project first)
- API key for your LLM provider (e.g. Gemini, OpenAI) to add in project variables
Install and scaffold
Install the SDK and create a project from this template.
pip install connic-composer-sdkconnic init my-project --templates=telegram-personal-assistantThen cd my-project
Deploy
Pick your deployment method. Git auto-deploys on push; CLI works with GitLab, Bitbucket, or no Git.
Git integration
- In Connic: Project Settings → Git Repository, connect your GitHub repo
- Settings → Environments: map branch (e.g.
main) to Production - Push your scaffolded project to that repo
git add .
git commit -m "Add Telegram Personal Assistant template"
git push origin mainCLI deploy
- In Connic: Project Settings → CLI, create an API key and copy project ID
- Run
connic loginin your project folder connic testto try with hot-reload, orconnic deployfor production
connic login
connic test # Ephemeral dev env with hot-reload
connic deploy # Deploy to productionConnect and configure
Create a Telegram bot via @BotFather, then add a Telegram inbound connector and a Telegram outbound connector with the bot token. The webhook is registered automatically. Add your LLM provider API key in Project Settings → LLM Provider API Keys.
Template source
Browse the full template, contribute improvements, or fork for your own use.
connic-org/connic-awesome-agents/tree/main/telegram-personal-assistantExplore other templates
View allStripe Dunning
Automated Stripe payment recovery with multi-stage personalized dunning emails. Tracks customer history and escalates from friendly reminders to pause notices.
PostgreSQL Change Notifier
Monitor PostgreSQL changes via LISTEN/NOTIFY, classify events by impact, and route notifications to the right team. Stores high-impact changes for auditing.
S3 Document Pipeline
Auto-process documents uploaded to S3 with text extraction, classification, and routing. Handles PDFs, images, and text files with retries.
Compliance Auditor
Scheduled compliance scanning combining web search for regulatory updates, MCP docs, and knowledge base history. Produces scored summaries.