4.6 KiB
🚀 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 :
./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
python3 -m venv geniusia2/venv
source geniusia2/venv/bin/activate
2. Installer les dépendances système
sudo apt-get update
sudo apt-get install -y wmctrl xdotool scrot
3. Installer PyTorch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
4. Installer FAISS
pip install faiss-cpu
Ou si ça échoue :
cd geniusia2
./install_faiss.sh
5. Installer OpenCLIP
pip install open-clip-torch
6. Installer les autres dépendances
pip install -r geniusia2/requirements.txt
Vérification de l'Installation
Diagnostic Complet
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
python3 diagnostic_faiss.py
Problèmes Courants
Erreur : "faiss-cpu" ne s'installe pas
Solution 1 : Utiliser le script d'installation
cd geniusia2
./install_faiss.sh
Solution 2 : Compiler depuis les sources
# 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 :
# 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 :
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
source geniusia2/venv/bin/activate
2. Télécharger les modèles (optionnel)
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
cd geniusia2
./run.sh
Ou en mode Shadow (sans GUI visible) :
./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 :
# 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 :
- ✅ Lire le guide de démarrage :
docs/guides/DEMARRAGE_RAPIDE.md - ✅ Tester le système :
./lancer_test.sh - ✅ Apprendre un premier workflow (3 répétitions)
- ✅ Tester le Mode Assisté
Bon démarrage avec GeniusIA v2 ! 🚀