Repolode
Submit
samuelclay

samuelclay/NewsBlur

A personal RSS news reader with filtering that learns your likes and dislikes, plus social sharing, available on web, iOS, and Android, and self-hostable.

Open-source alternative to:FeedlyInoreader

View on GitHubWebsite
Stars
7,668
Forks
1,046
Open issues
139
Last commit
20 hours ago

What is it?

NewsBlur is an RSS feed reader and social news network. It shows the original site for each story and includes a training system: you mark stories or authors, tags, titles and feeds as liked or disliked, and the reader highlights or hides matching stories accordingly. Stories can be saved with tags, searched in full text across all subscriptions, and shared to a public or friends-only blurblog.

Beyond classic feeds, it can follow YouTube channels and newsletters, expand truncated feeds to the full article, and track how a story changed after publication. Native apps are available for iOS, macOS and Android, and it works with third-party clients such as Reeder and ReadKit.

The repository contains the full server stack, built on Django with PostgreSQL, MongoDB, Redis and Celery, and can be run locally with Docker Compose. It also includes an MCP server so AI agents can read feeds, search stories and manage classifiers.

Key features

  • 01Trainable filters that highlight or hide stories by author, tag, title or feed
  • 02Original site view and expansion of truncated feeds to full articles
  • 03Full-text search across all subscriptions
  • 04Follows YouTube channels and email newsletters alongside RSS
  • 05Native iOS, macOS and Android apps, plus compatibility with third-party readers
  • 06MCP server for connecting AI agents to feeds and stories

Use cases

  • Keeping up with many news sites while filtering out topics you don't want
  • Following YouTube channels and newsletters in the same reader as RSS feeds
  • Running a private, self-hosted news reader with your own data
  • Letting an AI agent summarize unread stories or triage your inbox

Quick start

  1. 1

    Install Docker and Docker Compose (prerequisite)

  2. 2

    Clone the repository

    git clone https://github.com/samuelclay/NewsBlur.git
  3. 3

    Enter the project directory

    cd NewsBlur
  4. 4

    Start the containers and apply migrations, then open https://localhost

    make

Things to know

  • Self-hosting requires Docker and multiple services (PostgreSQL, MongoDB, Redis, Celery, Node.js).
  • Some features such as AI and Discover need an OpenAI API key.
  • The MCP server requires a NewsBlur premium subscription.

In collections

Self-hosted appsAndroid apps & phone toolsOpen-source personal AI agents

Topics

#rss#feed-reader#news#self-hosted#django#python#mobile-app#personal-agent#android#elasticsearch

FAQ

What is NewsBlur?
A personal RSS news reader with filtering that learns your likes and dislikes, plus social sharing, available on web, iOS, and Android, and self-hostable. NewsBlur is an RSS feed reader and social news network. It shows the original site for each story and includes a training system: you mark stories or authors, tags, titles and feeds as liked or disliked, and the reader highlights or hides matching stories accordingly. Stories can be saved with tags, searched in full text across all subscriptions, and shared to a public or friends-only blurblog.
Is NewsBlur free to use? What license does it have?
NewsBlur is open source under the MIT license. Check the license terms before using it in commercial products.
Is NewsBlur still maintained?
Actively maintained. The last commit to NewsBlur was on Oct 23, 2026.
What can I use NewsBlur for?
Keeping up with many news sites while filtering out topics you don't want Following YouTube channels and newsletters in the same reader as RSS feeds Running a private, self-hosted news reader with your own data Letting an AI agent summarize unread stories or triage your inbox
How do I install NewsBlur?
Install Docker and Docker Compose (prerequisite) Clone the repository: git clone https://github.com/samuelclay/NewsBlur.git Enter the project directory: cd NewsBlur Start the containers and apply migrations, then open https://localhost: make
Where can I get NewsBlur?
The source code and installation instructions are on GitHub: https://github.com/samuelclay/NewsBlur

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects