Initial commit

docs/archive/old-summaries/GUIDE_INSTALLATION.md

@@ -0,0 +1,248 @@
+# 🚀 Guide d'Installation - GeniusIA v2
+
+**Date** : 19 Novembre 2024
+
+## Installation Automatique (Recommandé)
+
+### Méthode 1 : Script Complet
+
+Le script `installer_dependances_completes.sh` installe automatiquement toutes les dépendances :
+
+```bash
+./installer_dependances_completes.sh
+```
+
+**Ce qui est installé :**
+- ✅ Environnement virtuel Python
+- ✅ Dépendances système (wmctrl, xdotool, scrot)
+- ✅ PyTorch (version CPU)
+- ✅ FAISS (recherche de similarité)
+- ✅ OpenCLIP (embeddings visuels)
+- ✅ Toutes les dépendances Python
+
+**Durée estimée** : 5-10 minutes (selon la connexion)
+
+---
+
+## Installation Manuelle
+
+Si le script automatique échoue, voici les étapes manuelles :
+
+### 1. Créer l'environnement virtuel
+
+```bash
+python3 -m venv geniusia2/venv
+source geniusia2/venv/bin/activate
+```
+
+### 2. Installer les dépendances système
+
+```bash
+sudo apt-get update
+sudo apt-get install -y wmctrl xdotool scrot
+```
+
+### 3. Installer PyTorch
+
+```bash
+pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+```
+
+### 4. Installer FAISS
+
+```bash
+pip install faiss-cpu
+```
+
+Ou si ça échoue :
+
+```bash
+cd geniusia2
+./install_faiss.sh
+```
+
+### 5. Installer OpenCLIP
+
+```bash
+pip install open-clip-torch
+```
+
+### 6. Installer les autres dépendances
+
+```bash
+pip install -r geniusia2/requirements.txt
+```
+
+---
+
+## Vérification de l'Installation
+
+### Diagnostic Complet
+
+```bash
+python3 diagnostic_complet_systeme.py
+```
+
+Ce script vérifie :
+- ✅ Version Python
+- ✅ Environnement virtuel
+- ✅ Toutes les dépendances Python
+- ✅ Dépendances système
+- ✅ Répertoires de données
+- ✅ Modèles ML
+- ✅ Index FAISS
+
+### Diagnostic FAISS Spécifique
+
+```bash
+python3 diagnostic_faiss.py
+```
+
+---
+
+## Problèmes Courants
+
+### Erreur : "faiss-cpu" ne s'installe pas
+
+**Solution 1** : Utiliser le script d'installation
+```bash
+cd geniusia2
+./install_faiss.sh
+```
+
+**Solution 2** : Compiler depuis les sources
+```bash
+# Voir LECON_APPRISE_DEPENDANCES.md pour les détails
+```
+
+### Erreur : "torch" ne s'installe pas
+
+**Cause** : Problème de connexion ou d'espace disque
+
+**Solution** :
+```bash
+# Vérifier l'espace disque
+df -h
+
+# Réessayer avec un miroir différent
+pip install torch --index-url https://download.pytorch.org/whl/cpu
+```
+
+### Erreur : "Permission denied"
+
+**Cause** : Le script n'est pas exécutable
+
+**Solution** :
+```bash
+chmod +x installer_dependances_completes.sh
+./installer_dependances_completes.sh
+```
+
+### Erreur : "sudo: command not found"
+
+**Cause** : Pas de droits administrateur
+
+**Solution** : Demander à l'administrateur système d'installer :
+- wmctrl
+- xdotool
+- scrot
+
+---
+
+## Après l'Installation
+
+### 1. Activer l'environnement virtuel
+
+```bash
+source geniusia2/venv/bin/activate
+```
+
+### 2. Télécharger les modèles (optionnel)
+
+```bash
+cd geniusia2
+python3 download_models.py
+```
+
+**Note** : Les modèles sont volumineux (~2-3 GB). Le système peut fonctionner sans eux en mode dégradé.
+
+### 3. Lancer l'application
+
+```bash
+cd geniusia2
+./run.sh
+```
+
+Ou en mode Shadow (sans GUI visible) :
+
+```bash
+./run_headless.sh
+```
+
+---
+
+## Configuration Minimale
+
+### Matériel
+- **CPU** : 4 cœurs minimum (8 recommandés)
+- **RAM** : 8 GB minimum (16 GB recommandés)
+- **Disque** : 10 GB libres (20 GB avec modèles)
+
+### Logiciel
+- **OS** : Linux (Ubuntu 20.04+, Debian 11+)
+- **Python** : 3.8 ou supérieur
+- **Serveur X** : Pour la capture d'écran
+
+---
+
+## Désinstallation
+
+Pour supprimer complètement GeniusIA v2 :
+
+```bash
+# Supprimer l'environnement virtuel
+rm -rf geniusia2/venv
+
+# Supprimer les données utilisateur
+rm -rf geniusia2/data/user_profiles
+rm -rf geniusia2/data/logs
+
+# Supprimer les modèles
+rm -rf geniusia2/models
+
+# Désinstaller les dépendances système (optionnel)
+sudo apt-get remove wmctrl xdotool scrot
+```
+
+---
+
+## Support
+
+### Documentation
+- **Guide rapide** : `docs/guides/DEMARRAGE_RAPIDE.md`
+- **Guide complet** : `docs/guides/GUIDE_INSTALLATION_UTILISATION.md`
+- **Dépendances** : `LECON_APPRISE_DEPENDANCES.md`
+
+### Diagnostic
+- **Système complet** : `python3 diagnostic_complet_systeme.py`
+- **FAISS** : `python3 diagnostic_faiss.py`
+
+### Tests
+- **Workflows** : `python3 test_workflows_simple.py`
+- **Mode Assisté** : `python3 test_mode_assiste_workflows.py`
+- **Test manuel** : `./lancer_test.sh`
+
+---
+
+## Prochaines Étapes
+
+Après l'installation réussie :
+
+1. ✅ Lire le guide de démarrage : `docs/guides/DEMARRAGE_RAPIDE.md`
+2. ✅ Tester le système : `./lancer_test.sh`
+3. ✅ Apprendre un premier workflow (3 répétitions)
+4. ✅ Tester le Mode Assisté
+
+---
+
+**Bon démarrage avec GeniusIA v2 !** 🚀