Digest Ai Agent

newsbrief

[](https://github.com/newsbrief/newsbrief/actions/workflows/tests.yml) [](https://badge.fury.io/py/newsbrief) [](https://ghcr.io/newsbrief/newsbrief) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)

Self-hosted AI-powered news digest for Telegram. From `git clone` to first digest in 5 minutes.

Features

• 🆓 Free by default — works on Groq free tier ($0/month, no credit card)
• 🤖 8 LLM providers — Groq, Gemini, Cerebras, Mistral, OpenAI, Anthropic, DeepSeek, OpenRouter
• 📡 6 source types — RSS, Telegram, Reddit, HackerNews, YouTube, Search
• 🎯 Source Discovery — describe interests, get recommended sources from a curated DB of 100+
• ⏰ Smart scheduling — set delivery time, build time auto-calculated with adaptive buffer
• 📱 Telegram UI — all settings via inline keyboard, no YAML editing required
• 🔌 Extensible — plugin system for custom sources, LLMs, delivery channels
• 🔒 Private — self-hosted, your data stays on your server, bring your own API keys

Quickstart (5 minutes)

git clone https://github.com/newsbrief/newsbrief && cd newsbrief
docker compose run --rm newsbrief setup
docker compose up -d

The setup wizard asks:

1. Telegram bot token — from @BotFather
2. Your chat_id — auto-detected when you first message the bot
3. LLM provider — press Enter for Groq (free tier, no card)
4. What are you interested in? — free text, e.g. "AI research, Rust, indie games"
5. What time? — presets 07:00–22:00 o