holaboss-ai/holaOS
holaOS 是 holaboss-ai 发布的 MIT 开源 agent 计算机项目，基于 Electron、TypeScript 和 Node.js 24.14.1，当前支持 macOS，Windows/Linux 开发中，提供共享 browser、文件、apps、memory 与 runtime 环境，可通过脚本或手动流程安装。
holaOS
holaOS 是一台面向任何数字工作的开放 agent 计算机。它将计算机重新构想为一个共享环境，让人类和 AI agents 并肩工作——完整访问同一个 browser、文件和 apps，就像与一位能力很强、并且会持续学习如何更好配合你的队友协作。工作不再分散在彼此割裂的工具和上下文中，而是统一存在于一个地方；memory、execution 和 goals 保持连贯，因此工作不会被重置，也不会丢失状态。Agents 在这个环境中持续运行，随时间演进，同时保持完全可检查；你还可以通过 roles 和 templates 塑造它们，以支持一致、可重复的工作方式。
目录
- 快速开始
- 你需要什么
- 一行命令安装
- 文档
- 手动安装
- 一行 agent 设置
- 贡献
- OSS 发布说明
快速开始
一行命令安装
如需在 macOS、Linux 或 WSL 上对一台新机器进行 bootstrap，请使用 repository installer：
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch
如果你想控制每个设置步骤，也可以走手动路径。
给 Repository 点 Star
文档
更深入的技术和产品文档都在 holaos.ai/docs：
| 部分 | 涵盖内容 |
|---|---|
| 概览 | environment-engineering 论点和 system model 的合并入口页 |
| 快速开始 | 获得可用本地 desktop environment 的最快路径 |
| Workspaces | workspaces 如何创建、切换、管理，以及如何在磁盘上表示 |
| Environment Engineering | holaOS 背后的核心论点，以及为什么 environment 定义了 system |
| Concepts | workspaces、runtime、memory 和 outputs 的核心 system 词汇 |
| Workspace Model | Workspace contract、authored surfaces，以及 runtime-owned state |
| Memory and Continuity | 持久 memory、continuity artifacts，以及长时程 resume 行为 |
| Agent Harness | runtime 内部稳定的 harness 边界，以及 executors 如何接入 |
| Independent Deploy | 在不使用 desktop app 的情况下运行 portable runtime |
| Build on holaOS | 面向 desktop、runtime、apps、templates 和 validation paths 的代码真实开发者地图 |
| 开始开发 | 用于 desktop 和 runtime validation 的本地开发者路径 |
| Runtime APIs | 面向 workspaces、runs、streaming 和 app lifecycle 的 runtime 操作界面 |
| 构建你的第一个 App | 在 holaOS 之上构建 workspace apps |
| 参考 | environment variables 和相关参考材料 |
手动安装
你很可能不需要这一节，因为一行命令安装会运行相同的设置。只有当你想检查或控制每一步时，才使用手动安装。如果你使用手动路径，请先验证常见 prerequisites：
git --version
node --version
npm --version
一行 agent 设置
如果你使用 Codex、Claude Code、Cursor、Windsurf 或其他 coding agent，可以用一句话把设置说明交给它：
Run the holaOS install script from https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh. It should install git and Node.js 24.14.1/npm if they are missing, clone or update the repo into ~/holaboss-ai unless I specify another --dir, run desktop:install, create desktop/.env from desktop/.env.example if needed, run desktop:prepare-runtime:local and desktop:typecheck, and only run desktop:dev if I ask for --launch. If Electron cannot open, stop after verification and tell me the next manual step.
这种交接方式让安装流程保持自包含，同时把详细的 bootstrap 步骤留在 repo 本地的 INSTALL.md runbook 中。
这是本地 desktop development 的基线安装流程。
- 从 repository root 安装 desktop dependencies：
npm run desktop:install
- 创建你的本地 environment file：
cp desktop/.env.example desktop/.env
如果你严格按照 repo 操作，请让该文件尽量贴近 template，只修改你的 provider 或机器需要的值。
- 准备本地 runtime bundle：
npm run desktop:prepare-runtime:local
- 如果你想在启动 Electron 前快速做一次 validation pass，请运行：
npm run desktop:typecheck
- 以 development mode 启动 desktop app：
npm run desktop:dev
predev hook 会验证 environment、重新构建 native modules，并确保 staged runtime bundle 存在。
如果你想在打开 desktop app 前 stage runtime，常见路径有两种：
从本地 runtime 构建：
npm run desktop:prepare-runtime:local
获取最新发布的 runtime：
npm run desktop:prepare-runtime
当你正在主动修改 runtime code 时，使用本地路径。当你想用已知的 release artifact 验证 desktop 时，使用已发布的 bundle。
当你想用最快路径获得可用的本地 desktop environment 时，使用 One-Line Install。当你需要自己检查或控制每个设置步骤时，使用 Manual Install。
贡献
如果你想贡献，请先从 开始开发 入手，让本地 desktop 和 runtime loop 跑起来，然后参考 Contributing 了解 validation、commit 和 review 方面的预期。
OSS 发布说明
- License: MIT。见 LICENSE。
- Security issues：请私下报告至
admin@holaboss.ai。见 SECURITY.md。