README.md

---
title: GrooveNomad Festivals
emoji: 🐨
colorFrom: gray
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# 🎪 Festival RAG Bot — API Gemini + ChromaDB + Hugging Face

Bienvenue sur **GrooveNomad Festivals** 🐨 !  

Ce projet est une API intelligente qui :
✅ Lit une base vectorielle de festivals (ChromaDB)  
✅ Comprend les requêtes utilisateurs en langage naturel  
✅ Génère des réponses en français avec **Gemini 2.0 Flash**  
✅ Répond via une API `POST /api/ask`

---

## 🚀 Utilisation de l'API

### 🔹 Endpoint
- **URL** : `https://klydekushy-groovenomad-festivals.hf.space/api/ask`
- **Méthode** : `POST`
- **Content-Type** : `application/json`

### 🔹 Format de requête
```json
{
  "query": "Je cherche un festival de rock en Europe"
}
```

### 🔹 Exemple de réponse
```json
{
  "response": "🎸 Parfait ! J'ai trouvé des festivals de rock géniaux pour toi en Europe ! Le Hellfest à Clisson en France est incontournable pour les amateurs de métal..."
}
```

---

## 🛠️ Technologies utilisées
- **FastAPI** : Framework web moderne
- **ChromaDB** : Base vectorielle pour la recherche sémantique
- **Sentence Transformers** : Encodage des requêtes
- **Google Gemini 2.0** : Génération de réponses intelligentes
- **Hugging Face Spaces** : Hébergement