gini-agent

越用越懂你的本地 AI 助手，记住一切，持续进化。

gini-agent 是一个本地优先、可记忆学习的个人 AI 智能体，用 TypeScript 和 Bun 构建。它解决的是通用 AI 助手缺乏长期记忆和个性化学习能力的问题，让智能体能够记住用户偏好、历史交互并不断进化。核心能力包括：基于 MCP 的工具调用、Next.js 界面、本地数据存储，以及通过记忆机制实现个性化响应。它适合作为个人助理，管理日程、检索信息、自动化任务，并随着使用越来越懂你。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2293

维护状态维护中

是否开源是

定价模式 free

项目数据

分类智能体

开发团队Open-Curiosity

所属国家

官网地址

GitHubhttps://github.com/Open-Curiosity/gini-agent

定价模式free

价格说明开源项目，MIT许可证，可自行部署，无在线服务，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent,agent-runtime,ai-agent,bun,llm,local-first,mcp,nextjs,personal-agent,typescript

GitHub 星标★ 2293

30天Star增速

HF 下载量

上线时间2026-05-05 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

macOS 或 Linux 系统（自启动目前仅 macOS 支持）
已安装 curl，可访问 raw.githubusercontent.com
本机可用端口，默认实例占用 7777 与 7778
至少一个模型供应商的凭据（OpenAI / Anthropic / Bedrock / Azure / OpenRouter / DeepSeek / 本地服务

安装与启动步骤

1一键安装

执行官方安装脚本，自动下载并安装 gini 运行时与 webapp。macOS 上还会开启自启动并打开浏览器。
```
curl -fsSL https://raw.githubusercontent.com/Open-Curiosity/gini-agent/main/scripts/install.sh | bash
```
2完成供应商配置

安装后浏览器会打开 /setup 页面，从目录中选供应商并填入所需凭据（API Key、AWS 密钥对、Azure 端点或 codex 登录态），保存即进入应用。
3手动启动（Linux 或禁用自启动）

在 Linux 上自启动不可用，或安装时用了 --no-autostart，需手动先配置再启动运行时。
```
gini setup
gini start
```
4查看访问地址

浏览器没有自动打开时，用 status 打印实际 Web URL；不要凭猜测访问端口。
```
gini status
```

5命令行配置供应商

适合脚本化或非交互配置。以 Bedrock 为例设置模型与区域，密钥另行输入；Azure 需指定端点、部署与版本。

gini provider set bedrock us.amazon.nova-pro-v1:0 --aws-region us-east-1
gini provider set azure gpt-4o --base-url https://myresource.openai.azure.com --deployment my-deployment --api-version 2024-10-21 --auth-scheme api-key

6修复 macOS 自启动

macOS 26 (Tahoe) 被 SIGKILL 后 launchd 可能不再自动重启，用该命令强制重新拉起运行时。
```
gini autostart kick
```

关键配置

配置项	必填	说明	示例
`--aws-region`	否	Amazon Bedrock 使用的 AWS 区域	`us-east-1`
`--base-url`	是	Azure OpenAI 资源端点地址	`https://myresource.openai.azure.com`
`--deployment`	是	Azure 资源上的部署名称	`my-deployment`
`--api-version`	否	Azure API 版本，默认取 GA 值	`2024-10-21`
`--auth-scheme`	否	Azure 认证方式，默认 api-key，可改 bearer 用 Entra 令牌	`api-key`
`AZURE_OPENAI_API_KEY`	是	Azure OpenAI 资源密钥，从环境变量读取	`sk-xxxxxxxx`

如何确认成功

运行 gini status 会打印真实 Web URL，能打开 /setup 页面或访问 http://127.0.0.1:7777 即安装成功。

常见问题

Q：浏览器没有自动打开怎么办？

A：安装脚本在打开浏览器前会打印 URL，也可以运行 gini status 查看实际 Web 地址，然后手动访问。

Q：默认端口是什么？

A：名为 default 的实例固定为 :7777，运行时为 :7778；其他实例端口由哈希派生，必须用 gini status 查询，不要猜测。

Q：Linux 上怎么启动？

A：自启动目前仅支持 macOS。Linux 上先执行 gini setup 完成交互配置，再执行 gini start 手动拉起运行时。

Q：Mac 崩溃后智能体不再自动重启？

A：macOS 26 (Tahoe) 上 launchd 可能拒绝自动重启，执行 gini autostart kick 强制重新拉起；RunAtLoad 在登录时仍会触发。

Q：怎么停止或关闭自启动？

A：运行 gini stop 停止运行时，运行 gini autostart disable 关闭自启动；否则运行时会在重启和崩溃后保持存活。

注意事项

API 密钥通过环境变量读取，Codex OAuth 从 ~/.codex/auth.json 或 CODEX_AUTH_JSON 读取，不会写入 Gini 配置。
local 供应商兼容任何 OpenAI 格式服务端，如 oMLX、vLLM、LM Studio、llama.cpp。
更多供应商的分步说明见 docs/providers 目录下的各指南，Azure 路由契约见 docs/adr/azure-provider.md。
完整参数请运行 gini --help，不要自行臆造未知标志。

核心亮点

本地优先架构，数据隐私安全，不依赖云端
内置记忆系统，能跨会话记住用户偏好和历史
基于 MCP 协议，可扩展丰富工具生态

不足之处

项目较新，文档和社区生态待观察
Bun 运行时相对小众，部署环境可能受限

适用场景

个人知识管理与快速检索
自动化日常任务（邮件、日程、提醒）
隐私敏感场景下的本地 AI 助手

替代项目

Open Interpreter、AutoGPT、MemGPT

项目介绍

gini-agent 是智能体领域的开源项目，由 Open-Curiosity 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,293）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,711 增加到 2,293，净增 582。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。MIT许可证，可自行部署，无在线服务，完全免费。

它主要面向的使用场景是：个人知识管理与快速检索。同类可对比的替代方案包括 Open Interpreter、AutoGPT、MemGPT。

上一篇：atomic-agent

下一篇：LetsFG