An open-source AI assistant for tourism in Burkina Faso, powered by RAG (Retrieval-Augmented Generation).
# 🇧🇫 Assistant IA Tourisme Burkina Faso — Système RAG Open Source
> Système de questions-réponses 100% open source sur le tourisme burkinabè.
> BGE-M3 + ChromaDB + Qwen3 via Ollama. Zéro coût cloud. Zéro API propriétaire.
## Sujet choisi : Tourisme Burkina Faso
**Justification :** Le tourisme burkinabè (Loropéni UNESCO, Cascades de Banfora,
Laongo, FESPACO, artisanat Mossi) est documentable, sous-représenté en IA francophone,
et pertinent pour valoriser le patrimoine local. Critères remplis : 500+ sources
accessibles, forte pertinence locale, données en français.
---
## Architecture technique
```
Question
│
▼
[Sanitization] ← Prompt injection detection, bleach, max length
│
▼
[Embeddings] ← BAAI/bge-m3 (multilingual, top MTEB, local)
│
▼
[ChromaDB] ← Recherche vectorielle (cosine similarity, top-5)
│
▼
[Agent LangGraph] ← Vérificateur → Synthétiseur
│
▼
[Ollama + Qwen3] ← LLM local, réponse + sources citées
│
▼
Réponse
```
**Couche agentique légère (LangGraph) :**
- Nœud 1 — Vérificateur : évalue la pertinence des documents récupérés
- Nœud 2 — Synthétiseur : génère la réponse avec sources obligatoires
---
## Technologies open source utilisées
| Composant | Technologie | Licence | Lien |
|-----------|------------|---------|------|
| Embeddings | sentence-transformers + BAAI/bge-m3 | Apache 2.0 / MIT | github |
| Base vectorielle | ChromaDB | Apache 2.0 | github |
| LLM | Ollama + Qwen2.5-7B | MIT / Apache 2.0 | github |
| Agent | LangGraph | MIT | github |
| Backend | FastAPI | MIT | github |
| Frontend | Gradio | Apache 2.0 | github |
| Scraping | BeautifulSoup4 + trafilatura | MIT / Apache 2.0 | github |
| Sécurité inputs | bleach | Apache 2.0 | github |
| Logs | loguru | MIT | github |
| Rate limiting | slowapi | MIT | github |
---
## Installation pas-à-pas
### Prérequis
- Python 3.10+
- Ollama installé localement
- Git
### 1. Clone le repo
```bash
git clone
github.com
cd tourisme-burkina-rag
```
### 2. In …