Gini Agent：会记忆、会学习的个人智能体
一个本地优先、会记忆会成长的个人智能体，通过审批门控和对话内交互控件，让你随时掌控它的行动。
- Star 数
- ★ 2k
- 最近更新
- 3 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 62/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要自动化个人工作流并确保敏感操作（如发送消息、购买）经过明确批准的个人用户。
- 不适合
- 只想用 Telegram/Discord 机器人、不愿装本地运行时的用户
- 非技术用户：需装 Bun、手动配置模型提供商
- 源码审查
- 62/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Gini Agent 是一个本地优先的运行时（runtime）和个人智能体，核心是一个单一 Bun 进程的网关（gateway），负责状态、对话、任务、审批、记忆等所有数据。它提供多种客户端界面：Next.js 网页应用、CLI、Expo 移动应用、MCP 接口和消息桥接。Gini 支持多种模型提供商（OpenAI、Anthropic、Bedrock、Azure、OpenRouter、DeepSeek、Codex 和本地），并默认使用本地嵌入、重排序和语音转文字。它通过审批机制保护文件、终端和代码工具，并提供对话内的安全输入控件（如密钥字段、浏览器接管确认）和发送前确认。该项目的目标是成为一个产品级的智能体，而非仅是一个聊天界面，其运行时是唯一的记录系统。
Gini 的运行时是网关，每个实例是一个 Bun 进程。它支持持久化聊天、运行、任务、审批、审计事件、作业、记忆和技能。用户可以运行 gini chat new 开始对话，gini approvals 审查待处理审批。它通过 gini provider set 配置模型提供商，或通过交互式 gini setup。Gini 支持并行实例（gini --instance sandbox run）和临时测试实例（gini smoke）。它提供命令行工具，可管理记忆、作业、连接器、提供者、快照和导入。用户可以通过 gini import apply openclaw 从 openclaw 迁移。Gini 还提供远程访问（隧道模式）和 Docker 部署。
- 需要自动化个人工作流并确保敏感操作（如发送消息、购买）经过明确批准的个人用户。
- 需要在多个设备上控制智能体，包括桌面和手机，并通过隧道远程访问的用户。
- 需要管理多个并行实例，隔离不同项目或任务环境的开发者。
- 希望从 openclaw 迁移到新平台并保留历史记录、记忆和技能的用户。
- 需要记忆和技能学习能力，让智能体从任务结果中改进的用户。
如何安装或部署这个 Agent？
安装脚本：curl -fsSL https://raw.githubusercontent.com/Open-Curiosity/gini-agent/main/scripts/install.sh | bash。macOS 安装程序自动启用自启动并打开 /setup 页面。Linux 用户需手动运行 gini setup 然后 gini start。需要设置至少一个模型提供商的 API 密钥，可通过交互式 gini setup 或 gini provider set（例如 gini provider set openai gpt-5.4-mini）。
如何使用这个 Agent？
安装后，网页端访问 http://127.0.0.1:7777，运行时 http://127.0.0.1:7778。使用 gini chat new 开始对话，gini approvals 审查审批，gini status 查看状态和 URL。更新使用 gini update。从源码运行：bun install、bun run gini install、bun run gini start。
这个 Agent 有哪些优点和局限？
- 本地优先，数据存储在你的机器上，隐私可控。
- 支持多种模型提供商，包括本地服务器，避免供应商锁定。
- 记忆和技能学习能力，智能体从任务结果中改进。
- 对话内提供安全控件（如密钥字段），敏感信息不经过模型或日志。
- 安装需要 Bun 和可能的系统级依赖，对非技术用户有门槛。
- 首屏安装向导需要手动配置模型提供商，过程可能复杂。
- 消息桥接（Telegram/Discord）标记为未积极维护，依赖它们有风险。
- macOS 26 存在启动自动重启问题，需要手动介入（
gini autostart kick）。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Gini Agent：会记忆、会学习的个人智能体 当前 | 62 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2k | 3 个月前 | TypeScript | Codex · OpenAI API · Claude API |
| somora | 69 · 存在缺口 | 命令行工具免费 | ★ 31 | 1 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| OpenHuman | 51 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 42k | 今天 | Rust | — |
| Memmy — 个人AI代理与本地记忆中枢 | 42 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 2.1k | 今天 | TypeScript | Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有审批门控、用户确认、敏感数据保护（如密钥不进入对话）、数据流透明（文档描述）、回滚（导入前归档）。但依赖安全仅部分（有补丁和信任列表，但未提供漏洞扫描证据），来源归属仅部分（有安全联系邮箱，但发布者未验证）。
自洽性良好（文档与代码结构一致），依赖可用性有锁文件和CI，失败消息有文档（如macOS Tahoe的提示）。
受众和场景明确（个人代理），能力边界有文档（如消息桥接不活跃），触发精度有CLI命令，环境适配有macOS/Linux/Docker说明。
信息架构清晰（文档索引），安装说明详细，命名稳定（版本0.3.0），示例和FAQ有，已知限制有（如macOS Tahoe），许可证MIT，版本变更日志有，维护责任部分（有安全联系但发布者未验证）。
输出可用性高（交互控制），边际价值高（记忆和学习），成本效益合理（本地模型）。
声明可追溯（文档和ADR），交叉来源部分（有CI和测试），事实与推断分离（文档区分设计意图和现状）。
- 发布者身份未验证，需谨慎对待供应链风险。
- 依赖安全仅部分证据，建议检查漏洞扫描和依赖更新策略。
- 静态审查未执行运行测试，实际行为需验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Added - Add relay device pairing: front the gateway over a tunnel and bring new web and mobile devices online through a QR-code and universal-link flow, with an operator approval dialog and a live active-sessions panel. (see ADR [device-pairing-auth.md](docs/adr/device-pairing-auth.md)) - Rebuild chat around one chat per agent with threads and channels — a thread view with a pinned parent and an also-to-main composer, a cross-agent Threads Inbox with All/Unread filters, a Channels screen, and agent-decided threading via a start_thread tool. (web, mobile) (see ADR [agent-chat-threads-and …在 GitHub 查看 ↗ -
发布说明摘录
Added - Add voice messages with on-device speech-to-text: press-and-hold recording, a playable voice bubble, a first-run model setup notice, and GET /api/stt/status. (iOS) - Add Brave and Exa web search as connector-backed providers, with an in-chat connect card and "Learn more" docs links. - Add agent self-configuration tools so the agent can manage its own setup in chat: set approval mode, edit its toolset, add or remove providers and connectors, install and rotate connectors, run runtime updates, roll back skills, rename or delete agents, and manage the approval allowlist. …在 GitHub 查看 ↗ -
发布说明摘录
Added - Initial public open-source release. See [README.md](https://github.com/Lilac-Labs/gini-agent/blob/main/README.md) for what's included and the [Roadmap](https://github.com/Lilac-Labs/gini-agent/blob/main/ROADMAP.md) for what's planned.在 GitHub 查看 ↗
常见问题
Gini 是否支持云端部署？
docs/deployment-docker.md），支持在容器内无头运行，并使用 Xvfb 提供真实浏览器。如何确保我的 API 密钥安全？
~/.codex/auth.json 读取。对话内的安全字段直接发送到网关，不经过模型或日志。Gini 是否支持多用户？
Gini 是否支持从其他平台导入数据？
gini import 命令（plan 和 apply）。