> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/key-features/headless/installation.md). # Installation L'installation de Headless AugeLab Studio varie selon votre système d'exploitation. Suivez les instructions ci-dessous pour votre plateforme spécifique. ## Windows L'utilisation de l'installateur AugeLab Studio pour Windows configure déjà le runtime headless et est la méthode recommandée pour installer Headless Studio sous Windows. ## Linux Téléchargez le script d'installation Linux depuis [account.augelab.com](https://account.augelab.com). L'installateur prend en charge Debian et les distributions basées sur Debian (y compris Ubuntu). Il crée un environnement virtuel isolé dans `~/studio_venv`, installe le profil de paquet `studio` sélectionné et crée des lanceurs de bureau si le mode UI est choisi. > **Avertissement :** L'installateur n'installe pas les pilotes NVIDIA. Pour le mode AI/GPU, installez d'abord le pilote NVIDIA sur l'hôte. AugeLab Studio fournit les runtimes CUDA nécessaires. Sur les appareils Jetson, utilisez la pile JetPack/pilotes NVIDIA adaptée à votre appareil. ### Installation complète Utilisez ceci pour l'installation standard (bureau + headless) : ```bash chmod +x installer.sh ./installer.sh --ui ``` Cela installe `studio[ui]`, crée `~/studio_venv`, ajoute le lanceur `augelab_studio` et crée des entrées de bureau. Après l'installation, lancez : ```bash augelab_studio ``` ### Installation complète avec support AI/GPU Installez d'abord le pilote NVIDIA, puis exécutez : ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Cela installe `studio[ui,gpu]`.
Headless uniquement Utilisez ceci lorsque vous n'avez besoin que de l'API Python et pas de l'interface de bureau : ```bash chmod +x installer.sh ./installer.sh --headless ``` Cela installe `studio`. Aucun lanceur UI ni entrée de bureau n'est créé.
Headless avec support AI/GPU Installez d'abord le pilote NVIDIA, puis exécutez : ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Cela installe `studio[gpu]`. Aucun lanceur UI ni entrée de bureau n'est créé.
Installation interactive Exécutez l'installateur sans indicateurs de mode pour choisir le mode d'installation de façon interactive : ```bash chmod +x installer.sh ./installer.sh ``` L'installateur demandera si vous souhaitez installer en mode headless ou UI, puis si vous voulez inclure l'option AI/GPU.
Installation non interactive via variables d'environnement Utilisez des variables d'environnement pour automatiser l'installation : ```bash INSTALL_UI=1 INSTALL_AI=0 ./installer.sh INSTALL_UI=1 INSTALL_AI=1 ./installer.sh INSTALL_UI=0 INSTALL_AI=0 ./installer.sh INSTALL_UI=0 INSTALL_AI=1 ./installer.sh ``` `INSTALL_UI=1` sélectionne le mode UI. `INSTALL_AI=1` inclut l'option AI/GPU.
Désinstallation ```bash ./installer.sh --uninstall ``` Cela supprime les fichiers créés par l'installateur : * `~/studio_venv` * `~/.local/bin/augelab_studio` * les entrées de bureau AugeLab Studio * les icônes AugeLab Studio Les répertoires parents ne sont supprimés que s'ils sont vides.
Installation Python manuelle Utilisez l'installateur quand c'est possible. Si vous avez besoin d'un environnement Python manuel, installez dans un environnement virtuel isolé plutôt que dans le Python système : ```bash apt-get update -y && \ apt-get install -y --no-install-recommends \ libdmtx0b \ zbar-tools \ build-essential \ libgl1-mesa-glx \ curl \ ca-certificates \ && rm -rf /var/lib/apt/lists/* curl -fsSL https://astral.sh/uv/install.sh | sh uv venv -p 3.12 studio_venv uv pip install --python studio_venv/bin/python \ studio \ --extra-index-url https://pyrepo.augelab.com \ --extra-index-url https://download.pytorch.org/whl/cpu \ --index-strategy unsafe-best-match ``` Pour une installation manuelle avec AI/GPU, installez d'abord le pilote NVIDIA, puis remplacez `studio` par `studio[gpu]`. AugeLab Studio fournit les runtimes CUDA nécessaires.
## Docker avec CPU/CUDA sur x86\_64 Pour les déploiements clients, construisez l'image du conteneur à partir d'un Dockerfile. AugeLab Studio est une application propriétaire ; Docker installe le paquet `studio` depuis l'index de paquets AugeLab au lieu de compiler Studio depuis les sources. Utilisez le guide canonique [Docker Example](/french/key-features/headless/docker-example.md). Il inclut : * Dockerfile CPU * Dockerfile GPU/CUDA * `docker-compose.yml` * `.env` * script d'exécution de scénario * dossier de sortie monté ### Docker CPU Utilisez Docker CPU quand votre scénario n'a pas besoin de l'accélération CUDA. L'exemple Docker utilise `python:3.12-slim-bookworm` et installe `studio`. ### GPU/CUDA AugeLab Studio prend en charge l'accélération CUDA pour les scénarios headless. Le Docker GPU nécessite des pilotes NVIDIA compatibles et le NVIDIA Container Toolkit sur l'hôte. Utilisez le Dockerfile GPU/CUDA fourni dans [Docker Example](/french/key-features/headless/docker-example.md). Il part d'une image runtime NVIDIA CUDA et installe `studio[gpu]`. ## ARM64 (Raspberry Pi, Jetson Nano/AGX) AugeLab Studio prend en charge l'architecture ARM64 pour une utilisation headless sur des appareils basés sur Debian tels que Raspberry Pi et la série NVIDIA Jetson. Téléchargez les scripts d'installation Linux ARM64 depuis [account.augelab.com](https://account.augelab.com), puis exécutez l'installateur sur l'appareil. ### Installation complète ARM64 ```bash chmod +x installer.sh ./installer.sh --ui ``` Cela installe `studio[ui]`, crée `~/studio_venv`, ajoute le lanceur `augelab_studio` et crée des entrées de bureau. ### Installation complète ARM64 avec support AI/GPU Installez d'abord la pile JetPack/pilotes NVIDIA appropriée pour votre appareil. ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Cela installe `studio[ui,gpu]`.
Headless ARM64 uniquement ```bash chmod +x installer.sh ./installer.sh --headless ``` Cela installe `studio`. Aucun lanceur UI ni entrée de bureau n'est créé.
Headless ARM64 avec support AI/GPU Installez d'abord la pile JetPack/pilotes NVIDIA appropriée pour votre appareil. ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Cela installe `studio[gpu]`. Aucun lanceur UI ni entrée de bureau n'est créé.
Désinstallation ARM64 ```bash ./installer.sh --uninstall ```
> **Info :** L'installateur ARM64 prend en charge Debian et les distributions basées sur Debian. Si votre appareil utilise une autre famille Linux, contactez AugeLab pour des conseils de déploiement. Pour les déploiements GPU sur Jetson, assurez-vous que l'installateur, la pile JetPack/pilotes NVIDIA et le profil de paquet AugeLab correspondent à votre appareil.