README.md

---
title: Assistant Vizyon Ayiti 360
emoji: 🌊
colorFrom: blue
colorTo: green
sdk: streamlit
sdk_version: 1.36.0
app_file: app.py
pinned: false
short_description: Assistant interne RAG du site Vizyon Ayiti 360
---

# Assistant Vizyon Ayiti 360 — Space Hugging Face

Interface de chat (avec téléversement de documents) qui répond **uniquement** à
partir du contenu du site **vizyonayiti360.org**, y compris les **documents non
publics** selon les droits d'un compte WordPress. Conçu pour être **privé** et
intégré en **iframe** dans une page WordPress protégée par connexion.

## Configuration (Settings → Variables and secrets)

Secrets à définir dans le Space :

| Nom | Type | Rôle |
|-----|------|------|
| `HF_API_TOKEN` | secret | Jeton Hugging Face (génération du modèle). |
| `WP_USERNAME` | secret | Identifiant WordPress (pour le contenu non public). |
| `WP_APP_PASSWORD` | secret | Mot de passe d'application WordPress. |

Variables optionnelles : `HF_MODEL`, `SITE_URL`, `DEFAULT_LANG` (`fr`/`en`/`ht`),
`INCLUDE_NON_PUBLIC` (`true`/`false`), `TOP_K`, `MIN_SCORE`, `REBUILD_ON_START`.

> Sans `WP_USERNAME` / `WP_APP_PASSWORD`, l'assistant fonctionne en **mode
> public** uniquement.

## Modèles

- **Génération** : `meta-llama/Llama-3.1-8B-Instruct` via l'API Hugging Face.
- **Embeddings** (locaux, multilingues FR/EN) :
  `sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`.

## Fonctionnement

Au démarrage, le Space indexe le contenu du site via l'API REST WordPress
(authentifiée si des identifiants sont fournis), puis répond aux questions en
citant ses sources. Les documents joints sont analysés en session et non
conservés.

Voir **`DEPLOIEMENT_HF_SPACE.md`** pour la mise en ligne et l'intégration
WordPress.