GitHub Trending Monitor

Watches GitHub's trending pages across multiple languages, alerts on new repo entries and star-count spikes. Maps to "AI tool intelligence / tech-stack monitoring / competitive lead-gen for tooling startups" briefs.

Built 2026-05-03 as Demo #5 in the path-to-100 portfolio gallery. Pattern generalizes to any "list of projects / posts / news" page (Hugging Face trending, Product Hunt, Hacker News, IndieHackers).

Run

cd ~/freelance/portfolio_demos/github_trending_monitor
. ~/freelance/.venv/bin/activate
python monitor.py --reset
python monitor.py --once                 # baseline
python monitor.py --simulate-changes 4   # demo
python monitor.py --once                 # diff fires

Result (verified)

• 37 trending repos extracted across Python + General + TypeScript ✅
• 0 changes on idempotent re-run ✅
• 4 simulated star_total changes detected and reported ✅

Tech

• Built from _template/scaffold.py — drop-in, ~10 minutes to spec
• Tenacity retry + idempotent state + diff alerts
• Schema: name (owner/repo) + url + description + language + stars_total + stars_today + forks_total