openhanako

给 AI 装上记忆和人格，越用越懂你

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

GitHub ↗

GitHub 星标 ★ 6861

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，免费使用，定价信息待确认

项目预览

项目数据

分类智能体

开发团队liliMozi

GitHubhttps://github.com/liliMozi/openhanako

定价模式🏷️完全免费

价格说明开源项目，免费使用，定价信息待确认

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

是否开源是

开源协议Apache-2.0

主要语言TypeScript

GitHub 星标★ 6861

上线时间2026-03-15 00:00:00

代码更新2026-11-03

仓库体积163.0 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-12

浏览次数1

项目介绍

openhanako 是一个用 TypeScript 编写的个人 AI 智能体项目，核心卖点是给 AI 装上长期记忆、稳定人格和自主行动能力。它想解决的问题是：普通聊天机器人每次对话都从零开始，记不住你是谁、你的偏好和历史，也无法主动做事。openhanako 通过持久化记忆层让智能体跨会话记住用户信息，通过人格设定让回答风格保持一致，并通过自主性机制让智能体在无需逐步指令的情况下规划并执行任务。项目以个人助理为定位，适合希望拥有一个长期陪伴、越用越懂自己的 AI 助手的开发者与极客用户。技术上基于 TypeScript 生态，便于接入现有 Node.js 工具链和前端应用，也方便二次开发自定义记忆策略与人格模板。

Star 增长趋势

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

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

使用教程

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

环境要求

支持 macOS（Apple Silicon / Intel）、Windows 或 Linux 的电脑
从源码运行需安装 Node.js 与 npm（README 使用 npm 命令）
可用的模型服务：API key + base URL（OpenAI 兼容 / Anthropic 风格 / OAuth Provider / Ollama 本地
下载安装包需要访问 GitHub Releases 页面

安装与启动步骤

1下载桌面安装包

打开 Releases 页面，按系统选择安装文件：macOS 下载 .dmg，Windows 下载 .exe，Linux 下载 .AppImage 或 .deb。
2安装并打开应用

macOS 已签名公证可直接打开；Windows 首次运行可能被 SmartScreen 拦截，点“更多信息”→“仍要运行”。
3完成首次引导配置

首次启动会出现引导向导：选择语言、输入你的名字、填写模型提供商 API key 与 base URL，并选择对话/小工具/大工具三个模型。
4源码方式安装依赖

如果走源码运行，先在项目根目录（从 GitHub 仓库 https://github.com/liliMozi/openhanako 获取代码）执行依赖安装。
```
npm install
```
5启动 Electron 应用

npm start 会启动 Electron 并自动构建 renderer，适合直接当桌面应用使用。
```
npm start
```
6Vite 热更新开发

需要边改边看效果时使用；README 提示须先运行 npm run dev:renderer 再启动 Vite HMR。
```
npm run dev:renderer
npm run start:vite
```
7仅启动 server

只跑后端服务、不开 Electron 界面时使用，可用 server-first CLI 在终端连接同一台 Server。
```
npm run server
```
8运行测试

想确认代码是否正常，可在项目目录下执行测试命令。
```
npm test
```

关键配置

配置项	必填	说明	示例
`语言`	是	首次运行向导中选择界面语言	`简体中文`
`API Key`	是	模型提供商的访问密钥	`sk-xxxxxxxx`
`Base URL`	是	模型服务的接口地址	`https://api.openai.com/v1`
`对话模型`	是	承担主对话的模型	`gpt-4o`
`小工具模型`	是	处理轻量任务的模型	`gpt-4o-mini`
`大工具模型`	是	用于记忆编译和深度分析的模型	`gpt-4o`