RSS feed aggregator and merger built with FastAPI, SQLModel, and Jinja2.
- Python 3.11+
- uv
| Variable | Description |
|---|---|
ENABLE_BACKGROUND_WORKER |
0 or 1 |
SECRET_KEY |
For cookie signing, required |
MEDIA_DIR |
Path to media downloads |
DISPLAY_TIMEZONE |
Time zone for rendering times and also interpreting cron schedules |
# Install dependencies
uv sync
# Show commands
poe help
# The server runs at http://localhost:8000 (and listens on all interfaces).
poe dev
# To run **only** the background worker with or without the web server:
poe worker
poe devworkercooldown_minuteswill fetch a feed every n minutesschedulewill fetch a feed for a cron schedulecache_mediawill toggle local media cachelimitlimits number of posts per feedtypeis one ofdigest|facebook|hackernews|instagram|merge|reddit|rss|smart_filter|wordpress_mec_eventsidmust be unique. Changing ID = erasing and recreating feed.tagsare useful for creating merge feeds