Reed

BETA. Reed ist öffentlich und nutzbar, aber noch vor 1.0.0. Vor dem v1.0.0-Tag sind bahnbrechende Änderungen zu erwarten. Siehe Roadmap zu v1.0.0 weiter unten für das, was noch aussteht.

Ein selbst gehosteter, quelloffener RSS-Reader mit einem graphentauglichen Datenmodell, öffentlicher REST-API und erstklassigem MCP-Server.

Was ist Reed?

Reed ist ein Einzelbenutzer-RSS-Reader zum Selbsthosten, gebaut für Einfachheit und Entwicklerzugriff. Er verwendet eine Graphdatenbank (Kuzu), um Beziehungen zwischen Feeds, Artikeln, Autoren, Themen und Tags zu modellieren – was ihn für KI-Tools über einen eingebauten MCP-Server durchquerbar macht.

Related MCP server: mcp-obsidian

Warum ich Reed gebaut habe

Meine tägliche Leseroutine läuft über ein KI-gestütztes Second Brain, und RSS passte nie sauber hinein. Der Reader, den ich nutzte, hielt anständigen API-Zugriff hinter einer kostenpflichtigen Stufe, und selbst dann war sein Datenmodell – und das jedes Konkurrenten, ob FOSS oder kommerziell – eine flache Liste von Artikeln. Keiner von ihnen war mit KI-Clients als erstklassigen Konsumenten gebaut, also gab es keine Möglichkeit, einem Agenten etwas Reicheres zu geben als „hier sind einige ungelesene Elemente“.

Reed existiert, um das zu beheben. Feeds, Artikel, Autoren, Themen und Tags sind Knoten und Kanten in einem Graphen, nicht Zeilen in einer Tabelle, sodass ein KI-Client Beziehungen durchqueren kann – von einem Element zu seinen Themen, zu verwandten Themen, zu verwandten Elementen über andere Feeds hinweg – statt nur durch eine Liste zu blättern. Es begann als Wochenend-Prototyp und ist zu einem täglichen Begleiter geworden.

Status

Öffentliche Beta, vor 1.0.0. Die Meilensteine M0 bis M6 sind abgeschlossen: Fundament, laufendes Skelett, nutzbarer Reader, migrationsbereit, Graph lebendig (Themenextraktion, Ähnlichkeitsgraph), vollständige API und Integrationen (Share-Sheet, Export/Import, Themen-API) und ein 27-Tool-MCP-Server, der den gesamten Graphen KI-Clients über stdio und HTTP zugänglich macht. Siehe docs/roadmap/milestones.md für den Live-Status und die Roadmap-Abschnitte unten für das, was vor v1.0.0 noch aussteht.

Designziele

• Einfache, schnelle RSS-Leseoberfläche

• Vollständig öffentliche REST-API (erstklassig, kein nachträglicher Gedanke)

• MCP-Server für KI-Client-Integration und Graph-Durchquerung

• Einzelbenutzer, selbst gehostet – kein SaaS, kein Cloud-Dienst

• Null Betriebsaufwand – ein docker-compose up zum Ausführen

Technologie

• Python – Anwendungssprache über alle Komponenten

• Kuzu – eingebettete Graph-Datenbank

• FastAPI – REST-API und OpenAPI-Dokumentation

• FastMCP – MCP-Server

• Vue 3 + Vite – Web-UI (Drei-Pane-Reader, tastaturorientiert)

• Docker Compose – primäre Verteilung und Bereitstellung

Selbsthosting

Reed ist noch nicht als versionierte Veröffentlichung veröffentlicht – das Docker-Image auf GHCR und das PyPI-Paket kommen mit v1.0.0. Bis dahin aus dem Quellcode ausführen:

git clone https://github.com/simonives/reed
cd reed
pip install -e .
reed serve

Oder das Docker-Image lokal bauen (passend zum Tag, den docker-compose.yml erwartet, sodass docker compose up es ohne Änderungen aufnimmt):

git clone https://github.com/simonives/reed
cd reed
docker build -t ghcr.io/simonives/reed:latest .
cp .env.example .env   # add your REED_API_KEY
docker compose up

In jedem Fall vor dem Start einen echten REED_API_KEY setzen – siehe .env.example und CONTRIBUTING.md für die lokale Entwicklungsumgebung.

Roadmap zu v1.0.0

Was noch fehlt, bevor das Beta-Label entfernt wird:

• Website: eine Live-Projektseite mit Schnellstart- und Installationsanweisungen, bereitgestellt über GitHub Pages.

• Verteilungs-Politur: die Release-Pipeline ist gebaut und trockenlauf-verifiziert, aber noch kein echtes v1.0.0-Tag gepusht.

• Öffentliche-Hosting-Auth-Überprüfung: das aktuelle Einzel-Statik-API-Key-Auth-Modell wurde für eine LAN-gebundene, selbst gehostete Bereitstellung entworfen. Bevor v1.0.0 öffentliches Cloud-Hosting (Railway, Render, Fly.io) formal unterstützt, braucht dieses Modell eine dedizierte Überprüfung, verfolgt als eigenes GitHub-Issue.

Live-Fortschritt in docs/roadmap/milestones.md und den Issues und Meilensteinen des Repositorys verfolgen.

Roadmap nach v1.0.0

Ideen, die bereits für die Betrachtung nach der ersten Veröffentlichung skizziert sind. Noch keine Verpflichtungen.

• Benutzerverwaltete Watchlists: eine dauerhafte Sammlung von Themen oder Beschreibungen von Interesse, die neue eingehende Artikel markiert, die diesen Interessen entsprechen, unabhängig davon, über welchen Feed oder Themen-Extraktionspfad sie kamen.

• Gespeicherte Graph-Durchquerungsansichten: benannte, wiederverwendbare Graph-Abfragen über die aktuellen Ad-hoc-Durchquerungswerkzeuge hinaus.

• Autoren- und Koautoren-Modellierung: Autoren als erstklassige Graph-Entitäten mit eigenen Beziehungen behandeln, nicht nur als Artikel-Metadaten.

• Geplante Entdeckung: eine opt-in-Funktion, um periodisch nach neuen Inhalten über die Feeds hinaus zu suchen, die ein Benutzer bereits abonniert hat, statt auf das beschränkt zu sein, was bereits aufgenommen wurde.

Siehe docs/roadmap/open-decisions.md im Repository für den vollständigen Design-Fragen-Backlog, aus dem diese stammen.

Lizenz

AGPL v3