Note: This project is built for Luis's personal use to create a daily newspaper for his family. You're welcome to fork it and adapt it for your own needs!

A daily 2-page newspaper for bright children (ages 10-14) that transforms positive news content from Fix The News into engaging, print-ready reading material.

Mission: Counter ambient negative news with evidence of human progress, formatted as a traditional black-and-white newspaper optimized for home printing.

• 📰 2-page daily newspaper (front and back)
• 🖨️ High-contrast black & white design for easy home printing
• 📱 QR codes linking to original sources for verification
• 🎯 Age-appropriate content for 10-14 year olds
• 🤖 Powered by Claude AI for content adaptation
• 🏀 Duke basketball game schedules automatically included
• 📅 Mon-Thu editions with themed content each day

# Clone and setup
git clone https://github.com/tieguy/News-Fixed.git
cd News-Fixed

# Install dependencies using uv
curl -LsSf https://astral.sh/uv/install.sh | sh  # Install uv if needed
uv sync

# Install Firefox browser for Playwright (required for fetching FTN content)
uv run playwright install firefox

# Configure
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY from https://console.anthropic.com/

# Complete workflow (fetch, parse, and generate all 4 days):
./news-fixed run https://fixthenews.com/latest

# PDFs will be in output/ directory

The news-fixed wrapper automatically uses uv run to manage the Python environment:

# Fetch, parse, and generate all 4 days in one command:
./news-fixed run https://fixthenews.com/latest

# 1. Fetch latest Fix The News issue
./news-fixed fetch https://fixthenews.com/latest

# 2. Parse HTML to JSON
./news-fixed parse data/raw/FTN-317.html

# 3. Curate stories (NEW - interactive review and categorization)
python code/src/curate.py data/processed/ftn-317.json
# Creates data/processed/ftn-317-curated.json
# Interactive CLI to fix auto-categorization, move stories, swap main/mini

# 4. Generate PDFs (all 4 days)
./news-fixed generate data/processed/ftn-317-curated.json --all

# Or generate single day
./news-fixed generate data/processed/ftn-317-curated.json --day 1

# Skip AI rewriting (faster, uses content as-is)
./news-fixed generate data/processed/ftn-317-curated.json --all --no-rewrite

See docs/CURATION.md for detailed curation guide.

# Generate test newspaper with sample data (no API calls)
./news-fixed test

On your first fetch, you'll need to log in:

./news-fixed fetch https://fixthenews.com/latest --no-headless
# Browser opens - log in with your Substack credentials
# Press Enter in terminal when done

Subsequent fetches will use your saved session automatically.

News-Fixed/
├── news-fixed                # Unified wrapper script (start here!)
├── README.md                 # This file
├── CLAUDE.md                 # AI assistant guidance
├── code/                     # Python source code
│   ├── src/                  # Core modules
│   │   ├── fetch_ftn_clean.py   # Fetch FTN content
│   │   ├── ftn_to_json.py       # Parse HTML to JSON
│   │   ├── parser.py            # Story categorization
│   │   ├── curator.py           # Interactive story curation
│   │   ├── generator.py         # Claude API integration
│   │   ├── pdf_generator.py     # PDF generation (WeasyPrint)
│   │   ├── sports_schedule.py   # Duke basketball schedules
│   │   ├── utils.py             # QR codes, date helpers
│   │   ├── curate.py            # Interactive curation CLI
│   │   └── main.py              # PDF generator
│   ├── templates/            # HTML/CSS newspaper templates
│   └── prompts/              # Claude API prompt templates
├── data/
│   ├── raw/                  # FTN HTML downloads
│   ├── processed/            # Parsed JSON files
│   ├── sports/               # Basketball schedules (ICS files)
│   └── calendar/             # Family calendar events
├── output/                   # Generated PDFs
├── docs/                     # Detailed documentation
└── .venv/                    # Python virtual environment (managed by uv)

This project uses beads for distributed issue tracking.

bd ready             # See actionable tasks
bd list              # View all issues
bd create "title"    # Create new issue

Each daily edition contains:

Page 1 (Front)

• Lead story (400-500 words)
• Feature box (Duke basketball games or quick wins)
• Tomorrow teaser (Mon-Wed only)

Page 2 (Back)

• 4-6 mini articles (100-150 words each)
• "By The Numbers" statistics section
• Footer with positive messaging

• Monday (Day 1): Health & Education
• Tuesday (Day 2): Environment & Conservation
• Wednesday (Day 3): Technology & Energy
• Thursday (Day 4): Society & Youth Movements

• Quick Start: This README
• AI Assistance: CLAUDE.md
• Documentation Index: docs/INDEX.md
• Fetching Guide: docs/FETCHING.md
• Curation Guide: docs/CURATION.md
• Design Spec: docs/design-spec.md

• Python 3.8+
• Anthropic API key (for Claude AI content rewriting)
• Fix The News subscription (for content)
• Firefox (installed via Playwright)

Blue Oak Model License 1.0.0 - A modern, permissive open source license written in plain English.

This project is REUSE 3.3 compliant. All files contain clear copyright and licensing information.