How mrbill700/weekly-meal-plan works
This repository is a scheduled weekly dinner-planning emailer, with an optional podcast publisher. The main workflow gathers and filters recipes from configured blogs, samples them for the week, uses an AI model plus household rules and meal history to create a plan and grocery list, emails the result, and records meals for future rotation and ratings. The podcast turns recorded meals into spoken episodes for a separate public site. The main implementation is concentrated in two Python files; finer internal divisions reflect documented capabilities, not separate modules. Several links are supported by the README because implementation excerpts are incomplete.
Main entry points: meal_planner.py Planner runtime · podcast.py Podcast publisher
Components 19
Meal planning
- Planner runtime
meal_planner.py - Recipe catalog
meal_planner.py - Dinner filtering
meal_planner.py - Weekly sample
meal_planner.py - History and ratings
meal_planner.py - Plan generation
meal_planner.py - Store grocery list
meal_planner.py
Email and history
- Email rendering
meal_planner.py - Meal history
meal_planner.py
Podcast publishing
- Podcast publisher
podcast.py - Episode script
podcast.py - Voice and audio
podcast.py
Other components
- Household
- Recipe blogs
- Gmail SMTP
- Claude API
- OpenRouter API
- Public podcast site
- Podcast listener
Connections 21
- Household → Planner runtime: configures
README.md - Planner runtime → Recipe blogs: fetches sitemaps
README.md - Planner runtime → Recipe catalog: builds catalog
README.md - Planner runtime → Dinner filtering: filters recipes
README.md - Planner runtime → Weekly sample: samples recipes
README.md - Planner runtime → History and ratings: loads history
meal_planner.py - Planner runtime → Plan generation: generates plan
meal_planner.py - Plan generation → Claude API: requests plan
README.md - Plan generation → OpenRouter API: retries on error
README.md - Planner runtime → Store grocery list: builds list
README.md - Planner runtime → Email rendering: renders email
README.md - Email rendering → Gmail SMTP: sends email
README.md - Planner runtime → Meal history: records meals
README.md - Meal history → History and ratings: feeds rotation
README.md - Meal history → Podcast publisher: provides latest meals
podcast.py - Podcast publisher → Episode script: writes script
podcast.py - Episode script → Claude API: requests script
podcast.py - Episode script → OpenRouter API: tries fallback
podcast.py - Podcast publisher → Voice and audio: generates audio
podcast.py - Voice and audio → Public podcast site: publishes episode
podcast.py - Public podcast site → Podcast listener: serves feed