Cindy - 开箱即用的开源 AI Agent 桌面端

解决什么

Cindy 解决的是 AI Agent 落地到实际工作场景的"最后一公里"问题。市面上的 AI 编程助手大多局限在代码编辑器内,而 Cindy 将能力扩展到整个操作系统层面:它能直接操作你电脑上的真实文件、驱动已登录的应用、控制浏览器甚至手机,把"想到就能做到"的 AI 助手从聊天窗口搬到了桌面环境。项目采用客户端开源(Apache-2.0)+ 云服务可选的混合模式,支持接入自有 API Key 或本地模型,也可使用官方托管服务按量计费。

为何火

该项目 7 天内获得 1083 stars,核心吸引力在于三点:一是开箱即用,不需要复杂配置就能让 AI 在本地环境干活;二是多模型编排,同一任务可由不同 harness(如 Claude Code/Codex)和模型组合完成,中途切换时工作区、记忆和技能保持连续;三是可塑造性,通过记忆系统(纠正一次永久生效)、技能库(可复用的工作流)、MCP 协议(接入内部工具)和插件市场,用户能持续训练出符合自己习惯的专属 Agent。对于担心 AI 工具"黑盒化"的开发者,客户端源码完全开放是重要加分项。

核心功能

• 多 Harness 支持:首批集成 Claude Code 和 Codex,可在任务执行中动态切换模型和执行引擎,原生 harness 正在开发中
• 跨设备操作:通过 Electron 桌面端和 React Native 移动端,驱动浏览器、电脑和 Android 手机(需 platform-tools)
• 记忆与技能系统:纠正后的行为会跨 harness 持久化;可定义可复用的工作流技能,团队共享功能规划中
• 自动化调度:重复性任务可设定计划自动执行并汇报结果
• 灵活接入模型:支持官方服务(透明扣费)、复用已有 Claude Code/Codex 订阅(无重复计费)、自有 API Key 或本地模型
• MCP 协议:可接入企业内部工具和业务系统,扩展 Agent 能力边界

安装

需要 Node.js 22.x、pnpm 10.x 和 Git LFS。克隆仓库后初始化协议子模块:

git clone https://github.com/makecindy/cindy.git
cd cindy
git submodule update --init --recursive cindy-protocol
git lfs pull
pnpm install

开发启动(中国大陆用户):

pnpm restart:desktop:remote --region=cn

全球用户将 --region=cn 改为 --region=global。登录界面的"本地模式"是无需账号的本地 Agent 模式,但服务端能力(如云端同步)不可用。桌面端会从官方 CDN 自动更新,移动端需通过 Expo 构建。

适合谁

• 效率工具重度用户:需要 AI 助手跨应用协同工作,而非局限在单一编辑器内
• 注重隐私的开发者:本地运行 + 客户端开源,可审计数据流向
• 企业定制需求:通过 MCP 接入内部系统,用技能库沉淀团队最佳实践
• AI 工具探索者:想尝试多模型编排和 Agent 可塑造性的前沿玩法

不适合纯 Web 开发场景(Cursor/Windsurf 更专注),也不适合期望完全离线运行的用户(后端服务未开源,本地模式功能受限)。

社区评价

⚠️ 注意:HN 讨论数据指向的是 CindyJS(数学可视化框架),与本项目 Cindy(AI Agent)完全无关,属数据匹配错误。以下为基于项目本身的中立评估:

项目在 GitHub 上线 7 天即获千星关注,issues 数量(306 个)反映出早期用户活跃但也暴露稳定性问题。从 README 和架构文档看,开发团队在工程规范上投入较多(DCO 签名、详细的贡献指南、模块边界文档),但后端服务闭源可能引发部分开源社区用户的顾虑。技术栈选择(Electron + React Native)保证了跨平台能力,但也继承了 Electron 的资源占用问题。多 harness 编排是亮点,但实际稳定性和切换成本需长期验证。

选型对比

vs Cursor/Windsurf(商业 AI 编程工具):Cindy 的操作范围更广(不限于代码编辑器),支持驱动浏览器和手机,且客户端开源可定制。但 Cursor 在代码补全和 IDE 集成上更成熟,Windsurf 的 Cascade 多 Agent 协作也有独特优势。Cindy 适合需要跨应用自动化的场景,Cursor 适合纯编程工作流。

vs AutoGPT/BabyAGI(开源 Agent 框架):Cindy 提供开箱即用的桌面客户端和 UI,AutoGPT 更偏框架需自行搭建。Cindy 的记忆和技能系统更工程化,但 AutoGPT 的插件生态更开放(虽然质量参差不齐)。

商用限制:客户端 Apache-2.0 可商用,但依赖官方云服务时需付费;本地模式功能受限,后端未开源意味着无法完全自托管。

已知坑

1. 后端依赖:客户端开源但后端服务闭源,本地模式下云端同步、团队协作等功能不可用,完全自托管无法实现
2. 区域账号隔离:中国大陆和全球账号系统分离(--region=cn vs --region=global),选错区域会导致登录失败
3. 高 issue 数:306 个 open issues 反映早期版本稳定性问题,生产环境使用需谨慎
4. 资源占用:Electron 架构 + 多模型运行,对内存和 CPU 要求较高
5. Android 依赖:Windows 打包时需下载 Android platform-tools(固定版本 + sha256 校验),网络环境不佳可能失败
6. pnpm 版本锁定:仅支持 pnpm 10.x,v11 不兼容,依赖管理需注意版本
7. Git LFS 必需:二进制文件通过 LFS 管理,未安装会导致构建失败

来源: GitHub makecindy/cindy + 项目 README + 架构文档