Book · a repository

Horizon

Thysrael/Horizon

Not yet reviewedApps

📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达

View on GitHubCompare 12 alternatives How we review projects

Topics

aggregator feishu-bot llm mcp news openclaw python webhook

Understand it first

Don’t install what you can’t explain. Each of these free tools reads Thysrael/Horizon when you swap github.com in its link for another address.

See the architecturegitdiagram.com/Thysrael/Horizon
An interactive diagram of how the parts fit together. Generated by AI.
Read the manualdeepwiki.com/Thysrael/Horizon
A written guide to the codebase, with a chat you can ask questions. Generated by AI.
Browse in an editorgithub.dev/Thysrael/Horizon
Opens the code in VS Code in your browser. Needs a GitHub sign-in. Same as pressing . on any GitHub repo.
Get it as one filegitingest.com/Thysrael/Horizon
The whole project as a single text file to paste into Claude or another assistant. Large repos may not fit in one chat.
Or build it on your computer
npx techandria digest Thysrael/Horizon
Built from the current code, which Techandria hasn’t reviewed. The file says so at the top. Add --only src for part of a large repo.
Let your agent read itgitmcp.io/Thysrael/Horizon
A remote MCP server your agent can connect to and read the docs and code live while it works.
Add it to Claude Code
claude mcp add --transport http horizon-docs https://gitmcp.io/Thysrael/Horizon

The linked sites are independent services, not part of Techandria. They read the default branch as it is now, not the reviewed commit, and AI-written explanations can be wrong. Repository text you paste into an assistant can contain instructions aimed at it, so treat it as data. None of this is a security review.

Install

Not available through Techandria. A application has no Techandria install path. Running an arbitrary program is a different risk from adding a reviewed skill.

You can still get the code from the source and read it yourself:

git clone https://github.com/Thysrael/Horizon

What we checked

Not yet reviewed

Discovery metadata only. Nothing has been scanned or approved, so this is a listing — not a recommendation to run the code.

Nothing has been scanned for this repository yet, so there is nothing to report. Listing here is not permission or a recommendation to run the code.

Maintain this project? Add the review badge to your README

The badge shows this project's current review state and updates on its own — including if the state changes. It links back to this page.

[![Techandria](https://techandria.com/badge/Thysrael/Horizon.svg)](https://techandria.com/project/Thysrael/Horizon)

README

Loading README from GitHub…

🌅 Horizon

Enjoy the News itself. Leave others to Horizon

📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 构建你专属的 AI 新闻雷达

📖 Live Demo · 📋 Configuration Guide · 💬 QQ Group · 简体中文 · 日本語

Screenshots

Ranked Daily Briefing

Context, Summary & Discussion

More Screenshots

Terminal Output	Feishu Notification
Email Delivery	WeChat Delivery

Why Horizon?

Good reads are scattered across feeds, forums, and timelines. Your attention isn't unlimited. Horizon collects, filters, and deduplicates them, then brings the worthwhile ones to you with context and community discussion.

Your taste shapes what you read—and what you want from it. A news story calls for “why it matters”; an engineering deep dive calls for “what I can use.” Horizon's profiles give each kind of content its own scoring criteria and output, for a briefing that feels handpicked.

Features

📡 Bring Your Sources Together — Follow RSS, Hacker News, Reddit, Telegram, X, GitHub, financial news, and more.
🎯 Decide What's Worth Reading — Define scoring rubrics with profiles, set individual thresholds, and merge repeated stories within each profile.
🧩 Give Every Read the Right Treatment — Choose summaries, context, solutions, or takeaways with Markdown prompts and JSON block definitions.
💬 Go Beyond the Headline — Add web-researched background and community discussion where they help explain the story.
⚖️ Make Room for All Your Interests — Cap the briefing's length and each category's share so one busy topic doesn't crowd out the rest.
📬 Read Where You Already Are — Generate English and Chinese briefings as Markdown, publish to Pages, or deliver by email and webhook.

One Briefing, Different Ways to Read

A profile is a reusable set of editorial rules: what belongs, what's worth keeping, and what to write. Built-in examples:

What you follow	Profile	What you get
Technology news	`tech-news`	Events and context, with impact and community discussion when useful
Engineering deep dives	`tech-blog`	Background, solution, and practical takeaways
AI creator material	`ai-creator`	A summary, with timely hooks and content angles when useful

Assign a profile to a source, or let AI choose. Want a different take? Adapt an existing profile—usually without changing Python. Make a profile your own →

How It Works

Editable OmniGraffle source

Profiles define the treatment; runtime settings reflect your reading preferences. Each item routes to one profile. Analysis, filtering, and deduplication happen before enrichment, then the selected items become a briefing grouped by profile.

Run the full pipeline through the CLI, or let an AI assistant call its stages through MCP.

Agent Skill

Let your AI assistant configure sources, customize Profiles, and run Horizon:

npx skills add Thysrael/Horizon --skill horizon -g

Setup and usage · Download Skill ZIP

The command requires Node.js 22.20+. Then ask your assistant to install and configure Horizon, or follow the Quick Start below.

Quick Start

1. Install

Option A: Local Installation

git clone https://github.com/Thysrael/Horizon.git
cd Horizon

# Install with uv (recommended)
uv sync

# Install test/development extras when needed
uv sync --extra dev

# Or with pip
pip install -e .

dev is currently defined as an optional extra in pyproject.toml, so use uv sync --extra dev for pytest and other development dependencies.

If you want the optional OpenBB financial-news source, install its extra too:

uv sync --extra openbb

If openbb pulls packages without wheels on your machine, install the SDK manually with binaries only:

uv pip install --only-binary=:all: openbb openbb-benzinga

Option B: Docker

git clone https://github.com/Thysrael/Horizon.git
cd Horizon

# Optional: build with comma-separated extras before the first run
docker compose build --build-arg EXTRAS=openbb horizon

Full-text extraction with trafilatura is included in the base install. The twitter extra also requires a Playwright browser and system packages, which the current Dockerfile does not install.

2. Configure

Option A: Interactive wizard (recommended)

uv run horizon-wizard

The wizard asks about your interests (e.g. "LLM inference", "嵌入式", "web security") and auto-generates data/config.json. See Interactive Wizard for CLI options.

Eligible ChatGPT subscribers can choose openai-chatgpt to use their plan through Sign in with ChatGPT, without an OpenAI API key.

Option B: Manual configuration

cp .env.example .env          # Add your API keys
cp data/config.example.json data/config.json  # Customize your sources

Minimal manual configuration:

{
  "ai": {
    "provider": "openai",
    "model": "gpt-4",
    "api_key_env": "OPENAI_API_KEY"
  },
  "sources": {
    "rss": [
      {
        "name": "Simon Willison",
        "url": "https://simonwillison.net/atom/everything/",
        "profile": "tech-news"
      }
    ]
  },
  "processing": {
    "profiles_dir": "profiles",
    "default_profile": "tech-news",
    "profile_settings": {
      "tech-news": {
        "threshold": 7.0,
        "topic_dedup": true
      }
    }
  }
}

An explicit source profile uses that profile directly. Omit it or set it to "auto" to let AI match the item against all available profiles. Set it to an array such as ["tech-news", "finance-news"] to restrict AI matching to those profiles. See Processing Profiles for profile structure and behavior.