Skip to main content

genaiforgenews

AI curates the tech news. You just read.

Python License uv Daily Summary GitHub commit activity PRs Welcome Sources Welcome

Claude GPT Gemini DeepSeek Doubao MiniMax OpenClaw

genaiforgenews collects news from multiple customizable sources, uses AI to score and filter them, and generates a daily briefing — complete with summaries, community discussions, and background explanations in English and/or Hindi.

📖 Live Demo · 📋 Configuration Guide · हिंदी

Screenshots

Daily Overview

Daily Overview

News Detail

News Detail
Terminal Output

Terminal Output

Features

  • 📡 Multi-Source Aggregation — Collects from Hacker News, RSS feeds, Reddit, Telegram channels, and GitHub (releases & user events)
  • 🤖 AI-Powered Scoring — Uses Claude, GPT-4, Gemini, DeepSeek, Doubao, MiniMax, or any OpenAI-compatible API to rate each item 0-10, filtering out the noise
  • 🌐 Bilingual Summaries — Generates daily reports in English and/or Hindi (hi in config)
  • 🔍 Content Enrichment — Searches the web to provide background knowledge for unfamiliar concepts
  • 💬 Community Voices — Collects and summarizes discussions from comments on HackerNews, Reddit, etc.
  • 🔗 Cross-Source Deduplication — Merges duplicate items from different platforms automatically
  • 📧 Email Subscription — Self-hosted newsletter system (SMTP/IMAP) that handles "Subscribe" requests automatically
  • 📝 Static Site Generation — Deploys as a GitHub Pages site via GitHub Actions, updated on a schedule
  • ⚙️ Fully Configurable — Single JSON config file, easy to customize sources, thresholds, and AI providers
  • 🧙 Setup Wizard — Interactive CLI that recommends sources based on your interests, with a curated preset library open to community contributions

How It Works

              ┌──────────┐
              │ Hacker   │
┌─────────┐   │ News     │   ┌──────────┐   ┌──────────┐   ┌──────────┐
│  RSS    │──▶│ Reddit   │──▶│ AI Score │──▶│ Enrich   │──▶│ Summary  │
│ Telegram│   │ GitHub   │   │ & Filter │   │ & Search │   │ & Deploy │
└─────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘
  Fetch from      Merge &        Score          Web search     Generate
  all sources    deduplicate     0-10 each      background     Markdown &
                                & filter        knowledge      deploy site
  1. Fetch — Pull latest content from all configured sources concurrently
  2. Deduplicate — Merge items pointing to the same URL across different platforms
  3. Score — AI rates each item 0-10 based on technical depth, novelty, and impact
  4. Filter — Keep only items above your configured threshold (default: 6.0)
  5. Enrich — For high-scoring items, search the web for background context and collect community discussions
  6. Summarize — Generate a structured Markdown report with summaries, tags, and references
  7. Deploy — Optionally publish to GitHub Pages as a daily-updated static site

Quick Start

1. Install

Option A: From PyPI (quickest)

Install from PyPI and use a dedicated working directory (the app reads ./data/ and .env from your current folder):

pip install genaiforgenews
mkdir ~/my-genaiforgenews && cd ~/my-genaiforgenews
# Add API keys to .env (see .env.example in the repo)
genaiforgenews-wizard   # writes data/config.json
genaiforgenews

Full notes for pip users and maintainer publishing steps (build, TestPyPI, Twine) are in docs/PYPI.md.

Option B: Local installation (git clone)

git clone https://github.com/vikas972/genAINews.git
cd genAINews

# Install with uv (recommended)
uv sync

# Or with pip (editable)
pip install -e .

Option C: Docker

git clone https://github.com/vikas972/genAINews.git
cd genAINews

# Configure environment
cp .env.example .env
cp data/config.example.json data/config.json
# Edit .env and data/config.json with your API keys and preferences

# Run with Docker Compose
docker compose run --rm genaiforgenews

# Or run with custom time window
docker compose run --rm genaiforgenews --hours 48

2. Configure

Option A: Interactive wizard (recommended)

uv run genaiforgenews-wizard

The wizard asks about your interests (e.g. "LLM inference", "嵌入式", "web security") and auto-generates data/config.json from a curated preset library + optional AI recommendations.

Option B: Manual configuration

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

Here's what a config looks like:

{
  "ai": {
    "provider": "openai",       // or "anthropic", "gemini", "doubao", "minimax"
    "model": "gpt-4",
    "api_key_env": "OPENAI_API_KEY",   // env var NAME only; put the secret in .env (e.g. GOOGLE_API_KEY for Gemini)
    "languages": ["en", "hi"]   // English + Hindi output
  },
  "sources": {
    "hackernews": { "enabled": true, "fetch_top_stories": 20, "min_score": 100 },
    "rss": [
      { "name": "Simon Willison", "url": "https://simonwillison.net/atom/everything/" }
    ],
    "reddit": {
      "subreddits": [{ "subreddit": "MachineLearning", "sort": "hot" }],
      "fetch_comments": 5
    },
    "telegram": {
      "channels": [{ "channel": "zaihuapd", "fetch_limit": 20 }]
    }
  },
  "filtering": {
    "ai_score_threshold": 6.0,
    "time_window_hours": 24
  }
}

For the full reference, see the Configuration Guide.

3. Run

Local Installation

uv run genaiforgenews           # Run with default 24h window
uv run genaiforgenews --hours 48  # Fetch from last 48 hours

With Docker

docker compose run --rm genaiforgenews           # Run with default 24h window
docker compose run --rm genaiforgenews --hours 48  # Fetch from last 48 hours

The generated report will be saved to data/summaries/.

4. Automate (Optional)

genaiforgenews works great as a GitHub Actions cron job. See .github/workflows/daily-summary.yml for a ready-to-use workflow that generates and deploys your daily briefing to GitHub Pages automatically.

Supported Sources

Source What it fetches Comments
Hacker News Top stories by score Yes (top N comments)
RSS / Atom Any RSS or Atom feed —
Reddit Subreddits + user posts Yes (top N comments)
Telegram Public channel messages —
GitHub User events & repo releases —

MCP Integration

genaiforgenews ships with a built-in MCP server so AI assistants can drive the pipeline programmatically.

# Start the MCP server (stdio mode)
uv run genaiforgenews-mcp

Available tools include hz_validate_config, hz_fetch_items, hz_score_items, hz_filter_items, hz_enrich_items, hz_generate_summary, and hz_run_pipeline.

See src/mcp/README.md for the full tool reference and src/mcp/integration.md for client setup.

Roadmap

  • Multi-source aggregation (HN, RSS, Reddit, Telegram, GitHub)
  • AI scoring with multiple providers
  • Bilingual summary generation (EN/HI)
  • Web search for background enrichment
  • Community discussion collection
  • GitHub Pages deployment
  • Email Subscription (SMTP/IMAP automated newsletter)
  • Docker deployment support
  • MCP server integration
  • Web UI dashboard
  • Setup Wizard — interactive CLI that recommends sources based on user interests
  • Improved Web UI — better digest and article detail experience
  • Slack / Webhook notification
  • More source types (Twitter/X, Discord, etc.)
  • Custom scoring prompts per source

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

Contribute Source Presets

genaiforgenews's setup wizard uses a community-maintained preset library to recommend sources. We'd love your help expanding it!

  1. Fork this repo
  2. Add your sources to data/presets.json (provide both English and Hindi description / description_hi where useful)
  3. Submit a PR

Great candidates: niche RSS feeds, active subreddits, notable GitHub accounts, or Telegram channels in your area of expertise.

Acknowledgements

  • Special thanks to LINUX.DO for providing a promotion platform.
  • Special thanks to HelloGitHub for valuable guidance and suggestions.

License

MIT

Metadata

Release files for genaiforgenews 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for genaiforgenews 0.1.1
File Size Uploaded Provenance Actions
genaiforgenews-0.1.1.tar.gz 61.8 kB Without provenance Details for genaiforgenews-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for genaiforgenews 0.1.1
File Interpreter ABI Platform Actions
genaiforgenews-0.1.1-py3-none-any.whl Python 3 none any Details for genaiforgenews-0.1.1-py3-none-any.whl

Total release size: 135.5 kB

Release files / genaiforgenews-0.1.1.tar.gz

Download URL genaiforgenews-0.1.1.tar.gz
Size 61.8 kB
Tags Source
SHA-256 checksum
How to use checksums
23d5f27ccd3816eaa2ca4a3f379bb4c3b25053bde6e78ff5f15617618562d0d2
BLAKE2b-256 checksum
How to use checksums
705ac8541d0f585a3ff1518b32deca102418b1f5dd3f08e7a6afdc6743e69195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.4

Release files / genaiforgenews-0.1.1-py3-none-any.whl

Download URL genaiforgenews-0.1.1-py3-none-any.whl
Size 73.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7e95603e9d18f902a2089a5c837cb5784e53c1c10ffb146dcdf9c65622ac076a
BLAKE2b-256 checksum
How to use checksums
9218b4c24b2c35581205de4a79bd4bff847bedeaf95f561363d95ae010e0804a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.4

Security for genaiforgenews 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page