Glean (拾灵) is an advanced self-hosted RSS reader and personal knowledge management tool designed to help users efficiently handle information overload through intelligent RSS aggregation.

Key Features

• 📰 RSS Subscription: Easily subscribe to and organize RSS/Atom feeds, including OPML import/export for seamless management.
• 📚 Smart Reading: Enjoy a clean reading experience complemented by content filtering for focused reading.
• 🔖 Read Later: Save articles for future reference with auto-cleanup options to keep your reading list manageable.
• 📁 Folders & Tags: Organize content with multi-level folders and tags that cater to personalized categorization needs.
• ⭐ Bookmarks: Quickly save articles both from feeds and external URLs for easy access.
• 🔧 Background Sync: Stay updated with automatic feed refreshes every 15 minutes, ensuring the latest content is always available.
• 🔒 Self-hosted: Maintain full data ownership with a straightforward Docker deployment process.
• 🎨 Modern UI: Experience a beautifully designed, responsive warm dark theme interface that enhances usability.
• 👨‍💼 Admin Dashboard: Manage users and monitor system performance with an accessible and functional admin dashboard.

Upcoming Features

• 🧠 Smart Recommendations: AI-driven article scoring and personalized preference learning.
• ⚙️ Rule Engine: Automated content processing through customizable Jinja2-style conditions.
• 🤖 AI Features: Enhance functionality with summaries, auto-tagging, and keyword extraction capabilities.
• 📄 Full Content Fetch: Retrieve complete article content for improved summaries from RSS feeds.
• 🔌 Chrome Extension: A browser extension for one-click bookmarking from web pages.
• 📱 Mobile PWA: A mobile-friendly Progressive Web App for accessing reading content on the go.

Deployment

Glean facilitates an effortless setup, allowing users to deploy the application with just a few commands. The system includes all essential services, including a web app, admin dashboard, backend API, and more. For users interested in a lighter version, a Docker solution without optional features is also available.

Tech Stack

Glean is built with a modern tech stack:

• Backend: Python 3.11+, FastAPI, SQLAlchemy, PostgreSQL, Redis.
• Frontend: React 18, TypeScript, Vite, Tailwind CSS.

Development

Glean embraces community contributions, and detailed guidelines are provided for those wishing to participate in development. The project also employs pre-commit hooks to ensure code quality and consistency.

For comprehensive information regarding deployment and contributions, please refer to the Deployment Guide and Development Guide.

Stay connected with updates and seek assistance through the dedicated Discord community.

Glean is a work in progress, continuously evolving to meet user needs and expectations.