> 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/hauptfunktionen/headless/installation.md). # Installation Die Installation von Headless AugeLab Studio unterscheidet sich je nach Betriebssystem. Folgen Sie den Anweisungen unten für Ihre jeweilige Plattform. ## Windows Die Verwendung des AugeLab Studio-Installers richtet die Headless-Runtime bereits manuell ein und ist die empfohlene Methode zur Installation von Headless Studio unter Windows. ## Linux Laden Sie das Linux-Installationsskript von [account.augelab.com](https://account.augelab.com) herunter. Der Installer unterstützt Debian und Debian-basierte Distributionen, einschließlich Ubuntu. Er erstellt eine isolierte virtuelle Umgebung unter `~/studio_venv`, installiert das ausgewählte `studio`-Paketprofil und legt Desktop-Launcher an, wenn der UI-Modus ausgewählt wird. {% hint style="warning" %} Der Installer installiert nicht das NVIDIA CUDA Toolkit oder NVIDIA-Treiber. Für Linux x86 AI/GPU-Modus installieren Sie zuerst den NVIDIA-Treiber, **CUDA 12.8**, cuDNN und die erforderlichen Umgebungsvariablen. Folgen Sie der Anleitung unter [Linux x86 GPU Setup](/german/faq/linux-x86-cuda-cudnn.md). {% 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 Launcher `augelab_studio` hinzu und erzeugt Desktop-Einträge. Nach der Installation ausführen: ```bash augelab_studio ``` ### Vollständige Installation mit AI/GPU-Unterstützung Installieren Sie zunächst den NVIDIA-Treiber, **CUDA 12.8** und cuDNN. Für Linux x86 folgen Sie der Anleitung unter [Linux x86 GPU Setup](/german/faq/linux-x86-cuda-cudnn.md). Danach ausführen: ```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 benötigen: ```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, **CUDA 12.8** und cuDNN. Für Linux x86 folgen Sie der Anleitung unter [Linux x86 GPU Setup](/german/faq/linux-x86-cuda-cudnn.md). Danach ausführen: ```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 Headless- oder UI-Modus installiert werden soll und 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.
Deinstallation ```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 den Installer, wenn möglich. 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 NVIDIA-Treiber, **CUDA 12.8** und cuDNN. Für Linux x86 folgen Sie [Linux x86 GPU Setup](/german/faq/linux-x86-cuda-cudnn.md) und ersetzen `studio` durch `studio[gpu]`.
## Docker mit CPU/CUDA auf x86\_64 Für Kunden-Deployments bauen Sie das Container-Image aus einer Dockerfile. AugeLab Studio ist eine Closed-Source-Anwendung, daher installiert Docker das `studio`-Paket aus dem AugeLab-Paket-Index statt Studio aus dem Quellcode zu bauen. Verwenden Sie [Docker Example](/german/hauptfunktionen/headless/docker-example.md) als kanonische Docker-Anleitung. Sie enthält: * CPU Dockerfile * GPU/CUDA Dockerfile * `docker-compose.yml` * `.env` * Szenario-Runner-Skript * eingebundenen Ausgabe-Ordner ### 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 die GPU/CUDA Dockerfile im [Docker Example](/german/hauptfunktionen/headless/docker-example.md). Sie 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-Installationsskripte 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 Launcher `augelab_studio` hinzu und erzeugt Desktop-Einträge. ### Vollständige ARM64-Installation mit AI/GPU-Unterstützung Installieren Sie zuerst den passenden NVIDIA JetPack/CUDA-Stack für Ihr Gerät. Für Jetson-Geräte verwenden Sie die CUDA-Version, die zu Ihrer JetPack-Version passt. ```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 NVIDIA JetPack/CUDA-Stack für Ihr Gerät. Für Jetson-Geräte verwenden Sie die CUDA-Version, die zu Ihrer JetPack-Version passt. ```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 Debian-basierte Distributionen. Wenn Ihr Gerät eine andere Linux-Familie nutzt, kontaktieren Sie AugeLab für Bereitstellungs-Hinweise. {% endhint %} Für Jetson GPU/CUDA-Deployments stimmen Sie Installer, JetPack-, CUDA-Stack und AugeLab-Paketprofil für Ihr Gerät aufeinander ab. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.augelab.com/german/hauptfunktionen/headless/installation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.