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 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.

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.

Vollständige Installation

Verwenden Sie dies für die reguläre Desktop- + Headless-Installation:

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:

augelab_studio

Vollständige Installation mit AI/GPU-Unterstützung

Installieren Sie zuerst den NVIDIA-Treiber, dann führen Sie aus:

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:

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:

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:

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:

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

./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:

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 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. 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 herunter und führen Sie den Installer auf dem Gerät aus.

Vollständige ARM64-Installation

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.

chmod +x installer.sh
./installer.sh --ui --ai

Dies installiert studio[ui,gpu].

Nur Headless ARM64

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.

chmod +x installer.sh
./installer.sh --headless --ai

Dies installiert studio[gpu]. UI-Launcher und Desktop-Einträge werden nicht erstellt.

ARM64-Deinstallation

./installer.sh --uninstall

Der ARM64-Installer unterstützt Debian und debianbasierte Distributionen. Wenn Ihr Gerät eine andere Linux-Familie verwendet, kontaktieren Sie AugeLab für Bereitstellungsanleitungen.

Für Jetson-GPU-Bereitstellungen stimmen Sie den Installer, den JetPack/NVIDIA-Treiberstapel und das AugeLab-Paketprofil für Ihr Gerät ab.