Powered by Claude Code

AI digest bot
for Telegram

Telebrief collects messages from your Telegram channels, generates AI-powered summaries grouped by channel or topic, and delivers polished daily digests directly to your account.

Get started → How it works
$0 free with Ollama
2 digest modes
3 AI providers
Any output language

workflow

How Telebrief Works

Three automated phases take your channels from raw messages to a polished digest

Collect Messages

Telebrief connects to your Telegram channels via Telethon and pulls all messages from the last 24 hours, including content from private channels you're a member of.

telethon user API private channels 24h window

AI Summarization & Classification

Your chosen AI provider analyzes each channel's content, produces concise summaries, and can classify messages into topic groups like News, Events, or Sport — all in your configured output language.

OpenAI Anthropic Ollama multi-language topic classification

Format & Deliver

A beautifully formatted Markdown digest with clickable channel links and inline navigation buttons is sent directly to your Telegram via bot, on your schedule or on demand.

markdown channel links scheduled on-demand

output preview

What You Receive

A polished daily digest formatted for Telegram. Toggle between channel and topic grouping below.

Telebrief Bot 12:00 PM

📊 Daily Digest — May 2, 2026

🎯 Overview

AI tooling dominated today: Anthropic shipped Claude Opus 4.7, crypto markets rallied on ETF approvals, EU finalized AI Act amendments.

💻 TechCrunch

  • 🚀 Claude Opus 4.7 released — 1M context window, faster output
  • 🤖 OpenAI GPT-6 leak — multimodal benchmarks surface early
  • 📱 Apple Vision Pro 2 — rumored Q3 launch with lighter frame

💰 Crypto News

  • 📈 Bitcoin hits $89K — spot ETF inflows reach record high
  • ⚠️ SEC settles with Ripple — final ruling closes 6-year case
  • 🔐 Ethereum Pectra upgrade — mainnet activation confirmed

📈 20 channels · 1,847 messages processed

📊 Daily Digest — May 2, 2026

🎯 Overview

AI tooling dominated today: Anthropic shipped Claude Opus 4.7, crypto markets rallied on ETF approvals, EU finalized AI Act amendments.

📰 News

  • 🚀 Claude Opus 4.7 released — 1M context window, faster output
  • 📈 Bitcoin hits $89K — spot ETF inflows reach record high
  • ⚖️ EU finalizes AI Act — compliance deadlines set for 2027

🎉 Events

  • 🎤 PyCon US 2026 — keynote lineup announced
  • 🛠️ KubeCon EU — early-bird tickets close Friday

⚽ Sport

  • 🏆 Champions League — semi-final draws set
  • 🎾 Madrid Open — Alcaraz advances to quarters

📈 20 channels · 1,847 messages processed

Both modes configurable via digest_mode in config.yaml.

bot interface

Available Commands

Control Telebrief directly from Telegram with built-in bot commands

/start — Show welcome message and available commands
/digest — Generate digest using configured mode (channel or topic)
/status — View configuration and next scheduled run
/cleanup — Delete old digest messages from chat
/help — Show all commands and usage guide

capabilities

Powerful Features

Everything you need to stay informed without information overload

modes

Digest Modes

Group your digest by channel (default) or by AI-detected topics. Define custom topic groups like News, Events, or Sport — the AI classifies each message automatically.

multi-provider

AI-Powered Summaries

Choose from OpenAI, Anthropic, or local Ollama to generate concise intelligent summaries. Switch providers with a single config change.

i18n

Multi-Language Support

Collect messages in any language — English, Russian, Ukrainian, Chinese, and more. Output language is fully configurable.

automation

Scheduled Delivery

Set a preferred delivery time and receive daily digests automatically. On-demand generation available via bot commands.

access

Private Channels

Full support for private Telegram channels using Telethon user API. No restrictions on channel visibility or membership type.

granular control

Per-Channel Config

Override lookback window or append AI instructions per channel. Tighter window for high-volume feeds, broader for weekly newsletters, custom prompt focus per source.

delivery

Smart Message Splitting

Digests over Telegram's 4096-character limit auto-split into sequential messages — never truncated, never lost.

devops

Docker Compose Ready

One-command deploy with docker-compose. Volumes pre-wired for persistent storage. Production-ready out of the box.

cost

Ultra Affordable

Run completely free with local Ollama, or use cloud AI for ~$0.30 per month. Self-hosted, no subscription fees, no vendor lock-in.

registry

Pre-built Docker Images

Pull from GitHub Container Registry. Tagged latest, X.Y, X.Y.Z. Zero build step — pull and run.

maintenance

Auto-Cleanup

Old digest messages auto-removed from chat on a schedule. No clutter buildup, no manual housekeeping.

open source

MIT Licensed

Fully open source. Inspect the code, fork it, extend it. No black boxes. Your data stays on your own infrastructure.

extend telebrief

Storage & Extensibility

Persist every collected message and bend Telebrief to your workflow — all via config, no core changes required.

Persistent Storage

Save every collected message to a database for historical access, search, or external LLM workflows. Off by default — opt in when you need it.

Zero setup. File-based. Persists across Docker restarts via mounted volume.

storage:
  enabled: true
  backend: sqlite
  path: data/messages.db
file-based zero deps single host

Multi-host deployments. Concurrent reads. asyncpg already bundled.

storage:
  enabled: true
  backend: postgres
  url: "postgresql://user:pass@host:5432/dbname"
multi-host concurrent reads asyncpg bundled
8 columns per row
1 shared schema across backends
query_messages() read API for external tools
Read full storage docs →

Hook Surfaces

Four extension points to bend Telebrief without touching core. Drop in custom filters, prompts, and group bindings via config — or query the storage layer from your own tooling.

hook 01

Filters

Drop noise before AI sees it. Keyword, regex, length filters built-in. Per-channel overrides supported.

MessageFilter Protocol
hook 02

Prompts

Swap base template or plug in a custom composer. Steer tone and focus per channel.

PromptComposer Protocol
hook 03

Group Binding

Bind channels to digest groups. Group-level prompt_extra stacks before channel overrides.

digest_groups[].prompt_extra
hook 04

Storage Queries

Query stored messages from your own scripts. Filter by channel, time range, limit.

await backend.query_messages(...)

One config block. All four hooks. No code changes.

settings:
  filters:
    - class_path: src.extensions.filters.KeywordFilter
      config: { include: ["job", "hiring"] }
  digest_groups:
    - name: "Jobs"
      prompt_extra: "Extract role, company, link."

prompts:
  base_template: src/prompts/base_summary.txt

channels:
  - id: "@techleads_jobs"
    name: "Tech Jobs"
    group: Jobs
    prompt_extra: "Senior+ only."
Full extensibility guide →

Ready to get started?

Deploy Telebrief in minutes and start receiving intelligent daily digests

View on GitHub Quick start guide →