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.

GitHub
papernews logo

Self-host papernews

0.1.0

News aggregator rendering feeds into calm LaTeX PDF digests

AlphaOpen SourceMIT
Updated3 months ago
LanguagePython
Setup difficultyModerate
Stars
165
Storage
~2 GB of disk for the image
Port
8000 (HTTP web server serving landing page and PDF digest)
Install with Docker Compose

What is papernews?

papernews aggregates news from RSS/Atom feeds and Hacker News, extracts full article text with trafilatura, then uses an LLM backend (Anthropic API or a local Ollama instance) to summarize and rewrite each article into clean, translated English. The results are rendered via a Jinja LaTeX template into a multi-page PDF with a magazine-style layout: cover page with quote of the day and world news, table of contents, and two-column article bodies with proper typography. The PDF is served on-demand from a Flask web server (port 8000) and cached. Ingest runs on a schedule (every 4 hours by default or at fixed times). All data lives in a local SQLite database and cached PDFs on a bind-mounted volume. It runs via Docker Compose or a local Python 3.11+ virtual environment with TeX Live installed. The project is a hobby project with rough edges expected.

Should you self-host papernews?

papernews scores 38/100 on selfhost.directory (how scoring works) and ranks #72 of 85 in Feed Reader. It has 165 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.

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

Features

  • Anthropic Claude API support
  • Automatic translation to English
  • Did you know trivia
  • Hacker News aggregation
  • LaTeX PDF generation
  • LLM-powered article rewriting
  • LLM-powered article summarization
  • Offline-first reading
  • On-demand PDF rendering with caching
  • Post-ingest delivery hooks
  • reMarkable/e-ink optimization
  • RSS/Atom Feed Aggregation
  • Scheduled background ingestion
  • World news and quote of the day

papernews README

How to install papernews

Install papernews with Docker Compose

Docker, Docker Compose
Environment variables
LLM_BACKEND, ANTHROPIC_API_KEY, OLLAMA_HOST, OLLAMA_MODEL, INGEST_INTERVAL_SECONDS, INGEST_SCHEDULE, INGEST_TIMEZONE, PAPERNEWS_WORKERS, POST_INGEST_HOOK, POST_INGEST_HOOK_TIMEOUT

git clone https://github.com/marcj/papernews cd papernews cp .env.example .env $EDITOR .env # paste ANTHROPIC_API_KEY=sk-ant-... (or set LLM_BACKEND=ollama) $EDITOR sources.toml # add/remove RSS/HN entries, set per-source limits $EDITOR papernews/template.tex.j2

docker compose up --build -d

Open http://localhost:8000

Requires Docker and Docker Compose

More in Document Processing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…