menu-api
Read Latest Documentation - Browse GitHub Code Repository
Menu AI is an intelligent assistant that helps you eat better by transforming your nutrition plan or fridge contents into recipes, meal plans, grocery lists, and calorie/cost estimations.
This is the API version, focused on PDF parsing, recipe generation, and grocery planning — built using LangGraph, FastAPI, and Streamlit.
- 📄 Upload a nutritionist PDF and extract meals
- 🍲 Generate recipes from meals or ingredients
- 🗓 Select recipes for the week
- 🛒 Generate a grocery list
- 🔢 Estimate calories and price per recipe
| Layer | Tech |
|---|---|
| Backend API | FastAPI |
| AI Orchestration | LangGraph |
| Frontend | Streamlit (MVP) |
| Language | Python 3.10+ |
# 1. Install Poetry (if not installed)
curl -sSL https://install.python-poetry.org | python3 -
# 2. Install dependencies
poetry install
# 3. Run FastAPI backend
poetry run uvicorn app.main:app --reload
# 4. Run Streamlit app (in a separate terminal)
poetry run streamlit run app/streamlit_app.py⸻
📝 TODO (Initial Milestone)
- Integrate LangGraph with FastAPI
- Parse and normalize uploaded PDFs
- Generate recipes from meals
- Build weekly planner and grocery list
⸻
🤝 Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
⸻
📄 License
This project is licensed under the MIT License.
Let me know if you want a Portuguese version too, or to include badges (build passing, license, etc).