README.md

---
title: Wolof Text Generation API
emoji: 🗣️
colorFrom: green
colorTo: yellow
sdk: docker
app_port: 7860
pinned: false
---

# Wolof Text Generation API (FastAPI)

API REST qui génère du texte en **wolof** à partir du modèle
[`BobCodeur/qwen2.5-0.5b-wolof`](https://huggingface.co/BobCodeur/qwen2.5-0.5b-wolof)
(Qwen2.5-0.5B fine-tuné en LoRA). Accessible **sans compte ni token**.

## Endpoints

| Méthode | Route | Description |
|---------|-------|-------------|
| GET | `/health` | vérifie que le service est réveillé |
| GET | `/generate?text=...` | test rapide au navigateur |
| POST | `/generate` | corps JSON `{text, max_length?, temperature?}` |

## Exemples

**Navigateur (GET) :**
```
/generate?text=Dakar mooy gëblag réew mi
```

**cURL (POST) :**
```bash
curl -X POST https://<ton-space>.hf.space/generate \
  -H "Content-Type: application/json" \
  -d '{"text": "Dakar mooy gëblag réew mi", "max_length": 80}'
# -> {"prompt":"...","generated":"..."}
```

**Python :**
```python
import requests
r = requests.post("https://<ton-space>.hf.space/generate",
                  json={"text": "Dakar mooy gëblag réew mi"})
print(r.json()["generated"])
```

## Notes

- Le service peut se **mettre en veille** ; le 1er appel après une pause prend 1-2 min
  (démarrage à froid + chargement du modèle). Prévoir un **timeout de 60 s + un retry**.
- Paramètres : `text` (obligatoire), `max_length` (défaut 80), `temperature` (défaut 0.6).
- ⚠️ Modèle 0.5B : utiliser une **amorce clairement wolof et assez longue** pour rester
  dans la langue.