Easily deploy to GitHub Pages / Docker, hoping to get a one-stop look at what’s new from each information source. I also think that the products on the market are too “heavy”(I don’t want to register, log in/download APP/start desktop software…), A static page is just right (responsive/bright and dark themes, easy to browse on your computer and mobile phone).
🧠Project positioning and core functions
FeedMe Is an “AI-driven RSS aggregation reader” that enhances the information acquisition experience through the following methods:
- Multi-source content aggregation: Support real-time grabbing of content from multiple RSS feeds (such as Hacker News, GitHub Trend, Hugging Face Daily Papers, etc.)
- AI automatic summary: Call LLM (such as OpenAI model) to generate a concise summary for each article and present TL; DR-style reading
- Regular automatic updates: Use GitHub Actions (triggered every 3 hours) or local cron for regular content grabbing, summarizing and website building
- Category management theme switching: Support browsing different RSS feeds by category and switch light/dark themes
- Static deployment friendly: Static site generation, can be deployed to GitHub Pages or Vercel, or can be run locally through Docker
Deployment method
There are three deployment paths that flexibly adapt to different usage scenarios:
- GitHub Pages + Actions
- Fork Warehouse Post Setup
LLM_API_KEY,LLM_API_BASE,LLM_NAMEWait for secrets. - Open the Pages service and push or schedule scheduled actions to automatically build and deploy
- Fork Warehouse Post Setup
- Vercel deployment
- Import the project into Vercel and configure
VERCEL_TOKEN,VERCEL_ORG_ID,VERCEL_PROJECT_ID, settingsENABLE_VERCEL_DEPLOYMENT=trueAutomatic deployment
- Import the project into Vercel and configure
- Docker container deployment
- Clone the project, configure environment variables (such as in the
.envfill in LLM related),docker-compose up --buildStart the service and listen on local port 3000 by default.
- Clone the project, configure environment variables (such as in the
⚙️配置详解
- RSS feed management: Editor
config/rss-config.jsAdd or modify a feed (name, URL, category, etc.) - update frequency: In
.github/workflows/update-deploy.ymlCustomize update times in cron expressions of - Number of summaries: Available through
config/rss-config.jsthemaxItemsPerFeedControl the number of reserved entries per source. - Customize summary logic: Modification
scripts/update-feeds.jsofpromptto adjust the style, language or format of the summary - Deployment path adaptation: The project will automatically identify the deployment platform (GitHub Pages, Vercel, custom domain names) and adjust the static resource basePath path
🧩Technology Stack
- Front-end: Next.js + React + TypeScript
- Style: Tailwind CSS + shadcn/ui
- Routing and deployment: GitHub Actions, Vercel, Docker
- Data acquisition and generation: RSS feeds + OpenAI and other LLM
Key documents in Repo include package.json、next.config.mjs, GitHub Actions workflow, Docker-related configurations, etc., fully support development and operation
Applicable population
- Users who like RSS syndication but don’t want to use heavy apps.
- You need to read the abstract to focus on the key points and don’t want to read the full text.
- A static site that you want to self-host and has no third-party App login dependence.
- Have basic configuration capabilities and can debug GitHub Secrets, cron or Docker.
📚Recommended reading/Next step
- A trial experience for Fork: Edit the RSS feeds you want to follow and explore whether AI summaries fit your reading habits.
- If you want to enhance functions, such as full-text grabbing, image display, keyword marking, etc., you can continue to use the
scriptsOr extend on the front-end page. - Note: Currently, SECURITY.md has not been set in the project, indicating that the security policy is vacant. If it is used in sensitive scenarios, it is recommended to pay attention to security configuration (such as API key management, HTTPS).
Github:https://github.com/Seanium/FeedMe
Oil tubing: