README.md 2.0 KB

Agent Docker - Chatbot QA

Application Flask de chatbot avec RAG (Retrieval-Augmented Generation), indexation FAISS et LLM Scaleway.

Prérequis

Lancement avec Docker Compose (recommandé)

# 1. Copier le fichier d'environnement
cp .env.example .env
# Éditer .env et remplir : WIKI_USERNAME, WIKI_PASSWORD, SCW_API_KEY, SERPAPI_KEY (optionnel)

# 2. Lancer tous les services (app, PostgreSQL)
docker-compose up --build

L'application sera accessible sur http://localhost:5000

Lancement en local (sans Docker, pour le debug)

# 1. Créer et activer le venv
py -m venv venv
.\venv\Scripts\Activate.ps1

# 2. Installer les dépendances (OBLIGATOIRE - évite ModuleNotFoundError)
.\install_local.ps1
# Si erreur psycopg2 (Python 3.13 Windows): .\install_local.ps1 -SkipPsycopg
# Alternative: pip install -r requirements.txt

# 3. PostgreSQL doit tourner (ex: docker-compose up -d postgres)

# 4. Lancer l'app
.\run_local.ps1

Construction d'image Docker seule

docker build -t chatbot .
docker run -d --name conteneur -p 5000:5000 -e DATABASE_URL=postgresql://... chatbot

Indexation initiale (chunks + FAISS)

Au premier démarrage, les fichiers All_chunks.json et faiss_index.index peuvent être absents. Pour les générer :

# Dans un conteneur ou en local avec venv activé
python -c "
from src.utils.processing import full_update_pipeline
full_update_pipeline()
"

Tests

Les dépendances (dont pytest) sont installées dans l'image Docker. Pour lancer les tests :

docker-compose run --rm app pytest tests/ -v

Ou après docker-compose up :

docker-compose exec app pytest tests/ -v

Commandes Docker utiles

  • Voir les conteneurs : docker ps
  • Arrêter : docker stop <nom-conteneur>
  • Supprimer : docker rm <nom-conteneur>
  • Exporter l'image : docker save chatbot > chatbot.tar
  • Importer : docker load < chatbot.tar