Telegram Personal Assistant

Overview

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

Architecture

Main template files

Install these files with connic init my-project --templates=telegram-personal-assistant. The CLI places agent definitions in a folder named after the template under agents/.

telegram-personal-assistant/
  agents/
    telegram-assistant.yaml
  tools/
    assistant_tools.py
  middleware/
    telegram-assistant.py
  requirements.txt
  README.md

Get started

Install the template, create a Connic project, and deploy through a connected Git repository or the CLI.

1. 1

   Install and scaffold

   Install the SDK and create a project from this template.

   terminal

   Copy

   pip install connic-composer-sdk
   connic init my-project --templates=telegram-personal-assistant

   Then cd my-project

2. 2

   Deploy

   Choose a deployment method. A connected Git repository deploys on push; use the CLI for projects without a connected Git repository.

   Git integration

   1. 1

      In Connic: Project Settings → Git & Environments, connect the GitHub repository

   2. 2

      On the same page, map a branch (e.g. main) to the Production environment

   3. 3

      Push the scaffolded project to that repository

   terminal

   Copy

   git add .
   git commit -m "Add Telegram Personal Assistant template"
   git push origin main

   CLI deploy

   1. 1

      In Connic: Project Settings → API Keys & MCP Auth, create an API key and copy project ID

   2. 2

      Run connic login in the project folder

   3. 3

      Use connic dev to try with hot-reload, connic test to run suites, or connic deploy for production

   terminal

   Copy

   connic login
   connic dev     # Ephemeral dev env with hot-reload
   connic test    # Run declarative test suites
   connic deploy  # Deploy to production

3. 3

   Connect 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. Use a connic/* model, or add BYOK credentials under Project Settings → LLM Provider.

   Full connector setup guideQuickstart guideConnector docs