Inkfeed¶

A curated, self-contained information archiver.

Inkfeed pulls content from multiple news sources — Hacker News, Kagi News, RSS feeds — and archives them into beautifully formatted, offline-readable documents in HTML, Markdown, Gemtext, EPUB, and Sleepscreen formats.

What is Inkfeed?¶

Inkfeed is a Python CLI tool that:

Fetches articles and discussions from configurable news sources
Archives full article content with images embedded locally
Outputs self-contained documents in multiple formats
Organizes everything by date with auto-generated indices

Think of it as your personal newspaper generator — run it daily and you get a tidy archive of the internet's most interesting content.

Key Features¶

Feature	Description
Multi-source	Hacker News, Kagi News, and any RSS feed
Multi-format	HTML, Markdown, Gemtext, EPUB, Sleepscreen
Self-contained	Images downloaded and embedded locally
Configurable	TOML-based configuration for everything
Parallel	Concurrent fetching with configurable worker count
Resilient	Automatic retries on transient failures

Quick Example¶

# Install
pip install -e .

# Run with default config
inkfeed

# Run with custom config
inkfeed my-config.toml

Output lands in output/ organized by format and date:

output/
├── html/
│   └── 2026-02-18/
│       ├── index.html
│       ├── hackernews/
│       └── kaginews/
├── md/
│   └── 2026-02-18/
├── epub/
│   └── 2026-02-18/
└── ...

Ready to get started? Head to the Installation guide.