Spoonacular Recipe App Development

Saqlain

Saqlain Shahid

🚀 Spoonacular Recipe App

A Streamlit web app (Python) that lets users upload a food image or enter a search term to instantly receive a recipe—with ingredients, instructions, nutrition details, and an option to export as PDF.

⭐ Badges

🧩 Features

📷 Image‑to‑Recipe Matching — Upload a food photo to fetch relevant recipe results
🔎 Keyword Search — Discover recipes by dish names or ingredients
📋 Clean Recipe View — Includes recipe image, ingredient list, step‑by‑step instructions, and nutrition info
📥 PDF Export — Download chosen recipes as formatted printable PDFs
🔐 Secure API Integration — Store API keys in .env to keep credentials safe

🧱 Technologies

Frontend/UI: Streamlit
Backend Language: Python
Image Handling: Pillow
PDF Generation: FPDF
API Service: Spoonacular Food & Nutrition API
Secrets Management: python‑dotenv

🧪 Installation

git clone https://github.com/SaqlainShahid/spoonacular-recipe.git
cd spoonacular-recipe
python3 -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows
pip install -r requirements.txt
Create a .env file in the project root:
SPOONACULAR_API_KEY=your_api_key_here

Launch the app:
streamlit run app.py

📂 Usage

Open the Streamlit interface.
Choose to upload an image or type a keyword.
View matching recipes with images, ingredient lists, instructions, and nutrition facts.
Click Export to PDF for a printable version.
Try different images or searches anytime.

📝 Why It Stands Out

Dual input modes: Image and Text searches
Powered by Spoonacular’s extensive recipe database
Simple and responsive Streamlit layout
Generates professional-looking PDFs

⭐ Recommended README Best Practices

Center titles or logos for visual impact
Place badges at the top for a quick snapshot of your project
Add a Table of Contents for easy navigation in longer files
Keep it clean, concise, and friendly—use emojis for readability

🤝 Contributing

Want to help? ✅
Fork the repository
Create a branch: feature/your-feature
Make your enhancements (add caching, richer UI, new input types…)
Commit changes & push: git push origin feature/your-feature
Submit a Pull Request to main
Let’s build something great together!

📜 License

This project is licensed under MIT License.
Happy cooking and coding! 🍳 | Questions or feedback? Please raise an issue or DM on GitHub.
Like this project

Posted Aug 1, 2025

Developed a Streamlit app for recipe discovery using image and text inputs.

Likes

0

Views

0

Timeline

Jul 1, 2025 - Jul 7, 2025