ARIA

Automated Real-time Intelligence Agent

Your personal AI-powered daily brief on AI, Cybersecurity & Robotics — delivered straight to Telegram.

---

What is ARIA?

ARIA is a fully automated intelligence agent that runs every day on GitHub Actions. It collects the most relevant news from across the web, distills them into a concise Italian-language brief using Google Gemini, and delivers it to your Telegram chat.

No dashboards. No apps. Just a clean daily message with everything you need to know.

How It Works

RSS Feeds + Hacker News API
        |
        v
   [ Fetcher ]  --  Collects & filters articles by keyword relevance
        |
        v
   [ Summarizer ]  --  Sends articles to Gemini 2.5 Flash for synthesis
        |
        v
   [ Notifier ]  --  Delivers the brief to Telegram

1. Fetch — Pulls articles from curated RSS feeds (The Hacker News, Krebs on Security, SANS ISC, IEEE Spectrum) and the top 50 Hacker News stories. Filters by keyword relevance and deduplicates.
2. Summarize — Builds a structured prompt and sends it to Google Gemini 2.5 Flash, which generates a categorized daily brief in Italian covering AI, Cybersecurity, and Robotics.
3. Notify — Sends the summary to a Telegram bot chat, automatically splitting long messages to respect Telegram's 4096-character limit.

Tech Stack

Component	Technology
Language	Python 3.11
AI Model	Google Gemini 2.5 Flash via google-generativeai SDK
News Sources	RSS via feedparser + Hacker News Firebase API
Delivery	Telegram Bot API via requests
Scheduling	GitHub Actions — cron job running daily at 15:00 UTC
Infrastructure	Serverless — no servers, no hosting costs

Project Structure

ARIA/
├── main.py            # Entry point — orchestrates the pipeline
├── fetcher.py         # RSS + Hacker News data collection
├── summarizer.py      # Gemini prompt builder & API integration
├── notifier.py        # Telegram message delivery
├── requirements.txt   # Python dependencies
└── .github/
    └── workflows/
        └── daily.yml  # GitHub Actions scheduled workflow

Setup

1. Create a Telegram Bot

• Talk to @BotFather on Telegram
• Send /newbot and follow the prompts
• Save the bot token
• Send a message to your bot, then visit https://api.telegram.org/bot<TOKEN>/getUpdates to get your chat ID

2. Get a Gemini API Key

• Go to Google AI Studio
• Create a new API key

3. Configure GitHub Secrets

In your repo, go to Settings > Secrets and variables > Actions and add:

Secret	Description
GEMINI_API_KEY	Your Google Gemini API key
TELEGRAM_TOKEN	Your Telegram bot token
TELEGRAM_CHAT_ID	Your Telegram chat ID

4. Deploy

Push to main — the workflow runs automatically every day at 15:00 UTC. You can also trigger it manually from the Actions tab.

License

MIT