holaOS

一个桌面空间,跑通所有 AI 智能体,共享记忆不串台

holaOS 是一个开源的 AI 智能体一体化工作空间,旨在解决多智能体工具分散、上下文割裂的问题。它允许用户在同一平台内运行 Claude Code、Codex 等任意智能体,并通过 100+ 原生集成和 MCP 协议连接各类工具、应用、浏览器和文件系统。核心能力包括共享记忆(让不同智能体共享上下文)、内置模型或自带密钥(BYOK)的灵活接入方式,以及基于 Electron 的桌面应用形态。项目采用 TypeScript 开发,处于快速成长期,适合希望统一管理多个 AI 工作流的开发者或团队。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 11351
维护状态 维护中
是否开源 是
定价模式 unknown

项目数据

分类智能体
开发团队holaboss-ai
所属国家
官网地址https://holaos.ai
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议NOASSERTION
主要语言TypeScript
技术栈/模型agent,agent-harness,agent-os,agentic,ai,ai-agent,ai-agents,artificial-intelligence,claude-code,codex,electron,holaboss,holaos,llm,mcp,memory,model-context-protocol,runtime,typescript,workspace
GitHub 星标★ 11351
30天Star增速
HF 下载量
上线时间2026-03-22 00:00:00
最近更新2026-09-22 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • macOS、Linux 或 WSL 环境(一键脚本面向全新机器引导)
  • git(可用 git --version 验证)
  • Node.js 与 npm(一键脚本会在缺失时安装 Node.js 24.14.1)
  • 仓库根目录 .nvmrc 固定了 Node 版本;使用 nvm 可选,非必需

安装与启动步骤

  1. 1一键安装

    在全新 macOS/Linux/WSL 机器上运行官方安装脚本,并加 --launch 参数直接启动桌面应用。

    curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch
  2. 2检查本地依赖

    手动安装前先确认 git、node、npm 版本可用;若已用 nvm,可在仓库根目录执行 nvm use 切换版本。

    git --version
    node --version
    npm --version
  3. 3安装桌面依赖

    在仓库根目录安装桌面端所需依赖,这是本地桌面开发的基础安装流程第一步。

    npm run desktop:install
  4. 4创建环境文件

    从模板复制本地环境文件,按需修改;规范路径是 apps/desktop/.env,请尽量贴近模板只改必要值。

    cp apps/desktop/.env.example apps/desktop/.env
  5. 5准备运行时包

    生成本地运行时 bundle。若要改用已发布的运行时产物,可执行 npm run desktop:prepare-runtime。

    npm run desktop:prepare-runtime:local
  6. 6类型检查校验

    启动 Electron 前的快速校验,确认环境与代码没有明显问题。

    npm run desktop:typecheck
  7. 7启动桌面应用

    以开发模式启动。predev 钩子会校验环境、重建原生模块并确认运行时包已就位。

    npm run desktop:dev

关键配置

配置项必填说明示例
apps/desktop/.env是本地环境变量文件,由 .env.example 复制而来,供桌面端读取配置。cp apps/desktop/.env.example apps/desktop/.env

如何确认成功

执行 npm run desktop:typecheck 无报错,且 npm run desktop:dev 后 Electron 桌面窗口成功打开即启动成功。

常见问题

Q:Electron 打不开怎么办?

A:README 建议:若 Electron 无法打开,完成校验后即停止,转而查看仓库内 INSTALL.md 运行手册中的下一步手动操作。

Q:一定需要手动安装吗?

A:通常不需要。One-Line Install 会执行相同的设置流程,Manual Install 只适合想逐步检查或控制每个环节的用户。

Q:必须安装 nvm 吗?

A:不必须。仓库根目录的 .nvmrc 固定了 Node 版本,若你已在用 nvm,可在仓库根目录执行 nvm use 自动切换到该版本。

Q:运行时用本地还是已发布版本?

A:正在修改运行时代码时用 desktop:prepare-runtime:local;想用已知发布产物验证桌面端时用 desktop:prepare-runtime。

注意事项

  • 本地优先(local-first),数据不会离开你的机器。
  • 新配置请使用 apps/desktop/.env,旧的 desktop/.env 目前仍被接受但建议迁移。
  • 安装脚本默认把仓库克隆到 ~/holaboss-ai,可通过 --dir 指定其他目录。
  • 不指定 --launch 时安装脚本只做安装与校验,不会自动启动桌面应用。

核心亮点

  • 共享记忆机制让多个智能体协作时上下文连贯,避免重复输入
  • 支持 100+ 工具集成和 MCP 协议,扩展性强,覆盖主流生态
  • 内置模型和 BYOK 双模式,降低使用门槛,兼顾数据隐私

不足之处

  • Electron 架构导致内存占用较高,影响低配设备体验
  • 文档/社区待观察

适用场景

  • 开发者同时使用多个 AI 编程助手,需要统一管理上下文
  • 团队共享智能体工作流,需要集中配置工具和记忆
  • 个人用户希望在一个桌面应用中完成 AI 驱动的自动化任务

替代项目

OpenHands、AutoGPT、Dify

项目介绍

holaOS 是智能体领域的开源项目,由 holaboss-ai 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(11,351)位列前 5%,在智能体分类的 2,517 个项目里位列前 5%。

近 41 天,它的 GitHub 星标从 6,031 增加到 11,351,净增 5,320。

项目仍在小幅维护中,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:开发者同时使用多个AI编程助手,需要统一管理上下文。同类可对比的替代方案包括 OpenHands、AutoGPT、Dify。

上一篇:LobsterAI

下一篇:ouroboros

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12