项目说明
项目概述
openhanako(liliMozi/openhanako)是一款定位于【开源软件】领域的开源项目。 一个有记忆、有灵魂的私人 AI 助理 记忆 — 结合主流的记忆方案,自己又发挥了一下,做了个记忆系统,近期的事情记得非常牢固,但目前确实有待优化。 人格 — 不是千篇一律的"AI 助手"。通过人格模板和自定义人格文件塑造独特的性格,每个 Agent 都有自己的说话方式和行为逻辑,Agent 之间分离做得很好,备份方便,Agent 就是文件夹,后续还会添加备份功能。 工具 — 读写文件、执行一次性命令或持续终端会话、浏览网页、通过浏览器后端或 API 搜索互联网、截图、分段长截图、媒体预览、检查网页。能力覆盖日常办公的绝大多数场景。也可以通过 server-first CLI 连接同一个 HanaAgent Server,在终端里查看状态、列会话和继续对话。 SKILLS 支持 — 内置兼容庞大 SKILLS 社区生态,之外,我也做了一些主动的优化:有时候干活之前,Agent 会从 GitHub 安装社区技能,Agent 也可以自己编写并学会新技能,有比较不错的主动性。当然,默认情况给 Agent 做了比较严格的 SKILLS 审核,如果发现 SKILLS 装不上可以自行关闭。 项目核心采用 TypeScript 语言工程架构,基于 Apache-2.0 开放协议分发,已在 GitHub 收获超过 6,876 颗星标关注,具备良好的工程规范与活跃的开源生态协同。
一个有记忆、有灵魂的私人 AI 助理 记忆 — 结合主流的记忆方案,自己又发挥了一下,做了个记忆系统,近期的事情记得...
主要功能
- 现代化全栈架构与模块解耦:采用严格的类型安全校验与现代化前端/Node 架构模式,代码分层清晰,模块解耦易于长期维护演进。
- 模块化解耦与可扩展设计:系统内部逻辑高度模块化解耦,提供清晰的配置入口与扩展插槽,便于根据团队实际需求灵活定制二次功能。
- 纯正开源与无商业锁定:采用 Apache-2.0 许可协议完全开放源代码,无任何隐藏商业收费或强制绑定,保护长期技术投入。
- 稳定可靠与开箱即用:经过工程实践检验的健壮架构与详尽配置支持,兼顾开发测试阶段的轻量便捷与生产环境的长期稳定运行。
适用人群
- 开发工程师与全栈开发者:用于技术调研选型、本地业务系统集成,或基于开放源码进行二次开发与深度定制。
- DevOps 与系统运维团队:满足企业内网或私有云自托管交付,借助容器化或独立二进制实现轻量部署与稳定运维。
- 极客、效率工具玩家与独立开发者:替代繁重昂贵的商业闭源套件,获得 100% 数据掌控权、纯粹无广告的使用体验与自由定制乐趣。
快速上手
# 克隆仓库并进入目录
git clone https://github.com/liliMozi/openhanako.git
cd openhanako
# 安装项目依赖
npm install # 或 pnpm install / yarn
# 启动本地开发服务
npm run dev- 克隆项目仓库到本地,并进入项目根目录。
- 确保本地已安装 Node.js 环境,执行 npm install 安装所有工程依赖包。
- 执行 npm run dev 开启本地热重载开发调试服务,在浏览器中预览效果。
核心优势
- 100% 开源透明,彻底摆脱厂商锁定:完全采用 Apache-2.0 许可协议开源,代码逻辑清晰且经受全网社区推敲,企业拥有绝对的代码修改权与数据控制权,避免闭源产品的涨价与停运风险。
- 庞大而活跃的开源社区生态支撑:在 GitHub 汇聚了 6,876 开发者星标认可 与持续的版本迭代,Issue 交流活跃,具备长远的工程生命力与演进保障。
- 灵活的架构扩展与私有化交付能力:设计上高度解耦,既能够以极低资源开销在单机测试环境中快速启动,也支持通过容器与微服务架构无缝接入生产集群环境。
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows、macOS、Linux (Ubuntu / Debian / CentOS / Arch) |
| 运行环境 | Node.js 18.0+ LTS 或更高版本,建议搭配 npm / pnpm |
| 组件与依赖 | TypeScript 运行或编译环境 |
注意事项
- 建议在生产部署时配置反向代理(如 Nginx / Caddy)并配置 SSL 证书以保障通信安全。若项目涉及外部 API 凭据,请严格使用环境变量管理,切勿明文提交至公共代码库。

暂无用户评价
快来发表第一条使用心得或踩坑建议吧!