openpaper

OpenPaper

A personalized newspaper that knows only you will ever read it.

OpenPaper is a Claude Code plugin that turns any collection of news sources into a single-reader daily newspaper. You point it at URLs, RSS feeds, or topics; it writes Python fetchers that scrape them deterministically, curates the articles to your taste, and renders the result as a broadsheet-style HTML page — complete with blackletter masthead, multi-column grid, halftone images, and animated ink-draw headlines.

There is no server, no account, no feed algorithm optimizing for engagement. Just your sources, your preferences, and a newspaper laid out for one.

How it works

Three stages, each with a clear boundary:

1. Ingest — Add any news source. An agent analyzes the site and writes a standalone Python fetcher. Fetchers import shared utilities from a base module and run without AI on every subsequent invocation — deterministic, fast, auditable.
2. Curate — Claude filters, ranks, and selects articles based on your preference profile. Give feedback ("more climate", "fewer opinion pieces") and the profile sharpens over time.
3. Present — Claude assigns articles to layout slots and renders the edition using a Jinja2 broadsheet template.

Ingestion pipeline

Under the hood, the Ingest stage runs in two phases:

1. Listing — Each fetcher runs in --listing-only mode, outputting article metadata (title, URL, date) without fetching content. RSS and API fetchers skip Playwright entirely in this phase. All fetchers run in parallel.
2. Content — The pipeline deduplicates listings against seen.txt, then batch-fetches full article text for new articles only, using a single shared Playwright browser. Paywall detection, content extraction, and HTML caching are centralized.

This architecture (inspired by TriOnyx newsagg) avoids wasted work: content is only fetched for articles that pass dedup, and the browser only launches when there's something new to fetch.

Data layout

Your data lives in .openpaper/ inside your project:

.openpaper/
├── sources/           # one .py file per source (+ _base.py shared module)
│   ├── _base.py       # shared utilities (deployed by fetch_all.py)
│   ├── hackernews.py
│   ├── bbc.py
│   ├── nrk.py
│   └── ...
├── preferences.md     # your interests + feedback history
├── incoming/          # articles awaiting curation
├── saved/             # archived articles from past editions
├── editions/          # rendered HTML newspapers
├── cache/             # per-source HTML + listing caches
└── seen.txt           # centralized dedup log (URLs)

Install

Requires Claude Code and uv. Playwright's Chromium must be installed once:

uv run playwright install chromium

Standalone (own project)

Clone the repo and start Claude Code inside it:

git clone https://github.com/falense/openpaper.git
cd openpaper
claude

Plugin (inside another project)

Install OpenPaper as a Claude Code plugin to use it from within any project:

claude plugin add https://github.com/falense/openpaper.git

The /openpaper skill and all commands will be available in your project. Your data (sources, editions, preferences) lives in .openpaper/ inside your working directory — not inside the plugin.

Usage

/openpaper

Or just say:

• "Make my paper"
• "Add nrk.no as a news source"
• "Show me the news"
• "I want more climate articles"

On first run, OpenPaper walks you through adding sources, setting preferences, and generating your first edition.

Fetcher types

Each fetcher is a standalone PEP 723 Python script — uv run handles dependencies automatically. See the fetcher guide for the full contract.

Template

A single responsive broadsheet that scales from 375px mobile to 1960px desktop spread. Features UnifrakturCook blackletter masthead, paper grain, halftone image effects, and animated ink-draw headlines.

License

MIT