jamesstringer90/appsandboxErstellen Sie ganz einfach vollständige virtuelle Maschinen, die für Entwicklungs- oder Computernutzungsmodelle in einer Sandbox gekapselt sind.
<img width="1028" height="446" alt="App Sandbox" src="https://assets.kitploit.com/production/public/readmes/9069/22f20578f6addd52e9c49edd40a96b935bc2fa169592852d8d5ac91d0c4b7160.png" /> # App Sandbox App Sandbox ist eine Virtual-Machine-App für Windows und macOS, die auf Leistung und Benutzerfreundlichkeit ausgelegt ist. Windows-Funktionen: - Funktioniert unter Windows 11 Home oder Pro, ohne Hyper-V - Unterstützung für Windows 11- oder Ubuntu 26.04 LTS-VMs - Zero-Touch-Installation - Kopieren und Einfügen - 2-Kanal-Audio - GPU-Beschleunigung über Paravirtualisierung (GPU-PV) mit Unterstützung für DirectX 12 (nur Windows), OpenGL, Vulkan, CUDA, OpenCL - Unterstützung für GPU-Hardware-Video-Decoder/Encoder - SSH über Hyper-V-Socket-Proxy (kein Netzwerk erforderlich) - Snapshots - Feste 1080P60-Anzeige - Hotkey-Unterstützung vom Host zum Client - Bereitstellung und Start mit / ohne Internet - Unterstützt die Ausführung von Claude Cowork und Docker innerhalb der VM dank Nested-Virtualization-Unterstützung - Headless-Modus: eine skriptbare lokale HTTP/JSON-API + abhängigkeitsfreies Python-SDK (`asb.py`) zum programmatischen Erstellen und Steuern GPU-beschleunigter VMs Mac-Funktionen: - Unterstützung für macOS- oder Windows 11 ARM-VMs - Zero-Touch-Installation für Windows 11, macOS hat 3 nicht überspringbare Onboarding-Schritte - Kopieren und Einfügen - 2-Kanal-Audio - macOS: GPU-Beschleunigung über Paravirtualisierung mit Unterstützung für Metal, Windows: Keine GPU-Beschleunigung - SSH über virtio-vsock (kein Netzwerk erforderlich) - Feste 1080P60-Anzeige bei Windows 11-Gästen, dynamische Anzeigengröße bei macOS-Gästen - Bereitstellung und Start mit / ohne Internet - Headless-Modus: dieselbe skriptbare lokale HTTP/JSON-API + Python-SDK (`asb.py`) wie unter Windows, zum programmatischen Steuern von macOS- und Windows 11-VMs Voraussetzungen: Windows 11 mit einem x64-Prozessor oder macOS Tahoe (M-Serie) ## Über App Sandbox App Sandbox erstellt und betreibt vollständige Desktop-Virtualmaschinen — Windows 11, Ubuntu und macOS. Es ist kostenlos und Open Source (MIT), verteilt als vorgefertigte Binärdateien (EV-signiert unter Windows, Apple-Developer-signiert unter macOS) auf der [Releases](https://github.com/jamesstringer90/appsandbox/releases)-Seite. Es wird auf zwei Arten gesteuert: über eine grafische Benutzeroberfläche oder programmatisch über einen Headless-Daemon mit einem abhängigkeitsfreien Python-SDK (`asb.py`). In beiden Fällen wählen Sie ein Betriebssystem, verweisen auf ein Installations- Image, und App Sandbox richtet die Festplatte ein, führt eine unbeaufsichtigte Installation durch und startet den Gast. Sie stellen ein Windows- oder Ubuntu-ISO bereit; macOS-Gäste laden ihr Wiederherstellungsimage automatisch herunter. Es läuft auf einem Windows 11 (x64)-PC oder einem Apple Silicon Mac, einschließlich Laptops. **Läuft unter Windows 11 Home, ohne Hyper-V.** Unter Windows verwendet App Sandbox weder Hyper-V noch den Hyper-V-Manager; es erstellt und betreibt VMs über die Windows Host Compute System (HCS)- und Host Compute Network (HCN)-APIs, die nur das Feature *Virtual Machine Platform* erfordern. Hyper-V ist auf Windows 11 Pro und Enterprise beschränkt, während Virtual Machine Platform unter Windows 11 Home verfügbar ist, sodass keine Windows 11 Pro-Lizenz erforderlich ist. Virtual Machine Platform ist dasselbe Windows-Feature, das WSL2 verwendet. **Wofür Sie es verwenden können:** - Eine vollständige Windows- oder Ubuntu-**Desktop**-VM — ein komplettes grafisches Betriebssystem mit GPU-Beschleunigung (OpenGL, Vulkan, CUDA) — zum Erstellen und Testen Ihrer eigenen Software auf einer sauberen Installation. - Ausführen eines Programms in einer VM, getrennt von Ihrem Hauptbetriebssystem und Ihren Dateien. - Entwickeln und Testen von Windows-Treibern: Ein integrierter **Testmodus** aktiviert Test-Signierung innerhalb des Gasts, sodass die Secure Boot- und Boot-Konfiguration des Hosts unverändert bleiben. - Ausführen eines Computer-Use-KI-Agenten (wie dem Computer-Use-Modell von Claude) in einer eigenen VM. App Sandbox stellt den Desktop und die VM bereit; die eigene Modellschleife des Agenten läuft innerhalb des Gasts. Mehrere Agenten können gleichzeitig ausgeführt werden, jeder in einer eigenen VM, auf einem einzigen Laptop oder Desktop. - Erstellen GPU-beschleunigter (**GPU-PV**) VMs, über die GUI oder die Headless-API. - Skripten des VM-Lebenszyklus aus dem Code — Erstellen, Snapshot, Branch, SSH-Verbindung und Löschen GPU-beschleunigter VMs — mit dem Python-SDK. **Headless-API.** `appsandbox.exe --headless` (oder `sudo /Appsandbox.app/Contents/MacOS/AppSandbox --headless` unter macOS) startet einen Single-Owner-Daemon, der denselben Kern wie die GUI hostet und ihn als Docker-artige lokale HTTP/JSON-API auf `127.0.0.1` bereitstellt, identisch auf beiden Plattformen. Das nur auf der Standardbibliothek basierende Python-SDK (`asb.py`) umschließt es: Erstellen GPU-beschleunigter VMs (GPU-PV ist eine `gpuMode`-Erstellungsoption), SSH- Zugang über einen automatisch bereitgestellten Schlüssel (Windows-, Ubuntu- oder macOS-Gäste), Snapshot und Branch dieser VMs, Öffnen der Live-Anzeige und Ausführen mehrerer gleichzeitig — wie viele gleichzeitig laufen, wird durch den Host- CPU, RAM und GPU-Speicher begrenzt, nicht durch ein festes Limit. Der Daemon ist Single-Host — er steuert VMs auf dem Rechner, auf dem er läuft, und stellt keine Cloud-VMs bereit; für CI führen Sie ihn auf einem selbst gehosteten Runner aus. Die Bereitstellung einer VM führt eine vollständige unbeaufsichtigte Installation durch; Snapshots, Branches und Templates (nur Windows) starten eine neue VM aus einem bereitgestellten Zustand, anstatt neu zu installieren. Eine VM bleibt bestehen bis sie gelöscht wird. Ein Snapshot ist ein Festplattenzustands-Checkpoint, der bei gestoppter VM erstellt wird, und ein Branch forks eine beschreibbare Festplatte davon ab, um abweichende Aktionen auszuführen. Die vollständige API-Referenz und ausführbare Beispiele finden Sie in [`tools/headless-api/`](https://github.com/jamesstringer90/appsandbox/blob/main/tools/headless-api). **Wie es funktioniert:** Dieses Repo soll auch ein funktionierendes Beispiel für die programmatische Erstellung vollständiger Desktop-VMs mit den Windows HCS/HCN-APIs und Apples Virtualization.framework sein. Unter Windows übermittelt App Sandbox ein handgebautes HCS-Maschinen-Dokument an `computecore.dll` / `computenetwork.dll` — die HCS/HCN-Schicht, die auch WSL2 und Windows Sandbox zugrunde liegt — anstatt den Hyper-V-Manager zu verwenden. GPU-Beschleunigung verwendet GPU-Paravirtualisierung (GPU-PV), um die installierte GPU des Hosts mit dem Gast zu teilen — derselbe WSL2-Pfad, kein dediziertes Passthrough (kein VFIO/IOMMU, keine zweite GPU). Windows-Gäste erhalten DirectX 12, OpenGL, Vulkan, CUDA und OpenCL; Ubuntu-Gäste dasselbe ohne DirectX; macOS-Gäste Metal. Ein benutzerdefinierter **IddCx**-Indirect-Display-Treiber und ein virtuelles Audiogerät übertragen Bild und Ton, und Gast↔Host-Zwischenablage, Audio, Eingabe und SSH laufen über **Hyper-V-Sockets**. Gast-Festplatten werden von einem In-Repo-Tool mit Unterstützung für ext4, squashfs, qcow2 und VHDX erstellt. Unter macOS verwendet App Sandbox Apples **Virtualization.framework** (`VZVirtualMachine`, `VZMacOSInstaller`) über **virtio-vsock**. Unter Windows erreichen Linux (Ubuntu)-Gäste die GPU über ein benutzerdefiniertes DRM/KMS-Kernelmodul (`asb_drm`), Microsofts WSL2 `dxgkrnl` und einen benutzerdefinierten Mesa-Build. Die Apps sind natives C / Objective-C mit einer HTML/JS-UI (WebView2 unter Windows, WKWebView unter macOS). # Tipps: Der Standardbenutzername ist `user` und das Standardpasswort ist `test123` [Windows] Hotkeys aktivieren oder das VM-Audio stummschalten: Verbinden Sie sich mit der VM und klicken Sie mit der rechten Maustaste auf die Titelleiste der Verbindung [Windows] Benötigen Sie einen hochperformanten Remote-Desktop für den Fernzugriff auf Ihre VM? [Phaze](https://phaze.app) funktioniert gut [Windows] Sie können prüfen, ob das GPU-PV-Treiber-Setup funktioniert, indem Sie gpu-test.exe in Ihrer App Sandbox Windows-VM ausführen. gpu-test.exe zeigt ein Fenster mit 6 rotierenden Würfeln, jeder verwendet eine andere Rendering-Engine (D3D9, D3D10, D3D11, D3D12, OpenGL und Vulkan). Wenn eine oder mehrere fehlschlagen, wird für diese Rendering-API kein korrekt rotierender Würfel angezeigt. [gpu-test.zip](https://github.com/jamesstringer90/appsandbox/releases/download/v0.1.2/gpu-test.zip). Hinweis: Dass die Rendering-API erfolgreich ist, bedeutet, dass GPU-PV funktioniert hat, aber manchmal sind Spiele oder Apps so programmiert, dass sie das GPU-PV-System nicht korrekt erkennen und trotzdem einen Fehler anzeigen. ## Fixes und Features teilen Vielen Dank für das Teilen von Fixes und Ideen! Pull Requests, einschließlich KI-unterstützter Änderungen aus Ihrem eigenen Fork, sind als Vorschläge willkommen. Sie werden wahrscheinlich nicht formell überprüft oder zusammengeführt, aber Beiträge, die eine Änderung mitgestalten, werden gewürdigt. Siehe die [Beitragsrichtlinien](https://github.com/jamesstringer90/appsandbox/blob/main/CONTRIBUTING.md) für Details. ## Lizenz AppSandbox ist unter der [MIT-Lizenz](https://github.com/jamesstringer90/appsandbox/blob/main/LICENSE) lizenziert — Copyright (c) 2026 James Stringer. Es bündelt Drittanbieter-Komponenten, die **nicht** von der MIT-Lizenz abgedeckt sind und ihre eigenen Bedingungen behalten — insbesondere den Microsoft WSL2 `dxgkrnl` GPU-Treiber (GPL-2.0) und den eingebetteten XZ-Decoder (0BSD). Siehe [THIRD-PARTY-NOTICES.md](https://github.com/jamesstringer90/appsandbox/blob/main/THIRD-PARTY-NOTICES.md) für die vollständige Liste. AppSandbox' eigenes Linux-DRM-Kernelmodul (`tools/linux/asb_drm/`) ist dual-lizenziert unter MIT ODER GPL-2.0, damit es die GPL-only-Symbole des Kernels auflösen kann. ## Danksagungen Neben meiner eigenen Erfahrung mit der Entwicklung von [Easy-GPU-PV](https://github.com/jamesstringerparsec/Easy-GPU-PV) fand ich [NanaBox](https://github.com/M2Team/NanaBox) eine wirklich hilfreiche Ressource zum Verständnis von HCS. ## Autor [James Stringer](https://www.linkedin.com/in/jamesstringerphotography/) — Autor von [Easy-GPU-PV](https://github.com/jamesstringerparsec/Easy-GPU-PV).
