【cindy】让 AI 智能体在你的本地设备上完成真实工作
这是一个开源的 AI 智能体客户端,目标是把多种模型、执行载体和工具整合到一个本地运行的智能体中,让它能访问真实文件、已登录的应用以及桌面、移动设备,从而完成实际项目任务。它试图解决的问题是:聊天型 AI 往往难以持续接入本地环境、工作工具和长期任务,而这个客户端希望提供一个可直接使用、可持续扩展的智能体工作台。
主要功能
- 多模型与多执行载体整合:当前支持 Claude Code 和 Codex,更多支持正在增加,原生执行载体也在开发中。
- 任务中可切换模型与执行载体:工作区、记忆、技能和工具保持连续;一个任务也可以由不同模型和执行载体组合进行规划、并行执行和审查。
- 本地运行:在你自己的设备上运行,并使用真实文件和已登录应用。
- 多端客户端:仓库包含 Electron 桌面客户端、Expo / React Native 移动客户端,以及共享能力包。
- 模型接入灵活:可使用官方云端服务、授权已有 Claude Code / Codex Coding Plan、连接自己的 API key,或使用本地模型。
- 可塑造能力:支持记忆纠正、技能复用、定期自动化任务、MCP 接入内部工具、插件扩展,以及基于源码审计、分叉和贡献。
- 设备与任务入口:可驱动浏览器、电脑和手机,也可以从即时消息和日程中接收工作。
- 开源与可定制:客户端源码采用 Apache-2.0 许可,开发者可以修改、扩展并提交贡献。
- 隐私与遥测说明:官方发行版包含产品级使用统计,但不收集聊天内容、文件内容或工作目录数据;从源码构建时可以关闭或移除相关统计。
安装与快速开始
项目对开发环境有明确要求:
- Node.js 22.x
- pnpm 10.x,v11 暂未支持
- Git LFS
最小源码入口:
git clone https://github.com/makecindy/cindy.git
cd cindy
git lfs pull
pnpm install
桌面客户端远程开发入口:
# Mainland China Cindy account
pnpm restart:desktop:remote --region=cn
# Global Cindy account
pnpm restart:desktop:remote --region=global
一些使用说明:
- 远程开发会使用你的官方云端账号和现有登录状态,方便继续已有会话。
- 登录界面可以选择 “Skip Sign-In” 使用本地 agent,但此时服务端相关能力不可用。
- 插件可通过 SkillHub 或手动安装。
- Linux 用户可参考仓库中的 Ubuntu、Arch Linux 和 Omarchy 安装指南。
适合场景与目标用户
这个项目比较适合以下场景和用户:
- 开发者工作流:希望让 AI 处理真实文件、应用和开发任务,而不是只进行简单问答。
- 已有编码工具用户:已经在使用 Claude Code 或 Codex,并希望在一个统一客户端中继续使用。
- 自动化任务:需要安排重复性工作,让智能体自动执行并返回结果。
- 内部工具接入:希望通过 MCP 等方式把内部工具、业务系统接入智能体。
- 开源定制:希望审计、修改、扩展 AI 客户端源码的开发者或技术团队。
- 多端智能体实验:对桌面端、移动端、设备联动和多模型协同感兴趣的应用开发者。
对于只想简单体验聊天机器人的普通用户来说,这个项目更偏向开发和技术使用场景,尤其是源码仓库本身更适合开发者。
总结
这个项目把“本地智能体”“多模型接入”“可扩展客户端”和“真实工作流”放在了一起,定位很清晰。它的价值不在于单一模型能力,而在于提供一个可接入文件、应用、设备和工具的开源客户端。对于开发者和技术团队来说,它适合用来构建自己的 AI 工作台;对于只想轻量聊天的用户,它可能显得过于复杂。整体来看,项目结构清晰、文档较完整,但部分能力仍在建设中,源码运行也需要一定环境准备。