reader

reader is a Python library for retrieving, storing, and managing Atom, RSS, and JSON feeds. It handles the feed layer so developers can build reader applications without writing business code around low-level feed handling or tying the application to a particular framework. In MVC terms, it acts as a fat model. It supports read and important states, arbitrary tags and metadata, feed and article filtering, full-text article search, activity statistics, OPML import and export, feed discovery from web pages, and plugins. A stable, clearly documented API, full Python typing, and test coverage support application development. Optional interfaces include a Flask, Bootstrap, and htmx web application and a command-line interface.

It is intended for Python developers creating custom feed readers who want to focus on what makes their product different rather than feed retrieval, storage, and management. It installs with pip.

The research does not identify a specific paid product that reader replaces, and it provides no documented comparison of equivalent abilities or shortcomings against one.

`make_reader(migrate: bool)`. Support Python 3.15 and PyPy 3.12; drop Python 3.11. Stop vendoring feedparser. See [changelog](https://github.com/lemon24/reader/blob/master/CHANGES.rst#version-327) for details.

Full release notes →