Reed

BETA. Reed es público y utilizable hoy, pero pre-1.0.0. Espera cambios importantes antes de la etiqueta v1.0.0. Consulta Hoja de ruta hacia v1.0.0 a continuación para ver lo que queda.

Un lector RSS de código abierto y autoalojado con un modelo de datos nativo de grafos, API REST pública y servidor MCP de primera clase.

¿Qué es Reed?

Reed es un lector RSS de un solo usuario, autoalojado, diseñado para la simplicidad y el acceso para desarrolladores. Utiliza una base de datos de grafos (Kuzu) para modelar las relaciones entre fuentes, artículos, autores, temas y etiquetas, lo que lo hace recorrible por herramientas de IA a través de un servidor MCP integrado.

Related MCP server: mcp-obsidian

Por qué construí Reed

Mi rutina diaria de lectura pasa por un segundo cerebro asistido por IA, y RSS nunca encajó limpiamente en ella. El lector que usaba mantenía un acceso decente a la API detrás de un nivel de pago, e incluso entonces, su modelo de datos — y el de todos los competidores, ya fueran de código abierto o comerciales — era una lista plana de artículos. Ninguno de ellos fue construido con clientes de IA como consumidores de primera clase, así que no había forma de entregar a un agente algo más rico que "aquí hay algunos elementos no leídos".

Reed existe para solucionar eso. Las fuentes, los artículos, los autores, los temas y las etiquetas son nodos y aristas en un grafo, no filas en una tabla, por lo que un cliente de IA puede recorrer las relaciones — saltar de un elemento a sus temas, a temas relacionados, a elementos relacionados en otras fuentes — en lugar de simplemente paginar a través de una lista. Comenzó como un prototipo de fin de semana y se ha convertido en una herramienta de uso diario.

Estado

Beta pública, pre-1.0.0. Los hitos M0 a M6 están completos: base, esqueleto funcional, lector utilizable, listo para migración, grafo vivo (extracción de temas, grafo de similitud), API completa e integraciones (hoja de compartir, exportación/importación, API de temas), y un servidor MCP de 27 herramientas que expone todo el grafo a clientes de IA a través de stdio y HTTP. Consulta docs/roadmap/milestones.md para el estado en vivo, y las secciones de hoja de ruta a continuación para lo que queda antes de v1.0.0.

Objetivos de diseño

• Interfaz de lectura RSS simple y rápida

• API REST totalmente pública (de primera clase, no una ocurrencia tardía)

• Servidor MCP para integración con clientes de IA y recorrido de grafos

• Un solo usuario, autoalojado — sin SaaS, sin servicio en la nube

• Cero sobrecarga operativa — un docker-compose up para ejecutar

Tecnología

• Python — lenguaje de aplicación en todos los componentes

• Kuzu — base de datos de grafos embebida

• FastAPI — API REST y documentación OpenAPI

• FastMCP — servidor MCP

• Vue 3 + Vite — interfaz web (lector de tres paneles, primero con teclado)

• Docker Compose — distribución e implementación principal

Autoalojamiento

Reed aún no se publica como una versión con número de versión: la imagen de Docker en GHCR y el paquete de PyPI llegarán con v1.0.0. Hasta entonces, ejecútalo desde el código fuente:

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

O construye la imagen de Docker localmente (coincidiendo con la etiqueta que espera docker-compose.yml, para que docker compose up la tome sin ediciones):

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

En cualquier caso, establece una REED_API_KEY real antes de comenzar — consulta .env.example y CONTRIBUTING.md para la configuración de desarrollo local.

Hoja de ruta hacia v1.0.0

Lo que queda antes de que se quite la etiqueta beta:

• Sitio web: un sitio de proyecto en vivo con guía de inicio rápido e instrucciones de instalación, servido a través de GitHub Pages.

• Pulido de distribución: el pipeline de lanzamiento está construido y verificado con una prueba en seco, pero aún no se ha empujado una etiqueta v1.0.0 real.

• Revisión de autenticación para alojamiento público: el modelo actual de autenticación con una única clave de API estática fue diseñado para una implementación autoalojada y limitada a LAN. Antes de que v1.0.0 respalde formalmente el alojamiento en la nube pública (Railway, Render, Fly.io), ese modelo necesita una revisión dedicada, rastreada como un issue propio de GitHub.

Sigue el progreso en vivo en docs/roadmap/milestones.md y en los Issues y Milestones del repositorio.

Hoja de ruta después de v1.0.0

Ideas ya esbozadas para consideración después del lanzamiento inicial. Ninguna es un compromiso todavía.

• Listas de seguimiento mantenidas por el usuario: un conjunto permanente de temas o descripciones de interés que marca nuevos elementos entrantes que coinciden con esas preocupaciones, independientemente de la fuente o la ruta de extracción de temas por la que llegaron.

• Vistas de recorrido de grafo guardadas: consultas de grafo nombradas y reutilizables más allá de las herramientas de recorrido ad hoc actuales.

• Modelado de autores y coautoría: tratar a los autores como entidades de grafo de primera clase con sus propias relaciones, no solo como metadatos de elementos.

• Descubrimiento programado: una función opt-in para escanear periódicamente contenido nuevo más allá de las fuentes a las que el usuario ya está suscrito, en lugar de limitarse a lo que ya se ha incorporado.

Consulta docs/roadmap/open-decisions.md en el repositorio para ver el backlog completo de preguntas de diseño del que se extraen estas ideas.

Licencia

AGPL v3