NewsNest
GitHub

Self-hosted · Open source · No ads

Your news. Your rules. No noise.

NewsNest brings together the RSS feeds you choose, folds the same story from different outlets into one card, and uses AI (Anthropic's Claude) to rank and summarise it by your interests. No ads, no tracking, and it runs on your own machine.

Get started View on GitHub

Why NewsNest

Keeping up with the news shouldn't be a second job.
NewsNest does the sorting, so you can just read.

  1. 01

    You're in control

    Your sources, your interests, your mute list. Nothing changes without your OK.

  2. 02

    Less bloat

    Five outlets, one story, one card. The feed ends when you've seen what matters.

  3. 03

    Relevant to you

    AI scores every story against your interests, and tells you why.

  4. 04

    No ads

    No ads, no sponsored posts, no engagement tricks. Clickbait sinks to the bottom.

  5. 05

    Private

    One SQLite file on your own server. No telemetry, no trackers.

Features

A calm feed that does the sorting for you.

01You're in control

You set the rules

Your feed does what you tell it.

Mute words you never want to see, make others always show up, and cap how many stories a noisy outlet gets each day. Your interests are a plain file you can read and edit.

  • Mutehoroscopes
  • Always showheat pumps
  • WatchHome Assistant
  • Max 8 a dayWire Desk

Your own sources

Any feed you like. Try new ones on trial.

Any RSS or Atom feed, plus GitHub release feeds for software you run. Import an OPML file and its feeds go on trial: you only see their best few stories a day, and the ones you actually read are suggested as regular sources.

RSSAtomOPML Releases On trialField Notes2 of 3 read

It learns, you decide

More about climate Less from Daily Buzz Weekly3 suggestions to review

Likes, dislikes and opens shift what you see. The weekly suggestions for your interests wait for your OK before they apply.

A hard spending cap

$0.12of $0.50 today

AI calls stop for the day when your budget is reached. Without an API key everything still works, with stories shown newest first.

02Less bloat

One story, not five

Same event, one card.

Coverage from several outlets folds into a single card, and wide coverage lifts a story up. When you've seen what matters, the feed tells you you're done.

MPPort cities sign flood pact
HT12 cities pool flood money
DLShared fund for sea walls
HDFull coverage · 3 articles from 3 outlets

Key points

The gist, and whether to read on.

Top stories come with a one-line lede, a few bullets, a “why this matters to you” line, and a hint whether the full article is worth your time. For anything else, tap Get key points.

Key points 3

For you Matches your interest in climate and energy policy.

  • Fund starts at €1.2 billion, paid in proportion to coastline length
  • Money covers sea walls, pumps and early-warning sensors
  • Smaller cities get priority access to engineering help
✓ That's the whole storyOpen article ↗

03Relevant to you

Ranked for you

Every story, scored against your interests.

AI rates each story on topic, importance and personal fit, using an interests file that you write yourself or draft from a few ratings.

MPMeridian Post · 1 h agoTop story

Coastal cities agree on a shared flood-defence fund

Topic8.8
Importance8.1
Personal fit9.3
8.7For you Matches your interest in climate and energy policy.

Swipe to sort

Rate a backlog with one thumb.

Every swipe teaches your feed. Try it.

World · 1 h

Coastal cities agree on a shared flood-defence fund

Travel · 2 h

Night trains return on four European routes

Local · 3 h

Old town closes its main bridge to cars for good

Tech · 2 h

Open model now matches last year's frontier on coding tasks

✓

All sorted.

No black box

See why every story ranks where it does.

Calibration mode lists every story with its scores and reasons. And when the feed misses something, paste the link into Missed this to see why it didn't make the cut.

8.7Coastal cities agree on a shared flood-defence fund
6.2Open model now matches last year's frontier
2.1Transfer rumours: eleven clubs, one striker · you skip sport gossip

04No ads

No ads, no clickbait

Nothing in your feed is paid to be there.

NewsNest has no ads, no sponsored posts and nothing tuned for engagement. Advertorials, clickbait and promo pages score low and sink, and key points give you the gist before you open the publisher's page.

7.9Night trains return on four European routes
1.4Ten gadgets you need this winter · product promo, not one of your topics
0.9You won't believe what this city did next · clickbait

05Private

Installable and private

A phone app, served from your home.

A mobile-first web app with light and dark themes that installs to your home screen. Password-protected, with a one-click database backup. What leaves your server

And more
  • Full-text search, saved stories, a read history and a day-by-day archive
  • Summaries in the language of your choice
  • A status page and a /health endpoint that report feeds that fail or go quiet

How it works

A 60-second loop, from feed to front page.

It fetches the sources that are due, scores new stories in batches, and writes key points for the ones above your threshold.

  1. 01

    Fetch

    RSS, Atom and GitHub releases, de-duplicated by URL.

  2. 02

    Group

    The same story across outlets becomes one.

  3. 03

    Score

    Claude rates topic · importance · fit.

  4. 04

    Rank

    Score × freshness × what you like.

  5. 05

    Your feed

    Likes, opens and ratings flow back into the ranking.

Every batch

A small, cheap model with prompt caching does the scoring.

Rarely

A stronger model drafts your profile and the weekly suggestions.

Your call

Both models are set in config.yaml.

Privacy

What leaves your server, and what doesn't.

Stays on your machine

  • Your feed list and the database: one SQLite file
  • Your reading history, saved stories and likes
  • No ads and no trackers in the app
  • No telemetry. NewsNest phones home to no one.

Goes to the Anthropic API, with your key

  • Headlines and snippets, with your interests file and your country and city, for scoring
  • Article text, for key points
  • Headlines you've rated, for drafting your interests and the weekly suggestions
  • Links you paste into Missed this

No key? Then nothing goes to Anthropic at all, and the feed shows newest first.

Screens

Made for your phone first.

Key points, when you want them
Swipe to sort
Dark mode, automatically

Quick start

Up and running in five lines.

You need Docker with Compose and, for the AI features, an Anthropic API key.

terminal 
mkdir newsnest && cd newsnest
curl -fsSLO https://raw.githubusercontent.com/Lucifix/newsnest/main/docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/Lucifix/newsnest/main/.env.example -o .env     # set NEWSNEST_PASSWORD and ANTHROPIC_API_KEY
mkdir -p config data
docker compose up -d
  1. 1

    Say where you live

    Your country and city decide whose news counts as “big”.

  2. 2

    Add local news

    Pick the pack for your country, or add your own local feeds.

  3. 3

    Rate about 30 headlines

    NewsNest drafts your interests from them. That's the setup.

Open http://localhost:3095, log in with your password, and tap Set up my profile. The login is a single shared password, so put NewsNest behind an HTTPS reverse proxy before you expose it to the internet.

This pulls the published image for amd64 and arm64, so a Raspberry Pi works too: ghcr.io/lucifix/newsnest or lucifix/newsnest on Docker Hub. For a Portainer stack, or to build from source, see the README.

Contribute

Bring your country's news.

Local news packs ship with 8 to 10 national outlets each. Adding one for your country is a great first pull request.

Add a pack

Your news, on your terms.

Free, open source, ad-free and yours to run.

Install NewsNest Star on GitHub