开源 AI Agent 操作系统，提供人机共享的桌面环境，支持持久化记忆与跨会话连续性。
holaOS 将计算机重新定义为人机共享环境，AI Agent 拥有与人类相同的浏览器、文件系统和应用访问权限。
核心特性#
- 人机共享环境：人类与 AI Agent 并行操作同一套浏览器、文件和应用，权限对等，打破传统 Agent 沙箱隔离模式
- 记忆与连续性：持久化记忆，跨会话不丢失工作状态；连续性产物与长周期恢复行为；Agent 随时间持续运行与进化
- Workspace 工作空间模型：工作空间的创建、切换与管理；磁盘表示与合约式工作空间契约；运行时自有状态管理
- Agent 框架与定制：Agent Harness 定义运行时内部稳定框架边界与 executor 嵌入方式；角色与模板系统支持一致、可重复的工作方式
- 部署灵活性：桌面应用模式（Electron，macOS / Linux / WSL）；可移植运行时可在无桌面应用的情况下独立运行
- 协议与生态：MCP（Model Context Protocol）支持；应用生态与 Marketplace BFF 层；Runtime APIs 覆盖工作空间、运行、流式传输和应用生命周期
系统架构#
系统采用分层设计：
| 层级 | 目录 | 职责 |
|---|---|---|
| 桌面层 | desktop/ | Electron 桌面应用前端，shadcn/ui + Base UI 组件库 |
| 运行时层 | runtime/ | 核心运行时引擎（TypeScript），承载 workspace、run、streaming、app 生命周期 |
| SDK 层 | sdk/ | runtime-client SDK + BFF bridge + browser-pane 脚手架 |
| 文档层 | docs/ | MDX 格式内部技术文档 |
| 脚本层 | scripts/ | 安装部署脚本，Node 版本锁定 24.14.1 |
| 网站层 | website/docs/ | 官方文档站点 |
核心概念：Environment Engineering（环境定义系统）、Workspace Model（合约、authored surfaces、运行时状态）、Memory & Continuity、Agent Harness、Runtime APIs。
安装与上手#
前置要求：git、Node.js、npm
一键安装（macOS / Linux / WSL）：
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/main/scripts/install.sh | bash -s -- --launch
手动安装：
git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS
npm run desktop:install
cp desktop/.env.example desktop/.env
npm run desktop:prepare-runtime:local
npm run desktop:typecheck
npm run desktop:dev
支持将安装指令直接交给编码 Agent（Claude Code、Cursor、Windsurf 等）执行，实现自动化环境搭建。
适用场景#
- 将日常数字工作（浏览器操作、文件管理、应用使用）委托给 AI Agent 辅助完成
- 需要跨会话保持记忆和状态的长时间运行任务
- 集成 Codex、Claude Code、Cursor、Windsurf 等编码 Agent 的开发环境
- 在 holaOS Workspace 之上构建自定义 Agent 应用与模板的开发平台
待确认信息#
- LLM Provider 完整支持清单未公开
- 官网存在 Sign-in 入口，云托管服务功能与定价待确认
- MCP 集成具体方式和已适配工具列表未详细说明
- Runtime API 具体接口签名未在公开文档中展开
- 非编码场景的 Agent 能力缺乏具体演示或案例