Sparkfeed Documentation

Sparkfeed brings every blog, news source, and website your team cares about into one clean, distraction-free space. No algorithms, no ads, no telemetry. It is open source under AGPL-3.0 and runs entirely on infrastructure you control.

Start here

New to Sparkfeed? These three pages take you from nothing installed to a running instance.

IntroductionWhat Sparkfeed is, why it exists, and what you can do with it.Local setupClone the repo, install dependencies, and have Sparkfeed running in minutes.Demo modeExplore a seeded instance immediately. No account, no migration, no keys.

Explore by topic

The rest of the documentation, grouped by what you are trying to do.

Core conceptsHow RSS, feed aggregation, and the local database fit together.FeaturesThe reading interface, offline access, favorites, and responsive behaviour.Spark AISummaries, trend detection, and categorization that run on a key you own.ConfigurationAI providers and every environment variable Sparkfeed reads.Tech stackReact, TanStack Router, Nitro, PostgreSQL, Drizzle, and Zustand.DeveloperConnect an AI agent over MCP, and manage the API keys that authenticate it.

Key features

• Any site to feed

  Turn any website into a trackable feed, even sites that never published RSS.

• Privacy first

  Zero telemetry, no ads, and your data never trains AI models.

• Self-hostable

  Open source under AGPL-3.0. Run it on your own infrastructure.

• Operator controlled

  Feeds, articles, accounts, and chats live in your PostgreSQL database.

• Folders and keyword filters

  Organize sources hierarchically and cut the noise.

• OPML import and export

  Bring your subscriptions in and out. You are never locked in.

• Spark AI

  Summaries and trend detection that run on an AI key you control.

• MCP for AI agents

  Let Claude or Cursor search your feeds and read full articles over the Model Context Protocol.

• Fast and minimal

  A React and Tailwind interface built for near-instant navigation.

Your instance, your database

Community Edition stores its durable data in the PostgreSQL database you configure. Sparkfeed does not add product telemetry or require Sparkable’s hosted service. Demo mode remains a separate, disposable SQLite path for trying the interface without account setup.

Terminal

$ bun dev

✓ database PostgreSQL connected
✓ migrations up to date
✓ feeds 24 sources refreshed

➜ ready on http://localhost:3000

On the roadmap

• Community packagingBeta

  Verified container upgrades, backup, and restore.

• Stable REST and MCPBeta

  Harden the public contracts before version 1.0.

• WebhooksSoon

  Push new articles to Slack, automation platforms, or your own endpoint.

How Sparkfeed compares

How Sparkfeed lines up against popular self-hosted and hosted readers.

Feature	Sparkfeed	FreshRSS	Miniflux	NewsBlur	Feedly	Inoreader
Open source	AGPL-3.0	AGPL-3.0	Apache-2.0	MIT (core)	No	No
Self-hostable	Yes	Yes	Yes	Yes †	No	No
Zero telemetry	Yes	Yes	Yes	No	No	No
Any site to feed	Yes	No	No	No	No	Yes ‡
OPML import / export	Yes	Yes	Yes	Yes	Yes	Yes
Bring-your-own AI keys	Yes	No	No	No	No	No
Team workspaces	Yes	No	No	No	Yes ‡	Yes ‡

† NewsBlur self-hosting is supported but more involved to set up.  ‡ Available on paid or higher tiers.

Want the full breakdown, including licenses and privacy posture? Read The Best Private RSS Readers in 2026 and Feedly Alternatives That Respect Your Privacy.

Start reading in five minutes.

Get started