# Agent Docker - Chatbot QA Application Flask de chatbot avec RAG (Retrieval-Augmented Generation), indexation FAISS et LLM Scaleway. ## Prérequis - Docker et Docker Compose (https://docs.docker.com/get-docker/) - Fichier `.env` avec les variables nécessaires (voir `.env.example`) ## Lancement avec Docker Compose (recommandé) ```bash # 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 ## Dashboard développeur La page **/developpeur** affiche le monitoring (santé, pipeline, scraping, mémoire, config). Elle peut aussi afficher les **dépenses API Scaleway** du mois en cours : définir `SCW_ORGANIZATION_ID` dans le `.env` (ou utiliser `SCW_ENDPOINT` comme project_id) et s'assurer que la clé API a le droit **BillingReadOnly** dans la console Scaleway. ## Lancement en local (sans Docker, pour le debug) ```powershell # 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 ```bash 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 : ```bash # 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 : ```bash docker-compose run --rm app pytest tests/ -v ``` Ou après `docker-compose up` : ```bash docker-compose exec app pytest tests/ -v ``` ## Commandes Docker utiles - Voir les conteneurs : `docker ps` - Arrêter : `docker stop ` - Supprimer : `docker rm ` - Exporter l'image : `docker save chatbot > chatbot.tar` - Importer : `docker load < chatbot.tar`