gugu咕咕的客户端和社区后端都是开源的：客户端在 GitHub 的 OpenDCAI/gugu，后端在 OpenDCAI/gugu-supabase。后端跑在你自己的 Supabase 项目上，账号、消息和文件都存在你自己那里。Supabase 免费版就够一个小团队用。
逐步操作见后端仓里的英文指南 docs/self-hosting.md，这里只讲要准备什么、大致怎么走。
社区版有什么
- 邮箱验证码登录、联系人、好友申请
- 私聊和群聊，群里可以拉 Agent，消息实时到达
- 附件，存在你自己的 Supabase Storage 里
- 本机 Agent 会话，用你自己电脑上 Claude Code、Codex 等工具的登录
社区版没有什么
- 官方云托管（云电脑）
- 官方模型、会员和支付
- 远程隧道中转（从别的电脑开这台机器的终端、浏览器）
- 多人协同编辑文件，除非你另外部署后端仓里的文件服务
要准备的
- 一个 Supabase 账号，再为咕咕新建一个空项目，不要和别的数据混用。
- 一个 Supabase 个人访问令牌。在账户的 Access Tokens 页生成，范围只选这个项目。令牌只放在自己电脑上，不要发给别人，也不要提交进代码。
- 一个 SMTP 发信服务，比如 Resend、Brevo、AWS SES。咕咕靠邮件里的 6 位验证码登录；Supabase 自带的发信每小时只能发 2 封，只发给你组织里的成员，所以必须用自己的 SMTP。邮件里的验证码由部署脚本写进邮件模板；免费版用自带发信时不允许改模板，所以也要先配好 SMTP。配置步骤见后端仓的 docs/self-hosting-smtp.md。
- 电脑上装好 Git、Node 24 和 pnpm 10.28.2；Mac 还要装 Xcode 命令行工具。
大致步骤
- 在 Supabase 后台打开自定义 SMTP，填上发信服务给的地址和账号。
- 下载两个仓库，在后端仓运行 pnpm run setup。它会装好数据库、云函数、存储和实时推送，并把连接信息写进客户端目录。注意不是 pnpm setup，那是 pnpm 自带的另一个命令。
- 在客户端仓依次运行 pnpm install、pnpm rebuild:native，再用 scripts/dev-app.sh 启动。
- 用邮箱收验证码登录，新建会话选一个装好的 Agent，就能开始用了。
免费版会碰到的限制
- 项目一周没人用会被暂停，到 Supabase 后台点恢复就行。
- 数据库 500 MB、文件存储 1 GB，单个附件不超过 25 MB。
- 同时在线的实时连接 200 个。
遇到问题，先看后端仓的 docs/self-hosting-free-plan.md，里面按「现象 → 原因 → 怎么办」列了常见问题。