diff --git a/INSTALLATION_WINDOWS_FR.md b/INSTALLATION_WINDOWS_FR.md new file mode 100644 index 00000000..2b820e9c --- /dev/null +++ b/INSTALLATION_WINDOWS_FR.md @@ -0,0 +1,651 @@ +# Guide d'Installation de CV Studio sous Windows + +> Guide complet d'installation de CV Studio pour les utilisateurs Windows + + + +## 📋 Table des MatiĂšres + +- [Vue d'ensemble](#-vue-densemble) +- [Configuration Requise](#-configuration-requise) +- [MĂ©thode 1 : ExĂ©cutable Windows (RECOMMANDÉ)](#mĂ©thode-1--exĂ©cutable-windows-recommandĂ©) +- [MĂ©thode 2 : Installation Python Directe](#mĂ©thode-2--installation-python-directe) +- [MĂ©thode 3 : Environnement Virtuel Python](#mĂ©thode-3--environnement-virtuel-python) +- [MĂ©thode 4 : Installation via Pip](#mĂ©thode-4--installation-via-pip) +- [VĂ©rification de l'Installation](#-vĂ©rification-de-linstallation) +- [DĂ©pannage](#-dĂ©pannage) +- [Prochaines Étapes](#-prochaines-Ă©tapes) + +--- + +## 🎯 Vue d'ensemble + +CV Studio est une application professionnelle de traitement d'image basĂ©e sur un systĂšme de nƓuds pour le dĂ©veloppement, la vĂ©rification et la comparaison de vision par ordinateur. + +Ce guide vous accompagne Ă  travers toutes les mĂ©thodes d'installation disponibles sous Windows, de la plus simple (exĂ©cutable autonome) Ă  la plus avancĂ©e (installation depuis les sources). + +--- + +## đŸ’» Configuration Requise + +### Configuration Minimale +- **SystĂšme d'exploitation** : Windows 10 ou Windows 11 (64-bit) +- **Processeur** : Intel Core i5 ou Ă©quivalent +- **MĂ©moire RAM** : 8 GB minimum (16 GB recommandĂ©s) +- **Espace disque** : 3 GB d'espace libre +- **Carte graphique** : Compatible OpenGL 3.0+ + +### Configuration RecommandĂ©e +- **SystĂšme d'exploitation** : Windows 11 (64-bit) +- **Processeur** : Intel Core i7 ou AMD Ryzen 7 +- **MĂ©moire RAM** : 16 GB ou plus +- **Espace disque** : 5 GB d'espace libre +- **Carte graphique** : NVIDIA GPU avec support CUDA (pour l'accĂ©lĂ©ration GPU) + +### Logiciels Requis (selon la mĂ©thode) +- **Pour l'exĂ©cutable** : Aucun ! Tout est inclus +- **Pour l'installation Python** : + - Python 3.7 ou supĂ©rieur (Python 3.12 recommandĂ©) + - Git pour Windows (optionnel mais recommandĂ©) + +--- + +## MĂ©thode 1 : ExĂ©cutable Windows (RECOMMANDÉ) + +### ✅ Avantages +- ✅ **Aucune installation de Python requise** +- ✅ **PrĂȘt Ă  l'emploi** - TĂ©lĂ©chargez et lancez +- ✅ **Tous les modĂšles inclus** - ModĂšles ONNX pour la dĂ©tection d'objets +- ✅ **IdĂ©al pour les dĂ©butants** - Aucune configuration nĂ©cessaire + +### đŸ“„ Option A : Construction Automatique via GitHub Actions (PLUS SIMPLE) + +**Aucun outil de build local n'est requis !** DĂ©clenchez simplement une construction sur GitHub : + +#### Étapes + +1. **AccĂ©dez Ă  l'onglet Actions** + - Allez sur : https://github.com/hackolite/CV_Studio/actions + +2. **Cliquez sur "Build Windows Executable"** dans la barre latĂ©rale gauche + +3. **Cliquez sur "Run workflow"** + - SĂ©lectionnez la branche (gĂ©nĂ©ralement `main`) + - Cliquez sur le bouton vert "Run workflow" + +4. **Attendez 10-15 minutes** que la construction se termine + - Une coche verte ✓ apparaĂźtra lorsque c'est terminĂ© + +5. **TĂ©lĂ©chargez l'exĂ©cutable** + - Cliquez sur le workflow terminĂ© + - Descendez Ă  la section "Artifacts" + - TĂ©lĂ©chargez `CV_Studio-Windows-Executable.zip` (environ 800 MB - 1.5 GB) + +6. **Extrayez et Lancez** + - DĂ©compressez le fichier ZIP + - Ouvrez le dossier `CV_Studio` + - Double-cliquez sur `CV_Studio.exe` + - C'est fait ! 🎉 + +### 📩 Option B : TĂ©lĂ©charger depuis une Release + +Si une release est disponible, tĂ©lĂ©chargez directement l'exĂ©cutable prĂ©-construit : + +1. Allez sur la page des Releases : https://github.com/hackolite/CV_Studio/releases +2. TĂ©lĂ©chargez `CV_Studio-Windows.zip` depuis la derniĂšre release +3. Extrayez le fichier ZIP +4. Lancez `CV_Studio.exe` + +### 🔧 Option C : Construire Localement sur Votre Machine Windows + +Si vous prĂ©fĂ©rez construire l'exĂ©cutable vous-mĂȘme : + +#### PrĂ©requis +- Python 3.7+ installĂ© (testĂ© avec Python 3.12) +- Git pour Windows +- Windows 10/11 + +#### Étapes de Construction + +**Étape 1 : Installer Python** + +1. TĂ©lĂ©chargez Python depuis https://www.python.org/downloads/ +2. **Important** : Cochez "Add Python to PATH" lors de l'installation +3. VĂ©rifiez l'installation : + ```cmd + python --version + ``` + +**Étape 2 : Cloner le DĂ©pĂŽt** + +```cmd +git clone https://github.com/hackolite/CV_Studio.git +cd CV_Studio +``` + +**Étape 3 : Installer les DĂ©pendances Principales** + +```cmd +pip install -r requirements.txt +``` + +**Étape 4 : Installer les DĂ©pendances de Build** + +```cmd +pip install -r requirements-build.txt +``` + +**Étape 5 : Construire l'ExĂ©cutable** + +```cmd +:: Build standard avec nettoyage +python build_exe.py --clean + +:: Ou : Build sans fenĂȘtre console (GUI uniquement) +python build_exe.py --clean --windowed + +:: Ou : Avec une icĂŽne personnalisĂ©e +python build_exe.py --clean --icon votre_icone.ico +``` + +Le processus de build va : +1. ✅ VĂ©rifier que toutes les dĂ©pendances sont installĂ©es +2. ✅ Nettoyer les artefacts de build prĂ©cĂ©dents (si --clean est utilisĂ©) +3. ✅ Empaqueter toutes les dĂ©pendances Python +4. ✅ Inclure tous les nƓuds (Input, Process, DL, Audio, etc.) +5. ✅ IntĂ©grer tous les modĂšles ONNX pour la dĂ©tection d'objets +6. ✅ CrĂ©er l'exĂ©cutable autonome + +**Temps de build** : Environ 5-15 minutes selon votre systĂšme. + +**Étape 6 : Localiser Votre ExĂ©cutable** + +Votre fichier .exe est prĂȘt dans : +``` +dist/CV_Studio/CV_Studio.exe +``` + +Le dossier `dist/CV_Studio/` contient : +- `CV_Studio.exe` - ExĂ©cutable principal +- `node/` - Toutes les implĂ©mentations de nƓuds et modĂšles ONNX +- `node_editor/` - Noyau de l'Ă©diteur et paramĂštres +- `src/` - Utilitaires sources +- `_internal/` - Runtime Python et dĂ©pendances + +**Étape 7 : Tester l'ExĂ©cutable** + +```cmd +cd dist\CV_Studio +CV_Studio.exe + +:: Ou avec sortie de dĂ©bogage +CV_Studio.exe --use_debug_print +``` + +### 📋 Contenu de l'ExĂ©cutable + +- ✅ Tous les nƓuds (Input, Process, DL, Audio, etc.) +- ✅ Tous les modĂšles ONNX pour la dĂ©tection d'objets (YOLOX, YOLO, FreeYOLO, etc.) +- ✅ Runtime Python complet (aucune installation Python sĂ©parĂ©e nĂ©cessaire) +- ✅ Toutes les bibliothĂšques requises (OpenCV, DearPyGUI, ONNX Runtime, etc.) +- ✅ Fichiers de configuration et polices + +**Taille** : Environ 800 MB - 1.5 GB + +--- + +## MĂ©thode 2 : Installation Python Directe + +### ✅ Avantages +- ✅ **Installation rapide** +- ✅ **Modifications du code possibles** +- ✅ **Mises Ă  jour faciles** +- ✅ **IdĂ©al pour le dĂ©veloppement** + +### PrĂ©requis + +**Installer Python** + +1. TĂ©lĂ©chargez Python 3.7 ou supĂ©rieur depuis https://www.python.org/downloads/ +2. **IMPORTANT** : Cochez "Add Python to PATH" lors de l'installation +3. VĂ©rifiez l'installation : + ```cmd + python --version + pip --version + ``` + +**Installer Git (Optionnel)** + +1. TĂ©lĂ©chargez Git depuis https://git-scm.com/download/win +2. Installez avec les options par dĂ©faut + +### Étapes d'Installation + +**Étape 1 : Cloner ou TĂ©lĂ©charger le DĂ©pĂŽt** + +**Option A : Avec Git** +```cmd +git clone https://github.com/hackolite/CV_Studio.git +cd CV_Studio +``` + +**Option B : TĂ©lĂ©chargement Manuel** +1. Allez sur https://github.com/hackolite/CV_Studio +2. Cliquez sur le bouton vert "Code" +3. Cliquez sur "Download ZIP" +4. Extrayez le ZIP dans un dossier de votre choix +5. Ouvrez un terminal dans ce dossier + +**Étape 2 : Installer les DĂ©pendances** + +```cmd +pip install -r requirements.txt +``` + +Cette commande installe : +- opencv-contrib-python (≄4.5.5.64) - Traitement d'image +- onnxruntime-gpu - InfĂ©rence de modĂšles ML +- dearpygui (≄1.11.0) - Interface graphique +- mediapipe - Solutions ML +- protobuf (≄3.20.0) - SĂ©rialisation de donnĂ©es +- filterpy (≄1.4.5) - Filtrage et suivi +- Et d'autres dĂ©pendances... + +**Temps d'installation** : 5-10 minutes selon votre connexion Internet. + +**Étape 3 : Lancer l'Application** + +```cmd +python main.py +``` + +### Options de Ligne de Commande + +```cmd +:: Utiliser un fichier de configuration personnalisĂ© +python main.py --setting custom_config.json + +:: Activer la sortie de dĂ©bogage +python main.py --use_debug_print + +:: DĂ©sactiver le dessin asynchrone (pour le dĂ©bogage) +python main.py --unuse_async_draw + +:: Combiner les options +python main.py --setting custom_config.json --use_debug_print +``` + +--- + +## MĂ©thode 3 : Environnement Virtuel Python + +### ✅ Avantages +- ✅ **Environnement isolĂ©** - Pas de conflits avec d'autres projets Python +- ✅ **Gestion des dĂ©pendances** - ContrĂŽle prĂ©cis des versions +- ✅ **Meilleure pratique de dĂ©veloppement** +- ✅ **RecommandĂ© pour le dĂ©veloppement** + +### PrĂ©requis + +- Python 3.7+ installĂ© (avec "Add to PATH" cochĂ©) +- Git pour Windows (optionnel) + +### Étapes d'Installation + +**Étape 1 : Cloner le DĂ©pĂŽt** + +```cmd +git clone https://github.com/hackolite/CV_Studio.git +cd CV_Studio +``` + +**Étape 2 : CrĂ©er un Environnement Virtuel** + +```cmd +python -m venv venv +``` + +Cela crĂ©e un dossier `venv` contenant un environnement Python isolĂ©. + +**Étape 3 : Activer l'Environnement Virtuel** + +```cmd +:: Sur Windows (Command Prompt) +venv\Scripts\activate + +:: Sur Windows (PowerShell) +venv\Scripts\Activate.ps1 +``` + +**Note** : Si vous obtenez une erreur de politique d'exĂ©cution dans PowerShell : +```powershell +Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser +``` + +Vous devriez voir `(venv)` au dĂ©but de votre invite de commande, indiquant que l'environnement virtuel est actif. + +**Étape 4 : Installer les DĂ©pendances** + +```cmd +pip install -r requirements.txt +``` + +**Étape 5 : Lancer l'Application** + +```cmd +python main.py +``` + +**DĂ©sactiver l'Environnement Virtuel** (quand vous avez terminĂ©) + +```cmd +deactivate +``` + +### Utilisation Quotidienne + +**Chaque fois que vous voulez utiliser CV Studio :** + +```cmd +cd CV_Studio +venv\Scripts\activate +python main.py +``` + +**Pour quitter :** +- Fermez l'application +- Tapez `deactivate` dans le terminal + +--- + +## MĂ©thode 4 : Installation via Pip + +### ✅ Avantages +- ✅ **Installation systĂšme** +- ✅ **Commande globale disponible** +- ✅ **Pas besoin de cloner le dĂ©pĂŽt** + +### PrĂ©requis + +**Installer les Outils de Build** + +1. **TĂ©lĂ©charger Visual Studio Build Tools** + - Allez sur : https://visualstudio.microsoft.com/visual-cpp-build-tools/ + - TĂ©lĂ©chargez "Build Tools for Visual Studio" + - Lors de l'installation, sĂ©lectionnez "Desktop development with C++" + +2. **VĂ©rifier l'Installation** + ```cmd + cl + ``` + Vous devriez voir des informations sur le compilateur Microsoft C/C++. + +### Étapes d'Installation + +**Étape 1 : Installer les Packages Requis** + +```cmd +pip install Cython numpy wheel +``` + +**Étape 2 : Installer CV Studio depuis GitHub** + +```cmd +pip install git+https://github.com/hackolite/CV_Studio.git +``` + +**Étape 3 : Lancer l'Application** + +```cmd +ipn-editor +``` + +**Note** : Cette mĂ©thode peut nĂ©cessiter plus de temps de configuration et peut rencontrer des problĂšmes de dĂ©pendances. Nous recommandons la MĂ©thode 2 ou 3 pour la plupart des utilisateurs. + +--- + +## ✅ VĂ©rification de l'Installation + +### Test de Base + +AprĂšs l'installation, vĂ©rifiez que CV Studio fonctionne correctement : + +**1. Lancer l'Application** + - L'interface graphique devrait s'ouvrir sans erreurs + +**2. Tester un Pipeline Simple** + + a. **Ajouter un nƓud Image** + - Cliquez sur le menu : `Input → Image` + - Cliquez sur la toile pour placer le nƓud + + b. **Charger une Image** + - Cliquez sur "Select Image" dans le nƓud + - SĂ©lectionnez n'importe quelle image (jpg, png, bmp) + + c. **Ajouter un NƓud de RĂ©sultat** + - Cliquez sur le menu : `Visual → Result Image` + - Cliquez sur la toile pour placer le nƓud + + d. **Connecter les NƓuds** + - Glissez depuis la sortie du nƓud Image vers l'entrĂ©e du nƓud Result Image + - Vous devriez voir votre image s'afficher ! + +**3. Tester un NƓud de Traitement** + + a. **Ajouter un nƓud Blur** + - Menu : `VisionProcess → Blur` + + b. **Connecter** : Image → Blur → Result Image + + c. **Ajuster les ParamĂštres** + - Utilisez le curseur dans le nƓud Blur + - Vous devriez voir l'effet en temps rĂ©el + +### VĂ©rification AvancĂ©e + +**Tester la DĂ©tection d'Objets** + +1. Ajouter un nƓud WebCam ou Image +2. Ajouter un nƓud Object Detection (`VisionModel → Object Detection`) +3. SĂ©lectionner un modĂšle (ex: YOLOX-Nano) +4. Ajouter un nƓud Draw Information +5. Ajouter un nƓud Result Image +6. Connecter : Input → Object Detection → Draw Information → Result Image + +Si la dĂ©tection fonctionne, votre installation est complĂšte ! + +--- + +## 🔧 DĂ©pannage + +### ProblĂšme : Python n'est pas reconnu + +**Erreur** : `'python' n'est pas reconnu en tant que commande interne` + +**Solution** : +1. RĂ©installez Python et **cochez "Add Python to PATH"** +2. Ou ajoutez manuellement Python au PATH : + - Recherchez "Variables d'environnement" dans Windows + - Cliquez sur "Variables d'environnement" + - Dans "Variables systĂšme", trouvez "Path" + - Ajoutez : `C:\Users\VotreNom\AppData\Local\Programs\Python\Python3X` + - Ajoutez : `C:\Users\VotreNom\AppData\Local\Programs\Python\Python3X\Scripts` +3. RedĂ©marrez votre terminal + +### ProblĂšme : L'application ne dĂ©marre pas + +**Solution 1 : Installer Visual C++ Redistributable** +- TĂ©lĂ©chargez : https://aka.ms/vs/17/release/vc_redist.x64.exe +- Installez et redĂ©marrez votre ordinateur + +**Solution 2 : VĂ©rifier les DĂ©pendances** +```cmd +pip install -r requirements.txt --upgrade +``` + +**Solution 3 : Utiliser le Mode Debug** +```cmd +python main.py --use_debug_print +``` +Cela affichera les messages d'erreur dĂ©taillĂ©s. + +### ProblĂšme : Erreur d'Installation de Pip + +**Erreur** : `Could not install packages due to an OSError` + +**Solution** : +```cmd +:: Utiliser les droits administrateur +pip install -r requirements.txt --user + +:: Ou mettre Ă  jour pip +python -m pip install --upgrade pip +pip install -r requirements.txt +``` + +### ProblĂšme : La Webcam n'est pas dĂ©tectĂ©e + +**Solution** : +1. Fermez les autres applications utilisant la webcam +2. VĂ©rifiez les permissions de la webcam dans Windows +3. Essayez diffĂ©rents numĂ©ros de pĂ©riphĂ©rique dans le nƓud WebCam (0, 1, 2...) + +### ProblĂšme : Erreur GPU / CUDA + +**Erreur** : Messages d'erreur liĂ©s Ă  CUDA ou GPU + +**Solution** : +1. VĂ©rifiez si vous avez une carte NVIDIA : `nvidia-smi` +2. Si pas de GPU NVIDIA, utilisez la version CPU : + ```cmd + pip uninstall onnxruntime-gpu + pip install onnxruntime + ``` +3. Dans l'application, dĂ©cochez l'option "GPU" dans les nƓuds DL + +### ProblĂšme : Erreur MediaPipe + +**Erreur** : `No module named 'mediapipe'` ou erreur protobuf + +**Solution** : +```cmd +pip install mediapipe +pip install protobuf==3.20.0 +``` + +### ProblĂšme : L'ExĂ©cutable ne DĂ©marre pas + +**Solution 1 : VĂ©rifier l'Antivirus** +- Votre antivirus peut bloquer l'exĂ©cutable +- Ajoutez CV_Studio.exe Ă  la liste blanche + +**Solution 2 : Lancer depuis la Ligne de Commande** +```cmd +cd dist\CV_Studio +CV_Studio.exe --use_debug_print +``` + +**Solution 3 : Reconstruire l'ExĂ©cutable** +```cmd +python build_exe.py --clean +``` + +### ProblĂšme : FPS Faible / Traitement Lent + +**Solutions** : +1. **RĂ©duire la RĂ©solution** + - Ajoutez un nƓud Resize au dĂ©but de votre pipeline + - Utilisez une rĂ©solution plus petite (ex: 640x480) + +2. **Activer le GPU** (si vous avez une carte NVIDIA) + - Cochez "GPU" dans les nƓuds DL + - Assurez-vous d'avoir `onnxruntime-gpu` installĂ© + +3. **Fermer les Applications Inutiles** + - LibĂ©rez de la mĂ©moire RAM + - Fermez les autres applications gourmandes + +### ProblĂšme : Erreur lors de l'Importation/Exportation + +**Solution** : +1. VĂ©rifiez que vous Ă©crivez dans un dossier accessible +2. Assurez-vous que le fichier JSON est valide +3. Essayez un chemin sans caractĂšres spĂ©ciaux + +### Obtenir de l'Aide + +Si vous rencontrez toujours des problĂšmes : + +1. **GitHub Issues** : https://github.com/hackolite/CV_Studio/issues + - Recherchez si votre problĂšme existe dĂ©jĂ  + - Sinon, crĂ©ez une nouvelle issue avec : + - Version de Windows + - Version de Python + - Message d'erreur complet + - Étapes pour reproduire le problĂšme + +2. **GitHub Discussions** : https://github.com/hackolite/CV_Studio/discussions + - Pour les questions gĂ©nĂ©rales + - Partage d'expĂ©riences avec d'autres utilisateurs + +--- + +## 🚀 Prochaines Étapes + +### Apprendre Ă  Utiliser CV Studio + +1. **Guide de DĂ©marrage Rapide** + - Voir la section "Usage" dans [README.md](README.md) + - Essayez les exemples de pipeline + +2. **Explorer les NƓuds** + - Parcourez les diffĂ©rentes catĂ©gories de nƓuds + - Testez les nƓuds de traitement d'image + - Essayez les nƓuds de Deep Learning + +3. **Exemples** + - Consultez le dossier [examples/](examples/) + - Essayez les exemples de code + +### DĂ©veloppement AvancĂ© + +1. **CrĂ©er des NƓuds PersonnalisĂ©s** + - Voir [src/README.md](src/README.md) + - Consultez [src/nodes/examples/](src/nodes/examples/) + +2. **Architecture et Tests** + - Lisez [TIMESTAMPED_QUEUE_SYSTEM.md](TIMESTAMPED_QUEUE_SYSTEM.md) + - ExĂ©cutez les tests : `python -m pytest tests/ -v` + +3. **Contribuer** + - Fork le dĂ©pĂŽt + - CrĂ©ez vos amĂ©liorations + - Soumettez une Pull Request + +### Ressources Utiles + +- **Documentation ComplĂšte** : [README.md](README.md) +- **Guide de Build d'ExĂ©cutable** : [BUILD_EXE_GUIDE_FR.md](BUILD_EXE_GUIDE_FR.md) +- **Comment Obtenir l'ExĂ©cutable** : [COMMENT_OBTENIR_EXE.md](COMMENT_OBTENIR_EXE.md) +- **Architecture Technique** : [src/README.md](src/README.md) + +--- + +## 📞 Support et CommunautĂ© + +- **Issues** : https://github.com/hackolite/CV_Studio/issues +- **Discussions** : https://github.com/hackolite/CV_Studio/discussions +- **Documentation** : Consultez les fichiers .md dans ce dĂ©pĂŽt + +--- + +
+ +**Fait avec ❀ pour la CommunautĂ© de Vision par Ordinateur** + +⭐ Donnez une Ă©toile Ă  ce dĂ©pĂŽt si vous le trouvez utile ! + +**Profitez de CV Studio ! 🎹** + +
diff --git a/README.md b/README.md index a3141496..c5af7807 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,10 @@ filterpy 1.4.5 or later ※ Required for MOT (Multi-Object Tracking) no ## 🚀 Installation +> đŸ‡«đŸ‡· **Pour les utilisateurs francophones** : [Guide d'Installation Windows en Français](INSTALLATION_WINDOWS_FR.md) +> +> đŸ‡«đŸ‡· **For French speakers** : [Windows Installation Guide in French](INSTALLATION_WINDOWS_FR.md) + ### Method 1: Direct Installation (Recommended) 1. **Clone the repository** @@ -1454,6 +1458,7 @@ Sample images are sourced from: - **Issues:** [GitHub Issues](https://github.com/hackolite/CV_Studio/issues) - **Discussions:** [GitHub Discussions](https://github.com/hackolite/CV_Studio/discussions) - **Documentation:** See the docs in this repository +- **đŸ‡«đŸ‡· Installation Windows (Français):** [INSTALLATION_WINDOWS_FR.md](INSTALLATION_WINDOWS_FR.md) ---