Ailoy 是一个用于在自身代码中构建任意 AI 智能体的库，其核心特点是每个智能体都拥有独立的微虚拟机（microVM）沙盒。
用途
Ailoy 面向需要构建可执行复杂任务的 AI 智能体的开发者。与仅能调用预定义工具的智能体不同，Ailoy 让智能体拥有自己的“计算机”，可以在通用计算环境中安装并使用软件、创建自己的脚本，而不会触及宿主系统，除非开发者显式暴露。
主要能力
- 多语言 API 支持：提供 Python、JavaScript（TypeScript）和 Rust 三种语言的绑定。
- 跨平台运行：支持 Linux、Windows 和 macOS。
- 微虚拟机沙盒：基于 krun 的虚拟化技术，为每个智能体提供独立的虚拟机，且无需安装单独的虚拟机守护进程。
- GPU 支持：所用虚拟化支持 GPU，因此智能体可以在其虚拟机内运行机器学习模型甚至游戏（示例中运行 ML 模型需要支持 Vulkan 的 GPU，或 Mac 上的 Metal）。
- 流式输出：agent.run 在工具循环的每一步产出一条完整消息，agent.run_stream（Node.js API 为 agent.runStream）则在模型生成时逐 token 流式输出每条消息。
- 无需系统依赖：使用库本身不需要系统级依赖，但需要为智能体使用的 LLM 提供商配置 API 密钥。
- 挂载宿主文件夹：将宿主文件夹挂载到控制台（virtx 的虚拟文件系统）需要 FUSE——macOS 上安装 FUSE-T，Windows 上安装 Dokany，详见 virtx 文档。
使用方式
- 设置模型提供商的 API 密钥，可放在环境变量或 .env 文件中。
- 使用所选语言的简洁 API 构建智能体。
- 通过 agent.run 获取每一步的完整消息，或通过 agent.run_stream / agent.runStream 进行流式输出。
也可以跳过阅读文档：将编码智能体（Claude Code、Codex、Cursor 等）指向该 README，并告诉它你想构建什么智能体。该仓库本身就是一个插件市场，因此智能体技能无需克隆即可安装。
Windows 特别说明：控制台的微虚拟机运行在 Windows Hypervisor Platform 上，该功能默认关闭。需要以管理员身份在 PowerShell 中开启该可选功能并重启，同时在固件中启用虚拟化。
适用场景
- 构建需要安装软件、运行代码或使用通用计算环境的 AI 智能体。
- 在虚拟机内运行机器学习模型或 GPU 加速任务。
- 需要跨语言（Python/JS/Rust）和多平台开发的智能体项目。
- 希望智能体与宿主系统隔离、仅显式暴露必要资源的场景。
限制与注意事项
- 项目处于活跃开发阶段，API 可能随版本变化。
- 需要为所用 LLM 提供商准备 API 密钥。
- 挂载宿主文件夹需要 FUSE（macOS 用 FUSE-T，Windows 用 Dokany）。
- Windows 上需开启 Windows Hypervisor Platform 并启用固件虚拟化。
- 运行 ML 模型示例需要支持 Vulkan 的 GPU 或 Mac 上的 Metal。
- 从源码构建的具体说明暂未提供完整细节。
- 许可证为 Apache-2.0，详见 LICENSE.md。
