Repolode
Submit
ncarlier

ncarlier/readflow

A self-hostable read-it-later and news reader that gathers articles from anywhere into one place, with no ads or trackers.

Open-source alternative to:PocketInstapaper

View on GitHubWebsite
Stars
476
Forks
32
Open issues
10
Last commit
25 days ago

What is it?

readflow is a read-it-later and news-reading application that collects articles from different sources into a single interface. Articles can be saved for offline reading or exported locally in formats such as HTML, PDF, EPUB or ZIP. Categories let you organize incoming content, and a scripting engine can customize how articles are processed.

Integration with other services relies on incoming and outgoing webhooks. Supported targets include Pocket, Wallabag, Shaarli, RSS through feedpushr, S3 buckets and newsletters. Notifications alert you when new articles arrive, and the Progressive Web App gives the same experience on mobile as on desktop.

Besides the web UI, the project ships readflow-ctl, a command-line client for the GraphQL API that includes an MCP server for connecting AI assistants to article and category data. The service is written in Go with a TypeScript and React front end and runs with PostgreSQL.

Key features

  • 01Collects articles from many sources into one reading list.
  • 02Saves articles for offline reading or exports them as HTML, PDF, EPUB or ZIP.
  • 03Organizes content with categories and a scripting engine for custom processing.
  • 04Connects to Pocket, Wallabag, Shaarli, S3 and others through webhooks.
  • 05Provides a PWA for mobile use and a readflow-ctl CLI with an MCP server.

Use cases

  • Keeping a personal read-it-later queue that syncs across phone and desktop.
  • Archiving articles locally in PDF or EPUB for offline reading.
  • Forwarding saved articles to Wallabag, Pocket or an S3 bucket automatically.
  • Letting AI assistants summarize or categorize your saved articles through MCP.

Quick start

  1. 1

    Start the app with Docker Compose

    docker compose up
  2. 2

    Open the Web UI in your browser

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified versions under the same terms.
  • The Docker run option needs your own PostgreSQL database connection string.

In collections

Self-hosted appsGraphQL APIs & API clients

Topics

#read-it-later#rss#news-reader#self-hosted#golang#react#graphql#pwa#bookmarks#feed

FAQ

What is readflow?
A self-hostable read-it-later and news reader that gathers articles from anywhere into one place, with no ads or trackers. readflow is a read-it-later and news-reading application that collects articles from different sources into a single interface. Articles can be saved for offline reading or exported locally in formats such as HTML, PDF, EPUB or ZIP. Categories let you organize incoming content, and a scripting engine can customize how articles are processed.
Is readflow free to use? What license does it have?
readflow is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is readflow still maintained?
Actively maintained. The last commit to readflow was on Oct 12, 2026.
What can I use readflow for?
Keeping a personal read-it-later queue that syncs across phone and desktop. Archiving articles locally in PDF or EPUB for offline reading. Forwarding saved articles to Wallabag, Pocket or an S3 bucket automatically. Letting AI assistants summarize or categorize your saved articles through MCP.
How do I install readflow?
Start the app with Docker Compose: docker compose up Open the Web UI in your browser
Where can I get readflow?
The source code and installation instructions are on GitHub: https://github.com/ncarlier/readflow

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

Related projects