Self-hosted · open source · AGPL-3.0

Pour in every feed.
Filter what matters.
Brew the digest.

RSSBrew aggregates your RSS feeds, strains out what you don't want with custom filters, and uses AI to summarize and digest the rest — daily or weekly, served back to you as a normal feed.

$ docker compose up -d — self-hosted in one command, see install

How it brews

Four stages between raw feed and finished digest

Each stage is independently configurable — use just the parts you need.

01 · AGGREGATE

Combine feeds

Merge any number of original feeds — by URL or by tag — into a single processed feed. New feeds matching a tag join automatically.

02 · FILTER

Strain the noise

Match on link, title or description — contains, excludes, or regex. Group filters with AND / OR / NOT, and choose whether a match removes an entry or just skips it for AI summary.

03 · STEEP

Summarize with AI

Any OpenAI-compatible model reads each article and prepends a one-line and a longer summary. Swap in your own prompt to have it do something else entirely.

04 · DIGEST

Roll into a digest

Too much still getting through? Bundle a day's or week's entries into one AI-digested entry — delivered as a feed item and a shareable static page.

Also in the pot

Details that add up

Tag-based feeds

Group original feeds by tag and point a processed feed at the tag — matching feeds added later join without editing anything.

Nested filter groups

AND / OR / NOT between individual filters and between whole groups of them, with a case-sensitive toggle per filter.

Title translation

Translate article titles on the way through, independent of summarization.

Static digest pages

Every digest also renders as a plain, shareable HTML page — not locked inside a feed reader.

Bring your own model

Point at any OpenAI-compatible endpoint, globally or per feed, with a global AI master switch.

One Compose file

Docker Compose, an admin UI, and a database — nothing else to stand up.

Set it brewing

Running in three steps

1# grab the compose file and env template
wget https://raw.githubusercontent.com/yinan-c/rssbrew/main/docker-compose.yml
wget https://raw.githubusercontent.com/yinan-c/rssbrew/main/.env.example
 
2# set OPENAI_API_KEY, SECRET_KEY, DEPLOYMENT_URL
cp .env.example .env
 
3# start the stack
docker compose up -d

The app comes up at http://localhost:8000 with an admin UI for feeds, filters and digests. Full walkthrough in INSTALL.md.

username: admin · password: changeme
change it on first login

Want to poke around first? The public demo resets weekly — same credentials, don't store anything you'd miss.

Roadmap

What's brewing next

Closed GitHub issues

2025-09-03

Tag-based feed inclusion

Processed feeds can now include every original feed carrying a given tag, instead of listing each one by hand.

2025-09-01

Static digest pages #24

Digests render to their own shareable HTML page, not just a feed entry.

2025-08-20

Fixed filter false negatives #20

Content filters were silently letting the wrong entries through in some cases — corrected.

2025-03-06

Article title translation #17

Titles can be translated independently of AI summarization.

2024-11-18

Configurable Redis host/port #16

Redis connection settings moved to environment variables for easier self-hosting.

Open GitHub issues