A web application that generates creative recipes based on user-provided ingredients, powered by AI.
- Ingredient-based Recipe Generation: Enter a list of ingredients, and the app creates a recipe for you.
- Modern UI: Built with React, TypeScript, and Tailwind CSS.
- Fast Backend: Flask API with AI (Groq) integration to generate recipes in real time.
- Error Handling: User-friendly messages for invalid input and API errors.
- Responsive Design: Works on both desktop and mobile.
- Frontend: React, TypeScript, Vite, Tailwind CSS
- Backend: Python, Flask, Groq API, Gunicorn
- Other Tools: Docker, ESLint
- Node.js (>=18)
- Python 3.8+
- Docker (optional, for containerized setup)
git clone https://github.com/NeuralNomad081/recipe.git
cd recipe-
Go to the backend directory:
cd backend -
Create a
.envfile and add your Groq API key:GROQ_API_KEY=your-groq-api-key -
Install dependencies:
pip install -r requirements.txt
-
Run the Flask server:
python app.py
The API will run on
http://localhost:5000.
-
Go to the frontend directory:
cd frontend -
Install dependencies:
npm install
-
Create a
.envfile and add the API URL:VITE_API_URL=http://localhost:5000 -
Start the React development server:
npm run dev
The app will run on
http://localhost:5173.
You can run the frontend in a Docker container:
cd frontend
docker build -t recipe-frontend .
docker run -p 3000:3000 --env VITE_API_URL=http://host.docker.internal:5000 recipe-frontend- Start the backend server.
- Start the frontend app.
- Enter ingredients in the input box and submit.
- View generated recipes, including details like ingredients, instructions, cooking time, and servings.
recipe/
│
├── backend/
│ ├── app.py
│ └── requirements.txt
│
└── frontend/
├── src/
├── public/
├── package.json
└── ...
Pull requests are welcome! For major changes, please open an issue first to discuss your ideas.
This project is open source. License information can be added here.