Skip to content

tarto-dev/finitonyaourt

Repository files navigation

🥣 FiniTonYaourt

Ton fidèle assistant anti-gaspi pour le frigo !

License: MIT Pre-commit: enabled Python Streamlit Status Docker


🚀 Description

FiniTonYaourt t'aide à suivre ce qu'il y a dans ton frigo, éviter le gaspillage et te donne des idées de recettes créatives (grâce à GPT !).

✅ Suivi des produits (quantité, date d'expiration, notes)
✅ Alertes produits expirant bientôt
✅ Suggestions de recettes à partir des produits
✅ Ajout rapide avec scan de code-barres (via Open Food Facts)
✅ Modales modernes pour ajouter ou éditer tes produits
✅ Mode "Consommé" pour marquer ce que tu as mangé


💻 Stack technique

  • Python 3.11+
  • Streamlit (UI)
  • OpenAI API (suggestions recettes)
  • Open Food Facts API (infos code-barres)
  • pyzbar & Pillow (scan image)
  • Docker & docker-compose (exécution isolée)

🐳 Installation avec Docker

git clone https://github.com/tarto-dev/finitonyaourt.git
cd finitonyaourt

# Builder l'image Docker
make docker-build

# Lancer l'application
make docker-up

# Stopper l'application
make docker-down

# Voir les logs
make docker-logs

Le projet est accessible sur http://localhost:8501 une fois démarré.

⚙️ Installation (sans Docker)

git clone https://github.com/tarto-dev/finitonyaourt.git
cd finitonyaourt
python3 -m venv venv
source venv/bin/activate  # ou venv\Scripts\activate sur Windows
pip install -r requirements.txt

🔑 Configurer la clé OpenAI

Pour utiliser la génération automatique de suggestions recettes (via GPT), tu dois fournir une clé OpenAI.

Comment obtenir une clé ?

1️⃣ Crée un compte sur OpenAI
2️⃣ Crée tes clés API depuis ton tableau de bord (section API keys)
3️⃣ Copie la clé générée (elle commence généralement par sk-...)

Comment la configurer dans le projet ?

Crée un fichier .env à la racine du projet :

OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

C’est tout ! Le projet détectera automatiquement la clé et affichera le bouton de suggestions si elle est présente.


✅ Lancer l'application manuellement

streamlit run app.py

📸 Screenshots

💡 Vue d'accueil

Accueil

🥗 Suggestions recettes

Recettes

📷 Scan code-barres

Scan


🤝 Contribuer

Les contributions sont les bienvenues ! Propose une idée, corrige un bug ou ajoute un badge "Anti-gaspi Hero" 🌱.


🫶 Remerciements

  • OpenAI pour l'IA
  • Open Food Facts pour la base produits
  • Tous les yaourts sauvés 💚

📄 Licence

MIT — fais-en bon usage (et sauve plein de yaourts) !

About

Ton fidèle assistant anti-gaspi pour le frigo !

Topics

Resources

License

Stars

Watchers

Forks