# 🚀 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 !** 🚀