It is a Streamlit-based application designed to assist users in managing their recipes, grocery lists, and ingredients using AI agents. It also provides a recipe assistant for generating recipes and cooking tips.
- Ingredients Manager: Add, view, and manage your ingredients.
- Recipe AI Assistant: Generate recipes based on available ingredients and get cooking tips.
- Grocery List Generator: Create a grocery list from a recipe.
- Favorites: Save and manage your favorite recipes.
-
Clone the repository:
git clone https://github.com/your-repo/homechef.git cd homechef -
Create and activate a virtual environment:
python -m venv .venv .\.venv\Scripts\activate # On Windows source .venv/bin/activate # On macOS/Linux ~/homechef-venv/Scripts/Activate.ps1
-
Install the required dependencies:
pip install -r requirements.txt
-
Run the Streamlit app:
streamlit run frontend/app.py
-
Open your browser and navigate to:
- Local URL:
http://localhost:8501 - Network URL:
http://<your-network-ip>:8501
- Local URL:
Manage your ingredients by adding, viewing, and removing items.
Generate a grocery list based on your recipe text.
Generate recipes based on available ingredients using AI.
Get AI-generated help for any cooking-related questions or tips.
homechef-project/
│
├── frontend/
│ ├── app.py # Main Streamlit app
│ ├── api_client.py # API client for backend communication
│ ├── config.py # Configuration file for API endpoints
│ ├── data/ # Data files (e.g., ingredients, favorites)
│ ├── pages/ # Streamlit pages
│ │ ├── favorites_page.py
│ │ ├── grocery_list_page.py
│ │ ├── ingredients_page.py
│ │ ├── recipe_assistant_page.py
│ │ └── recipe_page.py
│
├── requirements.txt # Python dependencies
├── README.md # Project documentation
└── ...
- Python 3.9+
- Streamlit
- FastAPI
- LangChain
- Other dependencies listed in
requirements.txt
Contributions are welcome! Feel free to open issues or submit pull requests.
This project is licensed under the MIT License. See the LICENSE file for details.
Happy cooking with HomeChef! 🍳