Unbiased, fact-based global news from 30+ sources across the political spectrum.

1. Fetches articles daily from The Guardian API, NYT API, and 27 RSS feeds spanning international, US, UK, Asia-Pacific, and Global South sources
2. Analyses each article with Claude AI, generating a structured fact-file (event, actors, context, impact, significance, outlook)
3. Synthesises the most globally significant 10 events from all fact-files
4. Displays them in a clean, elegant daily bulletin in your browser

You need one required key and two optional ones:

1. Go to https://console.anthropic.com
2. Sign up / log in
3. Click API Keys → Create Key
4. Copy the key (starts with sk-ant-...)
5. Add credits to your account (billing → $5 minimum)

1. Go to https://open-platform.theguardian.com/access/
2. Click Register for a developer key
3. Fill in the form (free tier available)
4. You'll receive the key by email

1. Go to https://developer.nytimes.com/get-started
2. Create an account and a new App
3. Enable the Article Search API
4. Copy your API key

Note: The app works without Guardian and NYT keys — it will still fetch from all 27 RSS feeds.

pip install -r requirements.txt

Requires Python 3.11+.

macOS / Linux:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
export GUARDIAN_API_KEY="your-guardian-key"   # optional
export NYT_API_KEY="your-nyt-key"             # optional

Windows (Command Prompt):

set ANTHROPIC_API_KEY=sk-ant-your-key-here
set GUARDIAN_API_KEY=your-guardian-key
set NYT_API_KEY=your-nyt-key

Permanent (recommended): Add the export lines to your ~/.bashrc, ~/.zshrc, or use a .env file with python-dotenv.

cd newsfeed
python backend/pipeline.py

cd newsfeed
python server.py

Then open http://localhost:5000

cd newsfeed
python scheduler.py

This runs the pipeline automatically at 06:00 UTC daily and serves the web frontend.

Total: ~$5–12/month at daily use.

newsfeed/
├── backend/
│   ├── fetcher.py       # Fetches from APIs + RSS
│   ├── factfile.py      # Claude fact-file generation
│   ├── synthesiser.py   # Synthesises top 10 events
│   └── pipeline.py      # Orchestrates everything
├── frontend/
│   └── index.html       # Web GUI
├── data/                # Auto-created, stores daily bulletins
├── server.py            # Flask web server
├── scheduler.py         # Daily auto-run + server
└── requirements.txt

• Change topics: Edit TOPICS in fetcher.py
• Add/remove RSS feeds: Edit RSS_FEEDS dict in fetcher.py
• Change refresh time: Edit REFRESH_HOUR_UTC in scheduler.py
• Change number of events: Edit the synthesis prompt in synthesiser.py
• Max articles processed: Edit max_articles in pipeline.py