
源码系统概览
文章正文
Cindy 是一个开箱即用的开源 AI 智能体,它把多个智能体框架、模型与工具收拢进同一个智能体,在你的项目与应用里完成真实工作。
它作为本地客户端运行,使用你自己的真实文件与已登录应用,开箱即用且可随时间塑造,适合想自建“会干活的 AI 助手”的开发者研究部署。
源码简介
Cindy 以 Apache-2.0 协议开源,本仓库是其开源客户端:包含桌面端(Electron)与移动端(Expo / React Native),以及它们共享的能力包,整体组织为一个 pnpm 多包仓库。
首批支持的智能体框架是 Claude Code 与 Codex,更多框架在持续加入;模型与框架可以自由组合,甚至能在任务中途切换,而工作区、记忆、技能与工具保持连续,同一个任务还能由不同框架乘模型的组合并行规划、执行与评审。
它既能驱动你的浏览器、电脑与手机,也能从即时消息与定时计划中接收任务,是一个把“智能体”落进日常工作的客户端样本。
适用场景
适合希望把 AI 助手装进自己电脑与手机的个人与团队,用来处理跨应用的重复性事务与自动化流程。
适合需要“记忆 + 技能 + 自动化”闭环的用户:纠正一次就能全局生效,教一次技能处处复用,周期性工作自动排期与回报。
适合二次开发:通过 MCP 把内部工具与业务系统接进智能体触达范围,或用插件重塑功能、界面与交互。
功能亮点
开箱即用:首次启动即可工作,支持接入官方 Cindy 云、复用已有 Claude Code / Codex 套餐、自带 API Key 或本地模型,不重复计费。
多端一体:桌面(Electron)与移动(Expo / React Native)客户端共享 packages 下的能力,登录态与记忆可在端之间延续。
持续可塑:Memory 跨框架共享,Skills 一次教会处处复用,Automation 把周期工作自我排期、自我执行、自我回报。
触达广泛:能驱动浏览器、电脑与手机,并从 IM 与定时计划接收任务,MCP 让内部工具与业务系统进入智能体能力圈。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端:React 与 React Native(桌面 Electron 端、移动 Expo 端) 后端:TypeScr |
依具体方案选型,需自行搭建与维护 |
| 部署方式 | 最小起步需要先克隆仓库并初始化公开子模块:执行 git clone 后,运行 git submodule update | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 开箱即用:首次启动即可工作,支持接入官方 Cindy 云、复用已有 Claude Code / Codex 套餐、自带 | 功能通用,定制深度有限 |
| 数据归属 | 数据自持,部署在自有服务器,不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署,无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端:React 与 React Native(桌面 Electron 端、移动 Expo 端)
后端:TypeScript 共享包(packages/*,含智能体编排、模型供应商、设备联动、MCP)
数据库:本地文件系统与 SQLite(记忆与项目存储)
运行环境:Node.js 22、pnpm 10、Git LFS,支持桌面与移动端构建
其他依赖:Claude Code、Codex 等本地智能体框架,MCP 工具与插件市场
安装与部署提示
最小起步需要先克隆仓库并初始化公开子模块:执行 git clone 后,运行 git submodule update –init –recursive cindy-protocol 与 git lfs pull,再执行 pnpm install 装好依赖。
开发桌面端可借助 pnpm restart:desktop:remote –region=cn 或 –region=global 连接已有的 Cindy 云账号继续会话;登录界面选择“Local mode”则可不登录使用本地智能体。
prerequisites 为 Node.js 22.x、pnpm 10.x(暂不支持 v11)与 Git LFS;后端官方服务在独立仓库,不在本 monorepo 内。
截图与演示说明
Cindy 以桌面与移动客户端为主界面,以下入口与能力均可在源码与本地构建后直接观察。
仓库首页主视觉展示了“开箱即用的开源 AI 智能体”定位,以及驱动浏览器、电脑、手机并从 IM 与计划接收工作的能力边界。

apps/desktop 是 Electron 桌面客户端,apps/mobile 是 Expo / React Native 移动客户端,packages/* 则是认证、设备联动、智能体编排、模型供应商等共享能力,二次开发时按目录切入即可。
登录界面的“Local mode”是无登录的本地智能体模式,仅使用本地框架;接入 Cindy 云后才能使用服务端能力,部署时可根据合规需求选择模式。
常见问题
问:Cindy 必须登录官方云服务才能用吗?
答:不必须。登录界面选择 Local mode 即可不登录使用本地智能体;服务端能力(如云端协作)才需要 Cindy 云账号。
问:它的模型和框架能混用吗?
答:可以。模型与框架自由组合,甚至能在任务中途切换,而工作区、记忆、技能与工具始终保持连续。
安全风险提示
特别提示:本源码未检测安全风险文件,下载后请务必进行安全审计,删除恶意代码后再部署使用!
补充说明:客户端会连接官方云服务并管理模型 Key 与登录态,本地模式不发送凭据;建议仅从可信来源拉取仓库,并妥善保管自己的 API Key 与第三方账号凭证。
下载说明
源码仅供学习研究、测试部署和二次开发参考,商用前请自行确认授权、版权和安全风险。
本项目以 Apache-2.0 协议开源,客户端可免费使用与修改,但涉及官方云服务条款、商标与第三方模型服务时请分别遵守对应规定。
GitHub项目开源地址:https://github.com/makecindy/cindy