SuperMealPlanner is a self-hosted meal planner for a household that eats the same food but needs different amounts. It plans four weeks of real food around the cook's calendar, sizes every plate to each person's own targets, writes the shopping list for your supermarket, and runs a Telegram bot for the family group.
- One recipe, one pot, a plate per person: quantities scale to each person's calorie target.
- A 4-week plan, batch-cooked on free afternoons read from a private iCal address.
- Weekly rules: legumes, fish, oily fish, a salad every day, no dish repeated too often.
- Shopping list per store, with the real product, packs to buy and an estimated total. Ticks are shared by every phone, and «I have it» leaves an ingredient off until you put it back.
- A tasks page with each day's defrost, batch and shopping jobs, and 👍/👎 on every dish that the next menus follow.
- Targets that follow each person's weight trend, with floors and doctor flags.
- GLP-1 aware: lighter dishes and smaller plates in the days after a weekly injection.
- Telegram bot: today's plates, the week, the list, logging, reminders, voice notes, photos, videos and any file. Always answers in private, and in the group when you mention it or reply to it. A voice note, a photo or a file is always answered.
- Talk to the same bot from a phone by voice (an iOS Shortcut, say):
POST /api/v1/chef, and it answers in spoken sentences, changes included (the app API). - An assistant that remembers the conversation: one ongoing conversation per chat,
/newto start over. - Change the menu from the chat: another dish for a day, two days swapped, a pause while you eat what is at home, the whole menu moved a week later, a new draw from a Monday. Each one can be undone.
- Change settings from the chat: reminders, batch days, guests, foods to avoid and more, saved as a git commit you can revert. It can also change a recipe you already have and keep notes about each person. What you ask for is done at once; what the assistant suggests waits for your yes. When it tells you to do something at a time, it offers a reminder here or in your calendar, with buttons, and does nothing if you do not answer.
- An iOS app for the family, and a JSON API for anyone else's client: a code from the bot pairs a phone, the token lives in its keychain, and the app and the web page share one plan, one shopping list and one set of ticks (docs/api.md).
- Bring your own AI: any OpenAI-compatible endpoint, Anthropic, or a plugin file that can keep the conversation.
- Every string is translatable; English and Spanish ship today.
- The assistant reads the shared assistant principles first, in English or Spanish (
supermealplanner/principles/): twelve rules on whom it answers, buttons, offers, privacy and honest results. The app's own rules after them only add what is specific to meal planning. The files are copied unchanged from the shared text, and a test pins their hashes.
git clone https://github.com/GeiserX/SuperMealPlanner && cd SuperMealPlanner
uv run smp --data ./my-household plan --start 2026-10-12 --no-calendar --write
docker run -p 8080:8080 -v "$PWD/my-household:/data" drumsergio/supermealplanner:0.7.4Open http://localhost:8080 and add it to your phone's home screen. The data folder holds household.yaml, ingredients.yaml and recipes/; the full format, with a complete example, is in docs/data-format.md. Keep that folder in a private repository: it holds health details.
- Data format: every file in the data folder, settings, store catalogues, reminders, AI and bot
- How it works: the planner, portions, targets, the bot
- The app API: pairing a phone, every route, and how to expose it without opening the pages
SuperMealPlanner helps you plan and cook. It does not treat any condition, eating disorders included. It never changes a medication and never cuts food after a binge. Targets and rules come from the household file you write: check them with your clinician.