17 KiB
In the torrent of information (Feed), may you maintain your Zen.
zenfeed is your AI information hub. It's an intelligent RSS reader, a real-time "news" knowledge base, and a personal secretary that helps you monitor "specific events" and delivers analysis reports.
Live Demo (RSS Reading Only) | Technical Documentation | Quick Start
Note
The description on DeepWiki is not entirely accurate (and I cannot correct it), but the Q&A quality is decent.
epub2rss: Convert epub ebooks into RSS feeds that update with a chapter every day, join waitlist
💡 Introduction
RSS (Really Simple Syndication) was born in the Web 1.0 era to solve the problem of information fragmentation, allowing users to aggregate and track updates from multiple websites in one place without frequent visits. It pushes website updates to subscribers in summary form for quick information retrieval.
However, with the rise of Web 2.0, social media, and algorithmic recommendations, RSS never became mainstream. The shutdown of Google Reader in 2013 was a landmark event. As Zhang Yiming (founder of ByteDance) pointed out at the time, RSS demands a lot from its users: strong information filtering skills and self-discipline to manage subscription sources, otherwise it's easy to get drowned in information noise. He believed that for most users, easier "personalized recommendations" were a better solution, which led to the creation of Toutiao and Douyin (TikTok).
Algorithmic recommendations have indeed lowered the barrier to accessing information, but their tendency to over-cater to human weaknesses often leads to filter bubbles and entertainment addiction. If you want to get truly valuable content from your information stream, you need even greater self-control to resist the algorithm's "feed."
So, is pure RSS subscription the answer? Not entirely. Information overload and the difficulty of filtering (information noise) are still major pain points for RSS users.
Confucius spoke of the "Doctrine of the Mean" in all things. Can we find a middle ground that allows us to enjoy the sense of control and high-quality sources from active RSS subscriptions while using technology to overcome the drawback of information overload?
Give zenfeed a try! AI + RSS might be a better way to consume information in this era. zenfeed aims to leverage the power of AI to help you automatically filter and summarize the information you care about, allowing you to maintain your Zen in the torrent of information (Feed).
Reference Article: AI Revives RSS? - sspai.com (Chinese)
✨ Features
For RSS Power Users 🚗
- Your AI-powered RSS reader (use with zenfeed-web)
- Can act as an MCP Server for RSSHub
- Customize trusted RSS sources to build a lightning-fast personal AI search engine
- Similar in functionality to Feedly AI
Preview
For Those Seeking an Everything Tracker Alternative 🔍
- Possesses powerful information tracking capabilities and emphasizes high-quality, customizable data sources.
- Can serve as an RSS version of AI Chief Intelligence Officer, but more flexible and closer to an engine.
Preview
For Those with Information Anxiety (like me) 😌
- If you're tired of endlessly scrolling through feeds, try the briefing feature. Receive AI-powered briefings at a scheduled time each day for a comprehensive and efficient overview, eliminating the hidden costs of context switching. A bit of a renaissance feel, don't you think? ✨
- "zenfeed" is a combination of "zen" and "feed," meaning: in the torrent of information (feed), may you maintain your zen.
Preview
For Developers 🔬
- Pipelined Processing: Similar to Prometheus's Relabeling, zenfeed abstracts each piece of content into a set of labels. At each stage of the pipeline, you can use custom prompts to process these labels (e.g., scoring, classifying, summarizing, filtering).
- Flexible Orchestration: Based on the processed labels, you can freely query, filter, route, and send notifications, giving zenfeed a highly tool-oriented and customizable nature. For details, see Rewrite Rules.
- Open APIs:
Preview
🚀 Installation and Usage
1. Prerequisites
Important
zenfeed uses model services from SiliconFlow by default.
- Models:
Qwen/Qwen3-8B(Free) andQwen/Qwen3-Embedding-4B.- If you don't have a SiliconFlow account yet, use this invitation link to get a ¥14 credit.
- If you need to use other providers or models, or for more detailed custom deployments, please refer to the Configuration Documentation to edit
docker-compose.yml.
2. One-Click Deployment
Get the service up and running in as little as one minute.
Mac / Linux
# Download the configuration file
curl -L -O https://raw.githubusercontent.com/glidea/zenfeed/main/docker-compose.yml
# Start the service (replace with your API_KEY)
API_KEY="sk-..." docker-compose -p zenfeed up -d
Windows (PowerShell)
# Download the configuration file
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/glidea/zenfeed/main/docker-compose.yml" -OutFile "docker-compose.yml"
# Start the service (replace with your API_KEY)
$env:API_KEY = "sk-..."; docker-compose -p zenfeed up -d
🎉 Deployment Complete! Access it at http://localhost:1400
Warning
- If you deploy zenfeed on a public server like a VPS, access it via
http://<YOUR_IP>:1400and ensure that your firewall/security group allows traffic on port1400.- Security Notice: zenfeed does not yet have an authentication mechanism. Exposing the service to the public internet may leak your
API_KEY. Be sure to configure strict security group rules to allow access only from trusted IPs.
3. Getting Started
Add RSS Subscription Feeds
- To migrate from Follow, please refer to migrate-from-follow-en.md.
- After adding a source, zenfeed needs to access the origin site, so ensure your network is connected.
- Please wait a few minutes after adding for content to be fetched and processed, especially if the model has strict rate limits.
Configure Daily Briefings, Monitoring, etc.
Configure MCP (Optional)
For example, to configure MCP and connect to Zenfeed with Cherry Studio, see Cherry Studio MCP.
Default address
http://localhost:1301/sse
More...
The web UI doesn't fully capture zenfeed's powerful flexibility. For more ways to play, please check the Configuration Documentation
🗺️ Roadmap
We have some cool features planned. Check out our Roadmap and feel free to share your suggestions!
💬 Community and Support
For usage questions, please prioritize opening an Issue. This helps others with similar problems and allows for better tracking and resolution.
Join WeChat Group |
Buy Me a Coffee 🧋 |
Since you've read this far, how about giving us a Star ⭐️? It's the biggest motivation for me to keep maintaining this project!
If you have any interesting AI job opportunities, please contact me!
🧩 Ecosystem Projects
Ruhang365 Daily
Founded in 2017, Ruhang365 aims to build a community for sharing expertise and growing together, starting with industry information exchange. It is dedicated to providing comprehensive career consulting, training, niche community interactions, and resource collaboration services for internet professionals.
Experimental Content Sources (Updates Paused)
📝 Notes and Disclaimer
Notes
- Version Compatibility: Backward compatibility for APIs and configurations is not guaranteed before version 1.0.
- Open Source License: The project uses the AGPLv3 license. Any forks or distributions must also remain open source.
- Commercial Use: Please contact the author to register for commercial use. Support can be provided within reasonable limits. We welcome legitimate commercial applications but discourage using this project for illicit activities.
- Data Storage: Data is not stored permanently; the default retention period is 8 days.
Acknowledgements
- Thanks to eryajf for the Compose Inline Config suggestion, which makes deployment easier to understand.
Contributing
- The contribution guidelines are still a work in progress, but we adhere to one core principle: "Code Style Consistency."
Disclaimer
Click to expand for the full disclaimer
Before using the zenfeed software (hereinafter "the Software"), please read and understand this disclaimer carefully. By downloading, installing, using the Software or any related services, you acknowledge that you have read, understood, and agree to be bound by all the terms of this disclaimer. If you do not agree with any part of this disclaimer, please cease using the Software immediately.
-
"AS IS" BASIS: The Software is provided on an "as is" and "as available" basis, without any warranties of any kind, either express or implied. The project authors and contributors make no representations or warranties regarding the Software's merchantability, fitness for a particular purpose, non-infringement, accuracy, completeness, reliability, security, timeliness, or performance.
-
USER RESPONSIBILITY: You are solely responsible for all your activities conducted through the Software. This includes, but is not limited to:
- Data Source Selection: You are responsible for selecting and configuring the data sources (e.g., RSS feeds, future potential Email sources) to be connected. You must ensure that you have the right to access and process the content from these sources and comply with their respective terms of service, copyright policies, and applicable laws and regulations.
- Content Compliance: You must not use the Software to process, store, or distribute any illegal, infringing, defamatory, obscene, or otherwise objectionable content.
- API Key and Credential Security: You are responsible for safeguarding any API keys, passwords, or other credentials you configure within the Software. The project authors and contributors are not liable for any loss or damage arising from your failure to do so.
- Configuration and Use: You are responsible for the correct configuration and use of the Software's features, including content processing pipelines, filtering rules, notification settings, etc.
-
THIRD-PARTY CONTENT AND SERVICES: The Software may integrate with or rely on third-party data sources and services (e.g., RSSHub, LLM providers, SMTP services). The project authors and contributors are not responsible for the availability, accuracy, legality, security, or terms of service of such third-party content or services. Your interactions with these third parties are governed by their respective terms and policies. The copyright of third-party content accessed or processed through the Software (including original articles, summaries, classifications, scores, etc.) belongs to the original rights holders. You are solely responsible for any legal liabilities that may arise from your use of such content.
-
NO GUARANTEE OF PROCESSING ACCURACY: The Software uses technologies like Large Language Models (LLMs) to process content (e.g., for summaries, classifications, scoring, filtering). These results may be inaccurate, incomplete, or biased. The project authors and contributors are not responsible for any decisions or actions taken based on these processing results. The accuracy of semantic search results is also affected by multiple factors and is not guaranteed.
-
LIMITATION OF LIABILITY: In no event shall the project authors or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.
-
OPEN SOURCE SOFTWARE: The Software is licensed under the AGPLv3 license. You are responsible for understanding and complying with the terms of this license.
-
NOT LEGAL ADVICE: This disclaimer does not constitute legal advice. If you have any questions about the legal implications of using the Software, you should consult with a qualified legal professional.
-
MODIFICATION AND ACCEPTANCE: The project authors reserve the right to modify this disclaimer at any time. Your continued use of the Software will be deemed acceptance of the modified terms.
Please be aware: Crawling, processing, and distributing copyrighted content using the Software may carry legal risks. Users are responsible for ensuring that their use complies with all applicable laws, regulations, and third-party terms of service. The project authors and contributors assume no liability for any legal disputes or losses arising from the user's misuse or improper use of the Software.