FeedMe  by Seanium

AI-powered RSS reader for GitHub Pages or Docker deployment

Created 8 months ago
704 stars

Top 48.6% on SourcePulse

GitHubView on GitHub
Project Summary

FeedMe is an AI-powered RSS reader designed for users who want a lightweight, customizable, and self-hostable solution to aggregate and summarize content from multiple sources. It targets individuals seeking an efficient way to stay updated without the overhead of traditional apps, offering AI-driven summaries for quick content digestion.

How It Works

FeedMe aggregates RSS feeds, processes articles using a Large Language Model (LLM) for AI-generated summaries, and presents the content through a responsive, static web interface. The core advantage lies in its AI summarization capability, allowing users to TLDR articles, and its flexible deployment options, including zero-cost GitHub Pages or easy Docker setup.

Quick Start & Requirements

  • GitHub Pages Deployment: Fork/clone, set LLM_API_KEY, LLM_API_BASE, LLM_NAME as GitHub Secrets, and enable GitHub Actions deployment.
  • Vercel Deployment: Import repo to Vercel, set VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID as Secrets, and ENABLE_VERCEL_DEPLOYMENT=true as a Variable.
  • Docker Deployment: Clone, copy .env.example to .env, fill in LLM credentials, and run docker-compose up --build.
  • Development: Clone, pnpm install, configure .env with LLM credentials, run pnpm update-feeds to fetch data, and pnpm dev to start the server.
  • Prerequisites: LLM API Key and Base URL are required for AI summarization.

Highlighted Details

  • AI-powered article summarization using LLMs.
  • Deployable to GitHub Pages, Vercel, or via Docker.
  • Customizable RSS sources, AI models, and update frequencies.
  • Responsive design with light/dark theme support.

Maintenance & Community

The project is actively maintained, with deployment managed via GitHub Actions. Community links or specific contributor details are not explicitly provided in the README.

Licensing & Compatibility

Licensed under the MIT License, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

AI summarization functionality is dependent on external LLM services and requires valid API keys. Customization of the AI prompt for summarization is possible but requires modifying the scripts/update-feeds.js file.

Health Check
Last Commit

20 hours ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
16 stars in the last 30 days

Explore Similar Projects

Starred by Eugene Yan Eugene Yan(AI Scientist at AWS) and Eric Zhu Eric Zhu(Coauthor of AutoGen; Research Scientist at Microsoft Research).

news-agents by eugeneyan

0%
308
News aggregation system in the terminal
Created 8 months ago
Updated 5 months ago
Feedback? Help us improve.