selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

feeds.fun logo

Self-host feeds.fun

release-1.29.4

AI-powered news reader with automatic tagging and scoring

ReleaseOpen SourceOther
Updated7 hours ago
LanguagePython
Setup difficultyAdvanced
MobileResponsive
Stars
395
Port
8000 (backend API server)
Requires
PostgreSQL
Docker
tiendil/feeds-fun-backend
Install with Docker Compose
News filtering interface showing tagged entries with scoresNews filtering example from documentation

What is feeds.fun?

Feeds Fun is a self-hosted news aggregator that automatically assigns tags to feed entries using LLM processors (OpenAI, Gemini, or self-hosted models). Users create scoring rules based on tags to filter and sort their news, reading only what matters. It supports single-user and multi-user modes with OIDC authentication via Keycloak. The backend runs on Python/FastAPI with PostgreSQL, workers handle feed loading and tagging, and the frontend is a React/TypeScript SPA. It includes built-in integrations for Reddit, GitHub, YouTube, Hacker News, and ArXiv with custom feed discovery and post-processing. Configuration is via environment variables or TOML files for tag processors, normalizers, and LLM models.

Should you self-host feeds.fun?

feeds.fun scores 50/100 on selfhost.directory (how scoring works) and ranks #27 of 85 in Feed Reader. It has 395 GitHub stars.

It shipped 5 stable releases in the past year. The latest, release-1.26.0, came out on 28 April 2026. New versions land roughly every 7 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 703 stars). It scores higher overall, so compare the two before you pick. See feeds.fun vs RSSHub side by side.

Features

  • Automatic AI tagging
  • Curated feed collections
  • Feed Management
  • Multi-user and single-user modes
  • News tokens and entitlements
  • Read tracking
  • Source-specific integrations
  • Tag-based scoring rules
  • Tag normalization
  • Third-party LLM support

feeds.fun README

How to install feeds.fun

Install feeds.fun with Docker Compose

Environment variables
FFUN_ENABLE_API_SPA, FFUN_AUTH_FORCE_EXTERNAL_USER_ID, FFUN_AUTH_FORCE_EXTERNAL_IDENTITY_PROVIDER_ID, FFUN_APP_DOMAIN, FFUN_USER_SETTINGS_SECRET_KEY, FFUN_POSTGRESQL__HOST, FFUN_POSTGRESQL__USER, FFUN_POSTGRESQL__PASSWORD, FFUN_POSTGRESQL__DATABASE, FFUN_ENVIRONMENT

docker compose --profile single-user up -d

Start workers:

./bin/backend-utils.sh poetry run ffun workers --librarian --loader

Simplest self-hosted setup for one user with PostgreSQL and Caddy

feeds.fun releases & version history

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…