gini-agent

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 1056 🐛 待处理 27 👀 关注 3

GitHub ↗

GitHub 星标 ★ 2346

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可自行部署，无在线服务，完全免费。

项目预览

项目数据

分类智能体

开发团队Open-Curiosity

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 2346

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

代码更新2026-07-18

仓库体积22.2 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2346

技术标签

agent agent-runtime ai-agent bun llm

使用教程

难度：入门约 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，不要自行臆造未知标志。