Horizon  by Thysrael

Automated AI news aggregation and summarization tool

Created 3 weeks ago

New!

744 stars

Top 46.6% on SourcePulse

GitHubView on GitHub
Project Summary

🌅 Horizon: AI-Powered News Aggregator & Summarizer

Horizon addresses the challenge of information overload in the tech news landscape by automating the aggregation, filtering, and summarization of content. It targets engineers, researchers, and power users who require curated, digestible daily briefings. The primary benefit is efficient consumption of relevant AI and tech news, complete with context and community insights, in both English and Chinese.

How It Works

Horizon employs a multi-stage pipeline. It fetches content concurrently from diverse sources like Hacker News, RSS feeds, Reddit, Telegram channels, and GitHub. Items are deduplicated across platforms. AI models (including Claude, GPT-4, Gemini, DeepSeek, Doubao, or any OpenAI-compatible API) then score each item from 0-10, filtering out noise based on configurable thresholds. High-scoring items are enriched with web searches for background knowledge and summaries of relevant community discussions. Finally, a structured Markdown report is generated, optionally deployed as a static site.

Quick Start & Requirements

  • Installation: Clone the repository and install dependencies using uv sync or pip install -e ..
  • Prerequisites: Python 3.11+ is required. API keys for chosen AI providers (e.g., OPENAI_API_KEY) must be configured in a .env file.
  • Configuration: Customize sources, AI models, and thresholds via data/config.json.
  • Execution: Run using uv run horizon for a 24-hour window or uv run horizon --hours <N> for a custom duration.
  • Automation: A GitHub Actions workflow (.github/workflows/daily-summary.yml) facilitates scheduled generation and deployment to GitHub Pages.
  • Resources: Live Demo: https://thysrael.github.io/Horizon/. Configuration Guide: https://thysrael.github.io/Horizon/configuration.

Highlighted Details

  • Multi-Source Aggregation: Integrates Hacker News, RSS/Atom feeds, Reddit, Telegram channels, and GitHub events/releases.
  • AI-Powered Filtering: Leverages multiple LLMs for intelligent scoring and noise reduction.
  • Bilingual Output: Generates daily summaries in both English and Chinese.
  • Content Enrichment: Automatically searches for background context and summarizes community discussions.
  • Static Site Deployment: Built-in support for deploying generated reports via GitHub Actions.
  • Email Subscription: Includes a self-hosted newsletter system.

Maintenance & Community

The project shows active development, indicated by commit activity. Contributions are welcomed via issues and pull requests. No explicit community channels (e.g., Discord, Slack) are listed.

Licensing & Compatibility

The project is released under the MIT license. This permissive license allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The roadmap indicates planned features such as Slack/Webhook notifications and expanded source types (e.g., Twitter/X, Discord) are not yet implemented. Users must manage API keys and configure AI providers for core functionality.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
10
Issues (30d)
5
Star History
751 stars in the last 21 days

Explore Similar Projects

Feedback? Help us improve.