
appsandbox v0.1.5
Créez facilement des machines virtuelles complètes en bac à sable pour le développement ou les modèles d'utilisation informatique.
App Sandbox
App Sandbox est une application de machine virtuelle pour Windows et macOS axée sur les performances et la facilité d'utilisation.
Fonctionnalités Windows :
- Fonctionne sur Windows 11 Famille ou Pro, sans Hyper-V
- Prise en charge des machines virtuelles Windows 11 ou Ubuntu 26.04 LTS
- Installation sans intervention
- Copier-Coller
- Audio 2 canaux
- Accélération GPU via la para-virtualisation (GPU-PV) avec prise en charge de DirectX 12 (Windows uniquement), OpenGL, Vulkan, CUDA, OpenCL
- Prise en charge du décodeur/encodeur vidéo matériel GPU
- SSH via proxy de socket Hyper-V (aucun réseau requis)
- Instantanés
- Affichage fixe 1080P60
- Prise en charge des touches de raccourci hôte vers client
- Provisionner et démarrer avec ou sans internet
- Prend en charge l'exécution de Claude Cowork et Docker à l'intérieur de la VM grâce à la prise en charge de la virtualisation imbriquée
- Mode headless : une API HTTP/JSON locale scriptable + SDK Python sans dépendance (
asb.py) pour créer et piloter des VM accélérées GPU par programmation
Fonctionnalités Mac :
- Prise en charge des machines virtuelles macOS ou Windows 11 ARM
- Installation sans intervention pour Windows 11, macOS comporte 3 étapes d'installation obligatoires
- Copier-Coller
- Audio 2 canaux
- macOS : Accélération GPU via la para-virtualisation avec prise en charge de Metal, Windows : Pas d'accélération GPU
- SSH via virtio-vsock (aucun réseau requis)
- Affichage fixe 1080P60 sur les invités Windows 11, dimensionnement dynamique de l'affichage sur les invités macOS
- Provisionner et démarrer avec ou sans internet
- Mode headless : la même API HTTP/JSON locale scriptable + SDK Python (
asb.py) que sous Windows, pour piloter les VM macOS et Windows 11 par programmation
Configuration requise : Windows 11 avec un processeur x64 ou macOS Tahoe (série M)
À propos d'App Sandbox
App Sandbox crée et exécute des machines virtuelles de bureau complètes — Windows 11, Ubuntu et
macOS. Il est gratuit et open-source (MIT), distribué sous forme de binaires précompilés (signés EV sous
Windows, signés Apple Developer sous macOS) sur sa page
Releases. Il est piloté de deux
manières : via une interface graphique, ou par programmation via un démon headless avec un
SDK Python sans dépendance (asb.py). Dans les deux cas, vous choisissez un système
d'exploitation, pointez vers une image d'installation, et App Sandbox provisionne le disque,
exécute une installation sans intervention et démarre l'invité. Vous fournissez une ISO
Windows ou Ubuntu ; les invités macOS téléchargent leur image de restauration automatiquement.
Il fonctionne sur un PC Windows 11 (x64) ou un Mac Apple Silicon, y compris les ordinateurs portables.
Fonctionne sur Windows 11 Famille, sans Hyper-V. Sous Windows, App Sandbox n'utilise pas Hyper-V ni le Gestionnaire Hyper-V ; il crée et exécute les VM via les API Windows Host Compute System (HCS) et Host Compute Network (HCN), qui nécessitent uniquement la fonctionnalité Virtual Machine Platform. Hyper-V est limité à Windows 11 Pro et Entreprise, tandis que Virtual Machine Platform est disponible sur Windows 11 Famille, donc une licence Windows 11 Pro n'est pas requise. Virtual Machine Platform est la même fonctionnalité Windows qu'utilise WSL2.
À quoi ça sert :
- Une VM de bureau complète Windows ou Ubuntu — un système d'exploitation graphique complet avec accélération GPU (OpenGL, Vulkan, CUDA) — pour construire et tester votre propre logiciel sur une installation propre.
- Exécuter un programme dans une VM, séparé de votre système d'exploitation principal et de vos fichiers.
- Développer et tester des pilotes Windows : un Mode Test intégré permet la signature de test à l'intérieur de l'invité, de sorte que le Secure Boot et la configuration de démarrage de l'hôte restent inchangés.
- Exécuter un agent IA d'utilisation d'ordinateur (comme le modèle d'utilisation d'ordinateur de Claude) dans sa propre VM. App Sandbox fournit le bureau et la VM ; la boucle de modèle propre de l'agent s'exécute à l'intérieur de l'invité. Plusieurs agents peuvent s'exécuter simultanément, chacun dans sa propre VM, sur un seul ordinateur portable ou de bureau.
- Créer des VM accélérées GPU (GPU-PV), depuis l'interface graphique ou l'API headless.
- Scripter le cycle de vie des VM depuis du code — créer, instantané, bifurquer, SSH dans, et supprimer des VM accélérées GPU — avec le SDK Python.
API Headless.
appsandbox.exe --headless
(ou sudo /Appsandbox.app/Contents/MacOS/AppSandbox --headless sur macOS) démarre un
démon à propriétaire unique qui héberge le même noyau que l'interface graphique et l'expose comme une
API HTTP/JSON locale de style Docker sur 127.0.0.1, identique sur les deux plateformes. Le SDK Python
uniquement basé sur la bibliothèque standard (asb.py) l'encapsule : créé des VM accélérées GPU (GPU-PV est une option
de création gpuMode), SSH via une clé déployée automatiquement (invités Windows, Ubuntu ou macOS), prend des instantanés
et les bifurque, ouvre l'affichage en direct, et en exécute plusieurs à la fois — le nombre d'exécutions simultanées est limité par le CPU,
la RAM et la mémoire GPU de l'hôte, non par une limite fixe. Le démon est mono-hôte — il pilote les VM sur la
machine où il s'exécute et ne provisionne pas de VM cloud ; pour l'IC, exécutez-le sur un exécuteur auto-hébergé.
Le provisionnement d'une VM exécute une installation sans intervention complète ; les instantanés, les branches et les modèles
(Windows uniquement) créent une nouvelle VM à partir d'un état provisionné au lieu de réinstaller. Une VM persiste
jusqu'à sa suppression. Un instantané est un point de contrôle de l'état du disque pris VM arrêtée, et une branche
forke un disque inscriptible à partir de celui-ci pour exécuter des actions divergentes. La référence complète de l'API et des exemples
exécutables se trouvent dans tools/headless-api/.
Comment ça marche : ce dépôt vise également à être un exemple fonctionnel de création de VM de bureau complètes
par programmation avec les API Windows HCS/HCN et Virtualization.framework d'Apple. Sous
Windows, App Sandbox soumet un document HCS machine construit à la main à computecore.dll /
computenetwork.dll — la couche HCS/HCN qui sous-tend également WSL2 et Windows Sandbox —
plutôt que de passer par le Gestionnaire Hyper-V. L'accélération GPU utilise la para-virtualisation GPU
(GPU-PV) pour partager le GPU installé de l'hôte avec l'invité — le même chemin que WSL2, pas un
pass-through dédié (pas de VFIO/IOMMU, pas de deuxième GPU). Les invités Windows obtiennent DirectX 12, OpenGL,
Vulkan, CUDA et OpenCL ; les invités Ubuntu les mêmes moins DirectX ; les invités macOS Metal. Un pilote d'affichage
indirect IddCx personnalisé et un périphérique audio virtuel transportent l'écran et le son, et le
presse-papiers, l'audio, l'entrée et SSH invité↔hôte s'exécutent via des sockets Hyper-V. Les disques
invités sont construits par un outil du dépôt avec prise en charge d'ext4, squashfs, qcow2 et VHDX. Sous macOS, App
Sandbox utilise Virtualization.framework d'Apple (VZVirtualMachine, VZMacOSInstaller)
via virtio-vsock. Sous Windows, les invités Linux (Ubuntu) accèdent au GPU via un module
noyau DRM/KMS personnalisé (asb_drm), le dxgkrnl de Microsoft WSL2, et une construction Mesa personnalisée. Les
applications sont en C / Objective-C natif avec une interface HTML/JS (WebView2 sous Windows, WKWebView sous macOS).
Astuces :
[Windows] Activer les raccourcis clavier ou couper le son de la VM : connectez-vous à la VM et faites un clic droit sur la barre de titre de la connexion
[Windows] Besoin d'un bureau à distance haute performance pour accéder à distance à votre VM ? Phaze fonctionne bien
[Windows] Vous pouvez vérifier si la configuration du pilote GPU-PV fonctionne en exécutant gpu-test.exe dans votre VM Windows App Sandbox ; gpu-test.exe affichera une boîte avec 6 cubes en rotation, chacun utilisant un moteur de rendu différent (D3D9, D3D10, D3D11, D3D12, OpenGL et Vulkan). Si un ou plusieurs échouent, ils n'afficheront pas correctement un cube en rotation pour cette API de rendu. gpu-test.zip. Remarque : le succès de l'API de rendu signifie que le GPU-PV a fonctionné, mais parfois les jeux ou applications sont codés de telle manière qu'ils ne détectent pas correctement le système GPU-PV et affichent encore une erreur.
Licence
AppSandbox est sous licence MIT License — Copyright (c) 2026 James Stringer.
Il intègre des composants tiers qui ne sont pas couverts par la licence MIT et
conservent leurs propres conditions — notamment le pilote GPU dxgkrnl de Microsoft WSL2
(GPL-2.0) et le décodeur XZ intégré (0BSD). Voir
THIRD-PARTY-NOTICES.md pour la liste complète. Le module noyau DRM
Linux propre à AppSandbox (tools/linux/asb_drm/) est sous double licence MIT OU
GPL-2.0 afin de pouvoir résoudre les symboles GPL-only du noyau.
Remerciements
Au-delà de ma propre expérience dans la construction de Easy-GPU-PV, j'ai trouvé NanaBox une ressource très utile pour comprendre HCS.
Auteur
James Stringer — auteur de Easy-GPU-PV.