ailoy
The open-source agent SDK that gives every agent its own VM. Each VM is a microVM sandbox where the agent installs software, runs code and uses the GPU. Python,
What is ailoy?
The open-source agent SDK that gives every agent its own VM. Each VM is a microVM sandbox where the agent installs software, runs code and uses the GPU. Python, Node.js and Rust.
Overview of ailoy
What it is
Ailoy is a library for building AI agents that gives each agent its own microVM sandbox. It supports Python, JavaScript (TypeScript), and Rust APIs, and works on Linux, Windows, and macOS. The project is under active development and its API may change between versions.
Key features
- Each agent gets a dedicated microVM sandbox to install software, run code, and use the GPU.
- Supports GPU acceleration via Vulkan (any GPU that supports Vulkan) or Metal (on Macs).
- Provides APIs in Python, Node.js, and Rust.
- Uses krun-based virtualization with no separate VM daemon to install.
- Supports multiple model providers: Claude, GPT, Gemini, Amazon Bedrock, OpenRouter, and vLLM.
- Offers both
agent.run(yields one complete message per tool loop step) andagent.run_stream(streams tokens). - Allows mounting host folders into the console's virtual filesystem (requires FUSE on macOS/Windows).
Use cases
Ailoy can be used to build agents that perform tasks such as CAD modeling, image editing, gameplay, data analysis, retail simulation, and more. The repository includes examples for: hello (one turn with no tools), cad (CadQuery rendering), offshore_leaks (SQL and Python analysis), retail_bench (supermarket simulator), gameplay (OpenTTD), sam3 (image/video segmentation with SAM3), tts (text-to-speech with Qwen3-TTS), laya (local model decision questions), and browser-use (browser automation).
Getting started
Install the required CLI for your model (Claude Code, Codex, or Gemini CLI) and log in. Alternatively, set an API key and switch to the api backend. Python: sh pip install ailoy-py Node.js: sh npm install @brekkylab/ailoy @brekkylab/virtx Rust (add to Cargo.toml): toml [dependencies] ailoy = '0.3' virtx = '0.1' For plugin marketplace installation (Claude Code or Codex): bash claude plugin marketplace add brekkylab/ailoy && claude plugin install ailoy@brekkylab codex plugin marketplace add brekkylab/ailoy && codex plugin add ailoy@brekkylab On Windows, enable the Windows Hypervisor Platform from an administrator PowerShell: powershell Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform See the repository README for full details on requirements and usage.
License and pricing
The project is licensed under Apache-2.0 and is open source.
Based on the project's public README and repository metadata.