
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 la performance et la facilité d'utilisation.
Fonctionnalités Windows :
- Fonctionne sur Windows 11 Famille ou Pro, sans Hyper-V
- Prise en charge des VM Windows 11 ou Ubuntu 26.04 LTS
- Installation sans intervention
- Copier-coller
- Audio 2 canaux
- Accélération GPU via paravirtualisation (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 raccourcis clavier hôte vers client
- Provisionnement et démarrage avec / sans internet
- Prend en charge l'exécution de Claude Cowork et Docker dans la VM grâce à la prise en charge de la virtualisation imbriquée
- Mode headless : une API HTTP/JSON locale scriptable + un SDK Python sans dépendances (
asb.py) pour créer et piloter des VM accélérées par GPU par programmation
Fonctionnalités Mac :
- Prise en charge des VM macOS ou Windows 11 ARM
- Installation sans intervention pour Windows 11, macOS a 3 étapes d'intégration non ignorables
- Copier-coller
- Audio 2 canaux
- macOS : accélération GPU via paravirtualisation avec prise en charge de Metal, Windows : aucune 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
- Provisionnement et démarrage avec / sans internet
- Mode headless : la même API HTTP/JSON locale scriptable + SDK Python (
asb.py) que sur Windows, pour piloter des VM macOS et Windows 11 par programmation
Prérequis : 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 sur
Windows, signés Apple Developer sur macOS) sur sa page
Releases. Il se pilote de deux
manières : depuis une interface graphique, ou par programmation via un démon headless avec un
SDK Python sans dépendances (asb.py). Dans les deux cas, vous choisissez un OS, le pointez vers une image
d'installation, et App Sandbox provisionne le disque, exécute une installation sans surveillance et démarre
l'invité. Vous fournissez un 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. Sur Windows, App Sandbox n'utilise pas Hyper-V ni Hyper-V Manager ; il crée et exécute des VM via les API Windows Host Compute System (HCS) et Host Compute Network (HCN), qui ne nécessitent que la fonctionnalité Virtual Machine Platform. Hyper-V est limité à Windows 11 Pro et Enterprise, 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 que celle utilisée par WSL2.
Ce à quoi il peut servir :
- Une VM bureau Windows ou Ubuntu complète — un OS graphique complet avec accélération GPU (OpenGL, Vulkan, CUDA) — pour compiler et tester vos propres logiciels sur une installation propre.
- Exécuter un programme dans une VM, isolé de votre OS et de vos fichiers principaux.
- Développer et tester des pilotes Windows : un Mode Test intégré active la signature de test dans 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 computer use de Claude) dans sa propre VM. App Sandbox fournit le bureau et la VM ; la boucle de modèle propre à l'agent s'exécute dans 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 par GPU (GPU-PV), depuis l'interface graphique ou l'API headless.
- Scripter le cycle de vie des VM depuis le code — créer, prendre un instantané, créer une branche, se connecter en SSH, et supprimer des VM accélérées par 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 cœur 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 utilisant uniquement la bibliothèque standard
(asb.py) l'enveloppe : créez des VM accélérées par GPU (GPU-PV est une option de création gpuMode), connectez-vous en SSH
via une clé déployée automatiquement (invités Windows, Ubuntu ou macOS), prenez des instantanés et créez des branches,
ouvrez l'affichage en direct, et exécutez-en 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,
et non par une limite fixe. Le démon est mono-hôte — il pilote des VM sur la machine sur laquelle il s'exécute et ne provisionne pas de VM cloud ;
pour la CI, exécutez-le sur un runner auto-hébergé. Le provisionnement d'une VM exécute une installation sans surveillance complète ; les instantanés, branches et modèles
(Windows uniquement) démarrent 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 avec la 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 aussi à être un exemple fonctionnel de création de VM de bureau complètes
par programmation avec les API Windows HCS/HCN et le Virtualization.framework d'Apple. Sur
Windows, App Sandbox soumet un document de machine HCS 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 Hyper-V Manager. L'accélération GPU utilise la paravirtualisation GPU
(GPU-PV) pour partager le GPU installé de l'hôte avec l'invité — le même chemin que WSL2, et non un
passthrough dédié (pas de VFIO/IOMMU, pas de second GPU). Les invités Windows obtiennent DirectX 12, OpenGL,
Vulkan, CUDA et OpenCL ; les invités Ubuntu la même chose 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, les entrées et le SSH entre invité et hôte passent par des sockets Hyper-V. Les disques des invités sont
construits par un outil du dépôt avec prise en charge de ext4, squashfs, qcow2 et VHDX. Sur macOS, App
Sandbox utilise le Virtualization.framework d'Apple (VZVirtualMachine, VZMacOSInstaller)
via virtio-vsock. Sur Windows, les invités Linux (Ubuntu) accèdent au GPU via un module noyau DRM/KMS personnalisé
(asb_drm), le dxgkrnl de WSL2 de Microsoft, et une compilation Mesa personnalisée. Les
applications sont en C / Objective-C natif avec une interface HTML/JS (WebView2 sur Windows, WKWebView sur macOS).
Astuces :
Le nom d'utilisateur par défaut est user et le mot de passe par défaut est test123