v0.1.0 · MIT Licensed

Track. Discover.
Understand.

A CLI-powered recommendation engine for topics you care about. Fetch news, generate AI summaries, and refine recommendations through feedback.

Get Started View on GitHub
$ pip install git+https://github.com/yanndebray/voynich.git

Features

Your Personal News Curator

Build a constellation of content around topics you care about. Let AI help you stay informed.

Topic Tracking

Define topics of interest with custom keywords. Track the Voynich manuscript, emerging technologies, specific people, or any subject that matters to you.

News Fetching

Pull the latest articles from NewsAPI. Stay current with real-time news across your topics, automatically deduplicated and stored locally.

AI Summaries

Generate intelligent summaries with OpenAI. Each summary explains why the article matters for your specific topic of interest.

Feedback Loop

Like or dislike articles to refine future recommendations. Your feedback shapes what surfaces next, creating a personalized news experience.

Local Storage

SQLite database stored in your home directory. No cloud dependency, no account required. Your data stays on your machine.

CLI Interface

Beautiful terminal interface powered by Rich and Typer. Interactive reading sessions, formatted tables, and intuitive commands.

Quick Start

Up and Running in Seconds

Add a topic, fetch articles, and start reading. It's that simple.

# Install voynich from GitHub
$ pip install git+https://github.com/yanndebray/voynich.git

# Add a topic you're interested in
$ voynich topic add "Voynich manuscript"
✓ Added topic 'Voynich manuscript' (id: 1)

# Fetch the latest articles
$ voynich fetch
Fetching articles for 1 topic(s)...
✓ Voynich manuscript: 5 new article(s)

# View your daily digest
$ voynich digest
# Fetch with AI-generated summaries (requires OPENAI_API_KEY)
$ voynich fetch --summarize
Fetching articles for 1 topic(s)...
✓ Voynich manuscript: 3 new article(s)

# Start an interactive reading session
$ voynich read

# Each article shows:
# - Title and source
# - AI summary explaining relevance to your topic
# - Options: like, skip, dislike, or quit

CLI Reference

The voynich Command

A complete toolkit for personalized news discovery.

voynich topic add Add a new topic of interest. Use --keywords to specify custom search terms different from the topic name.
voynich topic list List all your tracked topics with their keywords and creation dates in a formatted table.
voynich fetch Fetch latest articles for all topics from NewsAPI. Use --summarize to generate AI summaries, --limit to control count.
voynich digest Display today's recommended articles in a clean table format. Shows unread articles across all topics.
voynich read Interactive reading session. Review articles one by one, generate summaries on demand, and provide feedback (like/dislike).
voynich stats View feedback statistics per topic. See how many articles you've liked to understand your preferences.
"
The most beautiful thing we can experience is the mysterious. It is the source of all true art and science.
— Albert Einstein

Configuration

Environment Setup

Configure your API keys to unlock the full potential of voynich.

# Required: Get your free API key from newsapi.org
NEWS_API_KEY=your_newsapi_key_here

# Optional: For AI-powered summaries
OPENAI_API_KEY=your_openai_key_here