> 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/german/wichtige-funktionen/headless/installation.md). # Installation Die Installation von Headless AugeLab Studio unterscheidet sich je nach Betriebssystem. Folgen Sie den Anweisungen unten für Ihre Plattform. ## Windows Die Verwendung des AugeLab Studio-Installers richtet die Headless-Runtime unter Windows automatisch ein und ist der empfohlene Weg, Headless Studio unter Windows zu installieren. ## Linux Laden Sie das Linux-Installerskript von [account.augelab.com](https://account.augelab.com) herunter. Der Installer unterstützt Debian und debianbasierte Distributionen, einschließlich Ubuntu. Er erstellt eine isolierte virtuelle Umgebung unter `~/studio_venv`, installiert das gewählte `studio`-Paketprofil und legt Desktop-Launcher an, wenn der UI-Modus ausgewählt wird. {% hint style="warning" %} Der Installer installiert keine NVIDIA-Treiber. Für AI/GPU-Modus installieren Sie zuerst den NVIDIA-Treiber auf dem Host. AugeLab Studio liefert die benötigten CUDA-Runtimes mit. Auf Jetson-Geräten verwenden Sie bitte den JetPack/NVIDIA-Treiberstapel für Ihr Gerät. {% endhint %} ### Vollständige Installation Verwenden Sie dies für die reguläre Desktop- + Headless-Installation: ```bash chmod +x installer.sh ./installer.sh --ui ``` Dies installiert `studio[ui]`, erstellt `~/studio_venv`, fügt den `augelab_studio`-Launcher hinzu und erzeugt Desktop-Einträge. Nach der Installation führen Sie aus: ```bash augelab_studio ``` ### Vollständige Installation mit AI/GPU-Unterstützung Installieren Sie zuerst den NVIDIA-Treiber, dann führen Sie aus: ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Dies installiert `studio[ui,gpu]`.
Nur Headless Verwenden Sie dies, wenn Sie nur die Python-API benötigen und die Desktop-UI nicht erforderlich ist: ```bash chmod +x installer.sh ./installer.sh --headless ``` Dies installiert `studio`. UI-Launcher und Desktop-Einträge werden nicht erstellt.
Headless mit AI/GPU-Unterstützung Installieren Sie zuerst den NVIDIA-Treiber, dann führen Sie aus: ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Dies installiert `studio[gpu]`. UI-Launcher und Desktop-Einträge werden nicht erstellt.
Interaktive Installation Führen Sie den Installer ohne Modus-Flags aus, um den Installationsmodus interaktiv auszuwählen: ```bash chmod +x installer.sh ./installer.sh ``` Der Installer fragt, ob im Headless- oder UI-Modus installiert werden soll und anschließend, ob das AI/GPU-Extra eingeschlossen werden soll.
Nicht-interaktive Installation mit Umgebungsvariablen Verwenden Sie Umgebungsvariablen bei der Ausführung aus der Automatisierung: ```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` wählt den UI-Modus. `INSTALL_AI=1` fügt das AI/GPU-Extra hinzu.
Deinstallieren ```bash ./installer.sh --uninstall ``` Dies entfernt vom Installer erstellte Dateien: * `~/studio_venv` * `~/.local/bin/augelab_studio` * AugeLab Studio Desktop-Einträge * AugeLab Studio Icons Übergeordnete Verzeichnisse werden nur entfernt, wenn sie leer sind.
Manuelle Python-Installation Verwenden Sie wann immer möglich den Installer. Wenn Sie eine manuelle Python-Umgebung benötigen, installieren Sie in eine isolierte virtuelle Umgebung statt in das System-Python: ```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 ``` Für die manuelle AI/GPU-Installation installieren Sie zuerst den NVIDIA-Treiber und ersetzen `studio` durch `studio[gpu]`. AugeLab Studio liefert die benötigten CUDA-Runtimes mit.
## Docker mit CPU/CUDA auf x86\_64 Für Kunden-Bereitstellungen bauen Sie das Container-Image aus einem Dockerfile. AugeLab Studio ist eine Closed-Source-Anwendung, daher installiert Docker das `studio`-Paket aus dem AugeLab-Paketindex anstatt Studio aus dem Quellcode zu bauen. Verwenden Sie [Docker Example](/german/wichtige-funktionen/headless/docker-example.md) als kanonische Docker-Anleitung. Diese enthält: * CPU Dockerfile * GPU/CUDA Dockerfile * `docker-compose.yml` * `.env` * Szenario-Runner-Skript * eingebundenen Ausgabeordner ### CPU Docker Verwenden Sie CPU Docker, wenn Ihr Szenario keine CUDA-Beschleunigung benötigt. Das Docker-Beispiel baut auf `python:3.12-slim-bookworm` auf und installiert `studio`. ### GPU/CUDA AugeLab Studio unterstützt CUDA-Beschleunigung für Headless-Szenarien. GPU Docker erfordert kompatible NVIDIA-Treiber und das NVIDIA Container Toolkit auf dem Host. Verwenden Sie das GPU/CUDA Dockerfile im [Docker Example](/german/wichtige-funktionen/headless/docker-example.md). Es baut auf einem NVIDIA CUDA-Runtime-Image auf und installiert `studio[gpu]`. ## ARM64 (Raspberry Pi, Jetson Nano/AGX) AugeLab Studio unterstützt die ARM64-Architektur für Headless-Nutzung auf Debian-basierten Geräten wie Raspberry Pi und der NVIDIA Jetson-Serie. Laden Sie die Linux ARM64-Installer-Skripte von [account.augelab.com](https://account.augelab.com) herunter und führen Sie den Installer auf dem Gerät aus. ### Vollständige ARM64-Installation ```bash chmod +x installer.sh ./installer.sh --ui ``` Dies installiert `studio[ui]`, erstellt `~/studio_venv`, fügt den `augelab_studio`-Launcher hinzu und erzeugt Desktop-Einträge. ### Vollständige ARM64-Installation mit AI/GPU-Unterstützung Installieren Sie zuerst den passenden JetPack/NVIDIA-Treiberstapel für Ihr Gerät. ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Dies installiert `studio[ui,gpu]`.
Nur Headless ARM64 ```bash chmod +x installer.sh ./installer.sh --headless ``` Dies installiert `studio`. UI-Launcher und Desktop-Einträge werden nicht erstellt.
Headless ARM64 mit AI/GPU-Unterstützung Installieren Sie zuerst den passenden JetPack/NVIDIA-Treiberstapel für Ihr Gerät. ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Dies installiert `studio[gpu]`. UI-Launcher und Desktop-Einträge werden nicht erstellt.
ARM64-Deinstallation ```bash ./installer.sh --uninstall ```
{% hint style="info" %} Der ARM64-Installer unterstützt Debian und debianbasierte Distributionen. Wenn Ihr Gerät eine andere Linux-Familie verwendet, kontaktieren Sie AugeLab für Bereitstellungsanleitungen. {% endhint %} Für Jetson-GPU-Bereitstellungen stimmen Sie den Installer, den JetPack/NVIDIA-Treiberstapel und das AugeLab-Paketprofil für Ihr Gerät ab.