Your smart cooking assistant that transforms available ingredients into delicious recipe ideas!
- 🤖 AI-Powered Recipe Generation: Uses advanced AI models to create personalized recipes
- 📱 Responsive Design: Optimized for all devices - desktop, tablet, and mobile
- ⚡ Real-time Processing: Instant recipe generation with loading indicators
- 🎯 Ingredient Management: Easy ingredient input and management system
- 🎨 Modern UI/UX: Clean, intuitive interface with smooth animations
- 📱 Mobile-First: Fully responsive design that works on all screen sizes
- Frontend: React 19.1.0, CSS3
- AI Integration: Anthropic Claude API, Hugging Face Inference
- Styling: Custom CSS with responsive design
- Build Tool: Create React App
- Deployment: Ready for Vercel, Netlify, or any static hosting
- Node.js (v16 or higher)
- npm or yarn
- API keys for AI services
-
Clone the repository
git clone https://github.com/000Shehab000/TasteGPT.git cd TasteGPT -
Install dependencies
cd app npm install -
Set up environment variables
# Create .env file in the app directory cp .env.example .env # Add your API keys REACT_APP_ANTHROPIC_API_KEY=your_anthropic_key REACT_APP_HUGGINGFACE_API_KEY=your_huggingface_key
-
Start the development server
npm start
-
Open your browser Navigate to
http://localhost:3000
| Variable | Description | Required |
|---|---|---|
REACT_APP_ANTHROPIC_API_KEY |
Anthropic Claude API key | Yes |
REACT_APP_HUGGINGFACE_API_KEY |
Hugging Face API key | Yes |
- Anthropic Claude: Get your API key from Anthropic Console
- Hugging Face: Get your API key from Hugging Face
TasteGPT/
├── app/
│ ├── public/
│ │ ├── index.html
│ │ └── favicon.ico
│ ├── src/
│ │ ├── components/
│ │ │ ├── Header.js
│ │ │ ├── Main.js
│ │ │ ├── IngredientsList.js
│ │ │ └── ClaudeRecipe.js
│ │ ├── ai.js
│ │ ├── App.js
│ │ ├── App.css
│ │ └── index.js
│ ├── package.json
│ └── README.md
└── README.md
- Input Ingredients: Users add ingredients they have available
- AI Processing: The app sends ingredients to AI models for recipe generation
- Recipe Generation: AI creates personalized recipes based on available ingredients
- Display Results: Beautifully formatted recipes are displayed to users
- API keys are stored securely in environment variables
- No sensitive data is exposed in client-side code
- Input validation and sanitization
- Error handling for API failures
The application is built with a mobile-first approach and includes:
- Breakpoints: 480px, 768px, and 1200px
- Flexbox Layout: Adaptive layouts for different screen sizes
- Touch-Friendly: Optimized for mobile interactions
- Performance: Optimized loading and rendering
-
Install Vercel CLI
npm i -g vercel
-
Deploy
cd app vercel
-
Build the project
npm run build
-
Drag and drop the
buildfolder to Netlify
-
Build the project
npm run build
-
Upload the
buildfolder to your hosting provider
We welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Anthropic for Claude AI API
- Hugging Face for inference API
- React Team for the amazing framework
- Open Source Community for inspiration and tools
- LinkedIn: Shehab Gamal El-Deen
- ✅ Core Features: Complete
- ✅ Responsive Design: Complete
- ✅ AI Integration: Complete
- ✅ Error Handling: Complete
- 🔄 Performance Optimization: In Progress
- 🔄 Additional AI Models: Planned
Made with ❤️ by [Shehab Gamal El-Deen]
Star this repository if you found it helpful! ⭐

