
appsandbox v0.1.5
開発やコンピュータ利用モデル向けに、サンドボックス化された本格的な仮想マシンを簡単に作成できます。
App Sandbox
App Sandbox は、パフォーマンスと使いやすさに重点を置いた、Windows および macOS 向けの仮想マシンアプリです。
Windows の機能:
- Hyper-V なしで Windows 11 Home または Pro 上で動作
- Windows 11 または Ubuntu 26.04 LTS VM をサポート
- ゼロタッチインストール
- コピー&ペースト
- 2 チャンネルオーディオ
- 準仮想化による GPU アクセラレーション (GPU-PV)。DirectX 12 (Windows のみ)、OpenGL、Vulkan、CUDA、OpenCL をサポート
- GPU ハードウェアビデオデコーダー/エンコーダーをサポート
- Hyper-V ソケットプロキシ経由の SSH (ネットワーク不要)
- スナップショット
- 複数の解像度オプションと任意の動的解像度
- ホストからクライアントへのホットキーサポート
- インターネットあり/なしでのプロビジョニングと起動
- ネストされた仮想化のサポートにより、VM 内で Claude Cowork や Docker の実行が可能
- ローカル API、MCP サーバー、Python SDK
Mac の機能:
- macOS または Windows 11 ARM VM をサポート
- ゼロタッチインストール
- コピー&ペースト
- 2 チャンネルオーディオ
- macOS: 準仮想化による GPU アクセラレーション (Metal をサポート)、Windows: GPU アクセラレーションなし
- virtio-vsock 経由の SSH (ネットワーク不要)
- 動的ディスプレイサイズ変更 (Windows では任意)
- インターネットあり/なしでのプロビジョニングと起動
- ローカル API、MCP サーバー、Python SDK
要件: x64 プロセッサを搭載した Windows 11、または macOS 27 以降 (M シリーズ)
App Sandbox について
App Sandbox は、完全なデスクトップ仮想マシン — Windows 11、Ubuntu、macOS — を作成して実行します。無料のオープンソース (MIT) であり、Releases ページでビルド済みバイナリ (Windows では EV 署名済み、macOS では Apple Developer 署名済み) として配布されています。グラフィカル UI を使用するか、API、MCP サーバー、Python SDK を通じて自動化できます。OS とインストーラーイメージを選択すると、App Sandbox がディスクをプロビジョニングし、無人インストールを実行して、ゲストを起動します。Windows または Ubuntu の ISO はご自身で用意します。macOS ゲストは復元イメージを自動的にダウンロードします。Windows 11 (x64) PC または Apple Silicon Mac (ノート PC を含む) で動作します。
Hyper-V なしで Windows 11 Home 上で動作します。 Windows では、App Sandbox は Hyper-V や Hyper-V マネージャーを使用せず、Windows Host Compute System (HCS) および Host Compute Network (HCN) API を通じて VM を作成・実行します。これらに必要なのは Virtual Machine Platform 機能のみです。Hyper-V は Windows 11 Pro および Enterprise に限定されていますが、Virtual Machine Platform は Windows 11 Home でも利用できるため、Windows 11 Pro ライセンスは不要です。Virtual Machine Platform は WSL2 が使用するのと同じ Windows 機能です。
用途:
- 完全な Windows または Ubuntu のデスクトップ VM — GPU アクセラレーション (OpenGL、Vulkan、CUDA) を備えた完全なグラフィカル OS — クリーンインストール上で独自のソフトウェアをビルド・テストするため。
- メインの OS やファイルから分離した状態で、VM 内でプログラムを実行するため。
- Windows ドライバーの開発とテスト: 組み込みのテストモードによりゲスト内でテスト署名が有効になるため、ホストのセキュアブートとブート構成は変更されません。
- コンピューター操作 AI エージェント (Claude の computer use モデルなど) を専用の VM 内で実行するため。App Sandbox はデスクトップと VM を提供し、エージェント自身のモデルループはゲスト内で実行されます。1 台のノート PC またはデスクトップ上で、複数のエージェントをそれぞれ専用の VM で同時に実行できます。
- GUI またはヘッドレス API から、GPU アクセラレーション (GPU-PV) VM を作成するため。
- Python SDK を使用して、コードから VM のライフサイクルをスクリプト化する — GPU アクセラレーション VM の作成、スナップショット、ブランチ、SSH 接続、削除。
API と MCP。 App Sandbox は、Windows および macOS 上で、GUI またはヘッドレスモードにて、ローカル HTTP API、MCP サーバー、Python SDK による自動化をサポートします。セットアップと使用方法については、API、MCP、Python SDK のドキュメントを参照してください。
仕組み: このリポジトリは、Windows HCS/HCN API と Apple の Virtualization.framework を用いて、完全なデスクトップ VM をプログラムで作成する実例となることも目的としています。Windows では、App Sandbox は Hyper-V マネージャーを経由せず、手作業で構築した HCS マシンドキュメントを computecore.dll / computenetwork.dll に送信します。これは WSL2 や Windows Sandbox の基盤でもある HCS/HCN レイヤーです。GPU アクセラレーションには GPU 準仮想化 (GPU-PV) を使用し、ホストにインストールされた GPU をゲストと共有します。これは WSL2 と同じ経路であり、専用のパススルーではありません (VFIO/IOMMU なし、2 台目の GPU なし)。Windows ゲストは DirectX 12、OpenGL、Vulkan、CUDA、OpenCL を利用でき、Ubuntu ゲストは DirectX を除く同じものを、macOS ゲストは Metal を利用できます。カスタムの IddCx 間接ディスプレイドライバーと仮想オーディオデバイスが画面と音声を担い、ゲスト↔ホスト間のクリップボード、オーディオ、入力、SSH は Hyper-V ソケット 上で動作します。ゲストディスクはリポジトリ内のツールで構築され、ext4、squashfs、qcow2、VHDX をサポートします。macOS では、App Sandbox は Apple の Virtualization.framework (VZVirtualMachine、VZMacOSInstaller) を virtio-vsock 経由で使用します。Windows では、Linux (Ubuntu) ゲストはカスタム DRM/KMS カーネルモジュール (asb_drm)、Microsoft の WSL2 dxgkrnl、カスタム Mesa ビルドを通じて GPU にアクセスします。アプリはネイティブの C / Objective-C で、UI は HTML/JS です (Windows では WebView2、macOS では WKWebView)。
macOS 上の Windows ゲストは、HVF アクセラレーションを備えた QEMU 11.1.3 を使用し、公開されている asb-qemu fork からビルドされています。この fork は、macOS でのサポートやオプションの x-device-id オーバーライドを含む、当プロジェクトの 4 つの ivshmem 変更を保持しています。QEMU、そのライブラリ、ファームウェアは macOS アプリ内に同梱されています。固定されたソースと再ビルド手順については、QEMU ビルドノート を参照してください。
ヒント:
デフォルトのユーザー名は user、デフォルトのパスワードは test123 です。
既存の VM に新しい App Sandbox の機能を追加したい場合は、新しい App Sandbox バージョンをダウンロードして実行し、AI エージェントにこの プロンプト を与えてアップグレードを支援させてください。
VM が実行中で開いているとき、タイトルバーを右クリックすると、ホットキーの送信、オーディオのミュート、ウィンドウサイズの一致 (VM ディスプレイがビューアのサイズに動的にリサイズされます) など、いくつかのオプションが表示されます。
[Windows] VM にリモートアクセスするための高性能リモートデスクトップが必要ですか? Phaze はうまく動作します。
[Windows] GPU-PV ドライバーのセットアップが機能しているかどうかは、App Sandbox の Windows VM 内で gpu-test.exe を実行することで確認できます。gpu-test.exe は 6 つの回転する立方体を表示するボックスを表示し、それぞれが異なるレンダリングエンジン (D3D9、D3D10、D3D11、D3D12、OpenGL、Vulkan) を使用します。1 つ以上が失敗した場合、そのレンダリング API では回転する立方体が正しく表示されません。 gpu-test.zip。注: レンダリング API が成功することは GPU-PV が機能したことを意味しますが、ゲームやアプリのコーディングによっては GPU-PV システムを正しく検出できず、依然としてエラーが表示されることがあります。
修正と機能の共有
修正やアイデアを共有していただきありがとうございます! ご自身の fork からの AI 支援による変更を含むプルリクエストは、提案として歓迎します。正式にレビューされたりマージされたりする可能性は低いですが、変更の形成に役立つ貢献にはクレジットを付与します。詳細は コントリビューションガイドライン を参照してください。
ライセンス
AppSandbox は MIT License の下でライセンスされています — Copyright (c) 2026 James Stringer。
ゲストドライバーおよび同梱のサードパーティコンポーネントは、それぞれ独自のライセンスを保持します。これには asb-dxgkrnl、asb-mesa、QEMU が含まれます。AppSandbox の Linux DRM モジュール (tools/linux/asb_drm/) は MIT OR GPL-2.0 のデュアルライセンスです。コンポーネントのライセンスとソースリンクについては THIRD-PARTY-NOTICES.md を参照してください。
謝辞
Easy-GPU-PV を構築した自身の経験に加えて、HCS を理解する上で NanaBox が非常に役立つリソースであることがわかりました。
著者
James Stringer — Easy-GPU-PV の著者。