AI-Brief

A daily AI news digest delivered to Telegram. Scrapes Reddit, Hacker News, and developer blogs — deduplicates, scores by signal strength, and summarises with an LLM.

Setup

Requirements: Python 3.11+, uv

git clone https://github.com/your-username/AI-Brief
cd AI-Brief
uv sync

Credentials

Copy the example env file and fill in your keys:

cp .env.example .env

Variable	Required	Where to get it
TELEGRAM_BOT_TOKEN	Yes	@BotFather on Telegram
TELEGRAM_CHAT_ID	Yes	Send a message to your bot, then hit https://api.telegram.org/bot<TOKEN>/getUpdates
GROQ_API_KEY	One of these	console.groq.com — free tier works
ANTHROPIC_API_KEY	One of these	console.anthropic.com

Reddit requires no credentials — the scraper uses the public JSON API.

Run

uv run --env-file .env python -m ainews.main

Configuration

Edit config.yaml to change RSS feeds, subreddits, HN keyword filters, and scoring weights. No code changes needed.

Automate

To run daily, add a cron job:

# 8 AM UTC every day
0 8 * * * cd /path/to/AI-Brief && uv run --env-file .env python -m ainews.main

Or use the GitHub Actions workflow (see .github/workflows/) with secrets configured in your repo settings.