AI News Agent

An autonomous Python agent that scans the web daily for the latest LLM, AI tools, and agentic AI content, then sends a beautifully formatted email digest to your Gmail.

Features

• 📰 Multi-Source Aggregation: ArXiv papers, NewsAPI, RSS feeds, Hacker News, Reddit, YouTube, Product Hunt, Hugging Face
• 🤖 AI-Powered Summaries: Uses LLM for intelligent content summarization
• 🔄 Smart Deduplication: Removes duplicate articles across sources
• 📧 Beautiful Email Digests: Mobile-responsive HTML emails
• ⏰ Daily Scheduling: Configurable send time (Default: 2-day lookback)
• 📡 Robust Source Support: Automated fetching from AI based YouTube channels

Quick Start

1. Install Dependencies

cd ai-news-agent
pip install -r requirements.txt

2. Configure Environment

cp .env.example .env
# Edit .env with your API keys

3. Configure Email (Simple SMTP)

1. Enable 2-Factor Auth on your Google account (https://myaccount.google.com/security)
2. Get an App Password:
   • Go to: https://myaccount.google.com/apppasswords
   • Select "Mail" and generate
   • Copy the 16-character password
3. Update .env:

   RECIPIENT_EMAIL=your.email@gmail.com
   SMTP_EMAIL=your.email@gmail.com
   SMTP_PASSWORD=your-app-password

4. First Run

python agent.py

5. Schedule Daily Runs

Option A: Using the built-in scheduler

python scheduler.py

Option B: Using system cron (Linux/Mac)

# Edit crontab
crontab -e

# Add this line for 8:00 AM daily
0 8 * * * cd /path/to/ai-news-agent && python agent.py

Configuration

Edit .env file:

# Required
RECIPIENT_EMAIL=your.email@gmail.com

# Optional - for LLM summaries
OPENAI_API_KEY=sk-...
# OR
GEMINI_API_KEY=...

# Optional - for more news sources
NEWS_API_KEY=...

# Schedule (24-hour format)
SEND_TIME=08:00

Usage

# Run once (sends email immediately)
python agent.py

# Dry run (preview without sending)
python agent.py --dry-run

# Run with scheduler (ongoing)
python scheduler.py

Project Structure

ai-news-agent/
├── config/
│   ├── settings.py          # Configuration management
│   └── credentials/          # OAuth tokens (gitignored)
├── sources/
│   ├── arxiv_source.py       # ArXiv research papers
│   ├── newsapi_source.py     # NewsAPI.org integration
│   ├── rss_source.py         # RSS feed parser
│   └── hackernews_source.py  # Hacker News API
├── processing/
│   ├── deduplicator.py       # Remove duplicate articles
│   └── summarizer.py         # AI-powered summarization
├── email_client/
│   ├── gmail_client.py       # Gmail API OAuth2 client
│   └── templates/
│       └── digest.html       # HTML email template
├── agent.py                  # Main orchestrator
├── scheduler.py              # Daily scheduling
└── requirements.txt

☁️ Cloud Deployment (Daily Digests Without Your Laptop)

The easiest way to run daily digests automatically is GitHub Actions - completely free!

Step 1: Push to GitHub

cd /Applications/AntigravityProjects/ai-news-agent
git init
git add .
git commit -m "Initial commit"
gh repo create ai-news-agent --private --push

Step 2: Add Secrets

Go to your GitHub repo → Settings → Secrets and variables → Actions → New repository secret

Add these secrets:

Secret Name	Value
RECIPIENT_EMAIL	your.email@gmail.com, friend@example.com
SMTP_EMAIL	your.email@gmail.com
SMTP_PASSWORD	your-app-password
NEWS_API_KEY	your-newsapi-key

Note: To send to multiple people, just separate emails with commas in RECIPIENT_EMAIL.

Step 3: Done!

The workflow runs daily at 8:00 AM IST. You can also trigger it manually from the Actions tab.

---

Troubleshooting

Error: refusing to allow a Personal Access Token to create or update workflow This means your GitHub token is missing permissions.

1. Go to Settings → Developer Settings → Personal access tokens (Tokens (classic))
2. Generate new token
3. Crucial: Check the workflow checkbox (and repo)
4. Use this new token as your password when pushing

---

License

MIT