---
title: GRAPP
emoji: 🍇
colorFrom: pink
colorTo: purple
sdk: static
pinned: false
license: mit
short_description: Choisir son vin sans se prendre la grappe
---

# 🍇 GRAPP — L'app pour choisir ton vin sans te prendre la grappe

> Même si t'y connais rien, GRAPP t'aide à trouver LE vin que tu kiffes, super facilement.

**Problème.** En 60 ans, la consommation de vin des Français a chuté de 70 %. Les jeunes trouvent le vin élitiste,
compliqué et intimidant (« c'est cher », « je préfère la bière », « au bar je commande une blonde, c'est plus facile »).
Devant une carte des vins de resto, ils ne savent pas quoi choisir. Le vin pèse pourtant 15 % de la production agricole
française en valeur, et 1 exploitation agricole sur 5 a une activité viticole.

**Solution.** GRAPP (concept et direction artistique : projet de fin d'études de Manon Thomas, M2 DA, ECV Paris 2025)
transforme la carte des vins en conseil personnalisé, sans jargon :

| Module | Ce que ça fait | IA utilisée |
|---|---|---|
| 🥂 **Tchin Tchin !** | 1) photo de la carte du resto → GRAPP repère les vins proposés et leurs prix ; 2) quiz en 7 questions ; 3) top 3 avec un **% de match** et le *pourquoi* | OCR Tesseract + correspondance floue ; recommandation hybride (profil + embeddings de phrases Hugging Face) |
| 💖 **Mes p'tits favoris** | Garde tes vins pépites et te propose des vins du même style | Similarité d'embeddings |
| 💡 **Dico Vino** | Pose ta question comme tu veux (« pourquoi ma bouche gratte ? ») → explication cool du mot (ici : tanins) | Recherche sémantique |

### Ce qui va au-delà du cours
- **Pipeline multimodal** : image → texte (OCR) → entités (vins) → recommandation.
- **Correspondance floue** robuste aux erreurs d'OCR (« Cétes du Rhone » → Côtes du Rhône, « ler Cru » → 1er Cru).
- **Recommandation hybride explicable** : score pondéré entre critères du quiz et similarité sémantique d'une phrase libre,
  avec les raisons affichées à l'utilisateur.
- **Modèle Hugging Face multilingue** (`paraphrase-multilingual-MiniLM-L12-v2`) avec **repli automatique** sur TF-IDF
  hors ligne : l'app tourne toujours.

---

## 📘 Guide d'utilisation

### 1. Installer (une seule fois)
Il faut **Python 3.10+**.

```bash
cd GRAPP
python -m venv .venv
source .venv/bin/activate          # Windows : .venv\Scripts\activate
pip install -r requirements.txt
```

Pour lire les photos de cartes, installer aussi le moteur **Tesseract** :
- macOS : `brew install tesseract tesseract-lang`
- Windows : installeur sur https://github.com/UB-Mannheim/tesseract/wiki
- Linux : `sudo apt install tesseract-ocr tesseract-ocr-fra`

> Sans Tesseract, tout marche sauf la lecture de photo : on colle alors le texte de la carte.
> Au premier lancement, le modèle Hugging Face (~470 Mo) se télécharge automatiquement.

### 2. Lancer
```bash
streamlit run app.py
```
L'app s'ouvre dans le navigateur (http://localhost:8501).

### 3. Utiliser
1. **Tchin Tchin !** → choisis *Photo*, *Carte d'exemple (démo)* ou *Coller le texte*, puis **Lire la carte**
   (ou « Pas de carte, on passe au quiz »).
2. Réponds aux **7 questions** (plan du jour, verre ou bouteille, couleur, bulles, sucre, corps, goûts, budget, envie en une phrase).
3. GRAPP affiche ton **top 3** avec le % de match. ❤️ pour garder un vin, 🔁 pour des vins du même style.
4. **Mes p'tits favoris** : tes vins enregistrés (dans `data/favoris.json`).
5. **Dico Vino** : tape un mot ou une question.

Scénario de démo conseillé pour la vidéo : *Carte d'exemple* → Apéro entre potes → bouteille → Rouge → Sans bulles →
Sec → Léger → Fruité, 30 € → « un truc frais avec de la charcuterie » ⇒ Chinon / Beaujolais-Villages en tête.

### 4. Vérifier que tout marche
```bash
python tests/test_grapp.py         # ou : python -m pytest -q
```

### 5. (Optionnel) Ajouter de vraies bouteilles notées — Kaggle
Télécharger `winemag-data-130k-v2.csv` depuis https://www.kaggle.com/datasets/zynicide/wine-reviews dans `data/`, puis :
```bash
python scripts/enrichir_kaggle.py
```
Chaque vin recommandé affiche alors les bouteilles réelles les mieux notées de son appellation.

### 6. Mettre l'app en ligne (lien public, gratuit)
**Hugging Face Space statique + stlite :** `index.html` lance le même `app.py` directement dans le navigateur
du visiteur grâce à [stlite](https://github.com/whitphx/stlite) (Streamlit compilé en WebAssembly via Pyodide). Pas de serveur, donc gratuit.
1. Sur https://huggingface.co → *New Space* → nom `grapp`, SDK **Static**.
2. *Files* → *Upload files* : glisse tout le contenu du dossier GRAPP (dossiers compris) → *Commit*.
3. Lien : `https://huggingface.co/spaces/<ton-pseudo>/grapp`.

Différences avec la version locale : pas de Tesseract dans le navigateur (la carte d'exemple utilise le texte déjà
extrait, `data/carte_exemple.txt` ; pour une autre carte, on colle son texte), et la recherche sémantique utilise le
mode TF-IDF. Pour la version complète en ligne : `Dockerfile` (Hugging Face Docker, payant) ou Streamlit Community Cloud
(gratuit, via GitHub, utilise `packages.txt`).

> En ligne, les favoris sont gardés le temps de la visite.

---

## 🗂️ Contenu du projet
```
app.py                       Interface Streamlit (charte graphique du dossier PFE)
grapp/engine.py              Moteur de recommandation, embeddings, Dico Vino
grapp/carte.py               OCR de la carte + correspondance floue + prix
data/vins.csv                75 profils de vins par appellation (couleur, bulles, sucre, corps, acidité, tanins, arômes, accords, prix)
data/dico.csv                34 définitions du Dico Vino
assets/carte_exemple.png     Carte des vins fictive pour la démo
scripts/build_dataset.py     Régénère data/vins.csv
scripts/generer_carte_exemple.py  Régénère la carte d'exemple
scripts/enrichir_kaggle.py   Enrichissement optionnel avec Wine Reviews (Kaggle)
tests/test_grapp.py          Tests automatiques
SOURCES.md                   Bibliothèques, modèles, données et sources citées
PROMPTS.md                   Où et comment l'IA générative a été utilisée, avec les prompts
```

## Limites
- La base contient des **profils typiques d'appellation** (75), pas chaque domaine : deux vins d'une même appellation peuvent différer.
- Les prix sont **indicatifs** (France, caviste) ; GRAPP utilise le prix de la carte quand il le lit.
- À consommer avec modération. L'abus d'alcool est dangereux pour la santé. App réservée aux 18 ans et plus.