whatisgithub

What is kobo-news?

morgan98800/kobo-news — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A personal script that curates daily EU policy news with AI and sends it to Instapaper for offline reading on a Kobo e-reader.

Mindmap

mindmap
  root((Kobo News))
    What it does
      Curates EU policy news
      Syncs to Instapaper
      Deletes old articles
    Tech stack
      Python
      Gemini API
      GitHub Actions
    Use cases
      Offline reading on Kobo
      Automated daily digest
    Audience
      Personal news readers
      EU policy followers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically curate EU policy news each morning and read it offline on a Kobo e-reader.

USE CASE 2

Schedule a free daily news sync using GitHub Actions instead of running a computer around the clock.

USE CASE 3

Use an AI model to pick the most relevant articles from multiple news sources automatically.

USE CASE 4

Clean up Google News redirect links so articles point directly to the publisher.

What is it built with?

PythonGemini APIInstapaperGitHub Actions

How does it compare?

morgan98800/kobo-news0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an Instapaper account and, for standalone mode, a Gemini API key.

So what is it?

Kobo News is a personal script that collects the top EU policy news stories and sends them to Instapaper so they can be read offline on a Kobo e-reader. To keep things tidy, it automatically deletes articles that are older than two days. The script pulls news from several sources at once, including Politico Europe, Euractiv, and a Google News search for EU policy topics. It also cleans up the tracking links that Google News uses so each article points straight to the original publisher's page instead of a redirect. Article selection can work in two ways. In agent mode, a tool called Antigravity picks the best articles using its own Gemini model, so no personal Gemini API key is required. In standalone mode, the script uses your own Gemini API key to choose the top five articles itself. If no AI model or API key is available at all, it simply falls back to picking the most recent or relevant stories by default, so the script keeps working either way. Setup involves creating a Python virtual environment, installing the listed dependencies, and filling in an environment file with Instapaper login details and, optionally, a Gemini API key. Once configured, the script can be run manually with a single command, either to auto curate articles or to sync a specific list of URLs. For scheduling, the README lists several options: running it automatically every morning through GitHub Actions in the cloud, using the Antigravity agent's own scheduler, setting up a local crontab entry on macOS, or creating a macOS launchd background agent that still runs the job even after the computer wakes from sleep. The README describes this as a personal project rather than a polished public tool.

Copy-paste prompts

Prompt 1
Help me set up Kobo-news with my own Instapaper account and Gemini API key.
Prompt 2
Show me how to configure the GitHub Actions workflow in Kobo-news to run every morning.
Prompt 3
Explain how the standalone mode versus agent mode works in this script.
Prompt 4
Help me adapt this script to curate a different news topic instead of EU policy.

Frequently asked questions

What is kobo-news?

A personal script that curates daily EU policy news with AI and sends it to Instapaper for offline reading on a Kobo e-reader.

What language is kobo-news written in?

Mainly Python. The stack also includes Python, Gemini API, Instapaper.

How hard is kobo-news to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is kobo-news for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.