Initial commit

docs/guides/GUIDE_INSTALLATION_UTILISATION.md

@@ -0,0 +1,229 @@
+# 📖 Guide d'Installation et d'Utilisation
+
+## 🎯 Deux Scripts Différents
+
+### `setup.sh` - Installation Complète (À faire UNE FOIS)
+
+**Ce qu'il fait** :
+- ✅ Crée l'environnement virtuel (`venv/`)
+- ✅ Installe toutes les dépendances (`requirements.txt`)
+- ✅ Vérifie Ollama
+- ✅ Télécharge les modèles
+- ✅ Crée les répertoires de données
+
+**Quand l'utiliser** :
+- Première installation
+- Après avoir cloné le repo
+- Après avoir supprimé le venv
+
+**Commande** :
+```bash
+cd geniusia2
+./setup.sh
+```
+
+### `run.sh` - Lancement de l'Application (À chaque utilisation)
+
+**Ce qu'il fait** :
+- ✅ Vérifie que le venv existe
+- ✅ Vérifie que FAISS est installé
+- ✅ Vérifie qu'Ollama tourne
+- ✅ Lance l'application
+
+**Ce qu'il NE fait PAS** :
+- ❌ Ne crée PAS le venv
+- ❌ N'installe PAS les dépendances
+- ❌ N'installe PAS FAISS automatiquement
+
+**Quand l'utiliser** :
+- Pour lancer l'application
+- Après avoir fait `setup.sh`
+
+**Commande** :
+```bash
+cd geniusia2
+./run.sh
+```
+
+## 📋 Workflow Complet
+
+### Première Installation
+
+```bash
+# 1. Installation complète
+cd geniusia2
+./setup.sh
+
+# 2. Installer FAISS (si pas fait par setup.sh)
+./install_faiss.sh
+
+# 3. Reconstruire l'index FAISS (si des tâches existent)
+cd ..
+./rebuild_index.sh
+
+# 4. Lancer l'application
+cd geniusia2
+./run.sh
+```
+
+### Utilisation Quotidienne
+
+```bash
+# 1. Démarrer Ollama (si pas déjà lancé)
+ollama serve &
+
+# 2. Lancer l'application
+cd geniusia2
+./run.sh
+```
+
+## 🔧 Scripts Disponibles
+
+### Dans `geniusia2/`
+
+| Script | Description | Quand l'utiliser |
+|--------|-------------|------------------|
+| `setup.sh` | Installation complète | Une fois au début |
+| `run.sh` | Lance l'application | À chaque utilisation |
+| `install_faiss.sh` | Installe FAISS | Si FAISS manque |
+
+### À la racine
+
+| Script | Description | Quand l'utiliser |
+|--------|-------------|------------------|
+| `rebuild_index.sh` | Reconstruit l'index FAISS | Si index manquant/corrompu |
+| `test_task_replay.py` | Test de rejeu | Pour tester |
+| `example_complete_workflow.py` | Workflow complet | Pour démo |
+| `diagnostic_data.py` | Diagnostic | Pour vérifier l'état |
+| `read_pkl.py` | Lecture des tâches | Pour explorer |
+
+## ⚠️ Problèmes Courants
+
+### "Environnement virtuel non trouvé"
+
+**Symptôme** : `./run.sh` dit que le venv n'existe pas
+
+**Solution** :
+```bash
+cd geniusia2
+./setup.sh
+```
+
+### "FAISS n'est pas installé"
+
+**Symptôme** : `./run.sh` propose d'installer FAISS
+
+**Solution 1** : Accepter l'installation (taper 'o')
+
+**Solution 2** : Installer manuellement
+```bash
+cd geniusia2
+./install_faiss.sh
+```
+
+### "Ollama ne semble pas être en cours d'exécution"
+
+**Symptôme** : Message d'avertissement au lancement
+
+**Solution** :
+```bash
+# Dans un terminal séparé
+ollama serve
+```
+
+### Scripts Python ne fonctionnent pas
+
+**Symptôme** : `ModuleNotFoundError` ou `ImportError`
+
+**Solution** : Utiliser le Python du venv
+```bash
+# ❌ Mauvais
+python3 test_task_replay.py
+
+# ✅ Bon
+geniusia2/venv/bin/python test_task_replay.py
+```
+
+## 📊 Vérification de l'Installation
+
+### Checklist
+
+```bash
+# 1. Vérifier que le venv existe
+ls geniusia2/venv/
+
+# 2. Vérifier que FAISS est installé
+geniusia2/venv/bin/python -c "import faiss; print('✅ FAISS OK')"
+
+# 3. Vérifier que l'index FAISS existe
+ls -lh geniusia2/data/faiss_index/
+
+# 4. Vérifier qu'Ollama tourne
+pgrep -x ollama && echo "✅ Ollama OK" || echo "❌ Ollama non lancé"
+
+# 5. Diagnostic complet
+geniusia2/venv/bin/python diagnostic_data.py
+```
+
+### Résultat Attendu
+
+```
+✅ FAISS OK
+✅ Ollama OK
+✅ Index FAISS : 595 KB
+✅ 99 tâches disponibles
+```
+
+## 🎯 Résumé
+
+### Pour Installer (Une fois)
+
+```bash
+cd geniusia2
+./setup.sh
+./install_faiss.sh
+```
+
+### Pour Utiliser (À chaque fois)
+
+```bash
+# Terminal 1 : Ollama
+ollama serve
+
+# Terminal 2 : Application
+cd geniusia2
+./run.sh
+```
+
+### Pour Tester
+
+```bash
+geniusia2/venv/bin/python test_task_replay.py
+```
+
+## 📝 Notes Importantes
+
+1. **`setup.sh` ne lance PAS l'application** - Il installe seulement
+2. **`run.sh` ne fait PAS l'installation** - Il lance seulement
+3. **Toujours utiliser le Python du venv** pour les scripts
+4. **Ollama doit tourner** avant de lancer l'application
+
+## 🆘 En Cas de Doute
+
+```bash
+# Tout réinstaller
+cd geniusia2
+rm -rf venv
+./setup.sh
+./install_faiss.sh
+
+# Vérifier
+cd ..
+geniusia2/venv/bin/python diagnostic_data.py
+
+# Lancer
+cd geniusia2
+./run.sh
+```
+
+**Tout devrait fonctionner ! 🚀**