开源AI工作流引擎
经 AI Skill Hub 精选评估，开源AI工作流引擎 获评「强烈推荐」。已获得 3.6k 颗 GitHub Star，这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.2 分，适合有一定技术背景的用户使用。
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
开源AI工作流引擎 依赖 JavaScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 JavaScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 开源AI工作流引擎 的版本更新，及时通知重要功能变化。
一款开源个人AI智能体框架，具备记忆、个性化和自主决策能力。支持复杂工作流编排，适合开发者构建具有持久化上下文和自主行动的AI助手。JavaScript生态，3.6k星认可度高。
开源AI工作流引擎 是一款基于 JavaScript 开发的开源工具，专注于 AI智能体、工作流、JavaScript 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
一款开源个人AI智能体框架，具备记忆、个性化和自主决策能力。支持复杂工作流编排，适合开发者构建具有持久化上下文和自主行动的AI助手。JavaScript生态，3.6k星认可度高。
开源AI工作流引擎 是一款基于 JavaScript 开发的开源工具，专注于 AI智能体、工作流、JavaScript 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：npm 全局安装 npm install -g openhanako # 方式二：npx 直接运行（无需安装） npx openhanako --help # 方式三：项目依赖安装 npm install openhanako # 方式四：从源码运行 git clone https://github.com/liliMozi/openhanako cd openhanako npm install npm start
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
openhanako --help
# 基本用法
openhanako [options] <input>
# Node.js 代码中使用
const openhanako = require('openhanako');
const result = await openhanako.run(options);
console.log(result);
# openhanako 配置说明 # 查看配置选项 openhanako --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export OPENHANAKO_CONFIG="/path/to/config.yml"
简介
<p align="center"> <img src=".github/assets/banner.jpg" width="100%" alt="OpenHanako Banner"> </p>
<p align="center"> <img src=".github/assets/Hanako-280.png" width="80" alt="Hanako"> </p>
OpenHanako
<p align="center">一个有记忆、有灵魂的私人 AI 助理</p>
<p align="center"><a href="README_EN.md">English</a></p>
---
功能特性
记忆 — 结合主流的记忆方案，自己又发挥了一下，做了个记忆系统，近期的事情记得非常牢固，但目前确实有待优化。
人格 — 不是千篇一律的"AI 助手"。通过人格模板和自定义人格文件塑造独特的性格，每个 Agent 都有自己的说话方式和行为逻辑，Agent 之间分离做得很好，备份方便，Agent 就是文件夹，后续还会添加备份功能。
工具 — 读写文件、执行一次性命令或持续终端会话、浏览网页、通过浏览器后端或 API 搜索互联网、截图、分段长截图、媒体预览、检查网页。能力覆盖日常办公的绝大多数场景。也可以通过 server-first CLI 连接同一个 Hana Server，在终端里查看状态、列会话和继续对话。
SKILLS 支持 — 内置兼容庞大 SKILLS 社区生态，之外，我也做了一些主动的优化：有时候干活之前，Agent 会从 GitHub 安装社区技能，Agent 也可以自己编写并学会新技能，有比较不错的主动性。当然，默认情况给 Agent 做了比较严格的 SKILLS 审核，如果发现 SKILLS 装不上可以自行关闭。
角色卡与技能包 — Agent 可以导入 / 导出为本地优先的角色卡 zip，按白名单携带人格、头像、可选记忆和 Skills。Skill Bundle 是独立的技能包基础设施，可以在技能管理页分组、拖拽、成组启用，并单独导出为 zip，方便迁移和分享。
多 Agent — 创建多个 Agent，各自有独立的记忆、人格和定时任务。Agent 之间可以通过频道群聊协作，也可以互相委派任务。
书桌 — 每个 Agent 都有自己的书桌，可以放文件、写笺（类似便签，Agent 会主动读取并执行）。支持拖拽操作、文件预览和工作区文件树变更监听，是你和 Agent 之间的异步协作空间。
全屏媒体查看器 — 聊天里或书桌上的任意图片、SVG、视频，点开就是暗色遮罩的全屏预览：滚轮缩放、拖拽平移，+ / − / 0 键盘快捷，左右箭头在同会话或同目录的相邻媒体间切换。
定时任务与心跳 — Agent 可以设置定时任务（Cron），也会定期巡检书桌上的文件变化。你不在的时候，Ta 也能按计划自主工作。
安全沙盒 — 双层隔离：应用层 PathGuard 四级访问控制 + 操作系统级沙盒（macOS Seatbelt / Linux Bubblewrap / Windows restricted token）。Agent 的权限在你的掌控之中。平时可只读访问系统普通文件，写入和删除限制在工作目录与受控数据目录。Windows 命令沙盒目前是写隔离模型：读取按当前用户权限自然发生，网络也按当前用户网络权限运行；macOS / Linux 的网络隔离仍由对应平台沙盒能力决定。如果你想调整权限，可以在设置 → 安全页面修改沙盒级别；外部网络也可以配置系统代理、手动代理或直连。
插件系统 — 约定优先的可扩展插件架构。拖拽安装社区插件，插件可以贡献工具、技能、命令、Agent 模板、HTTP 路由、事件钩子、LLM Provider、页面、侧栏 Widget、配置 schema 和后台任务。路由可直接访问核心服务（PluginContext 注入），通过 Session Bus 与 Agent 对话、获取历史、管理 session。两级权限模型（restricted / full-access）保障安全。
多平台接入 — 同一个 Agent 可以同时接入 Telegram、飞书、QQ、微信机器人，在任何平台和 Ta 对话，可以远程操作电脑；Bridge 消息会带平台上下文，通知也可以回发到当前外部平台。
移动端与 LAN 前端 — Hana Server 可以托管 /mobile/ PWA，手机通过设备访问密钥或本地账号登录，查看会话、继续聊天和管理工作台文件。另一台桌面端也可以通过 LAN URL + access key 连接到已有 Hana Server，继续消费同一套会话和资源。
国际化 — 界面支持中文、英文、日文、韩文、繁体中文 5 种语言。
平台支持
| 平台 | 状态 |
|---|---|
| macOS (Apple Silicon) | 已支持（已签名公证） |
| macOS (Intel) | 已支持 |
| Windows | Beta |
| Linux | 已支持（AppImage / deb） |
| 移动端 (PWA) | v0：同一 Hana server 的手机会话与工作台访问 |
安装依赖
npm install
快速开始
下载安装
macOS（Apple Silicon / Intel）：从 Releases 下载最新 .dmg。
应用已通过 Apple Developer ID 签名和公证，macOS 应该可以直接打开。
Windows：从 Releases 下载最新 .exe 安装包。
Windows SmartScreen 提示： 安装包暂未经过代码签名，首次运行时 Windows Defender SmartScreen 可能会拦截，点击更多信息 → 仍要运行即可，未签名版本的正常现象。
Linux：从 Releases 下载最新 .AppImage 或 .deb。
首次运行
首次启动时，引导向导会带你完成配置：选择语言、输入你的名字、连接模型提供商（API key + base URL），并选择三个模型：对话模型（主对话）、小工具模型（轻量任务）、大工具模型（记忆编译和深度分析）。设置页还可以单独选择视觉模型，让文本模型通过 Vision Bridge 处理图片附件。Hanako 支持 OpenAI 兼容、Anthropic 风格、OAuth Provider 和 Ollama 本地模型等多类接入。 目前也添加了 OpenAI 的 OAuth 登录，鉴于 Anthropic 会有封号风险，所以暂时不提供。
Electron 启动（自动构建 renderer）
npm start
Vite HMR 开发（需先运行 npm run dev:renderer）
npm run start:vite
仅启动 server
npm run server
运行测试
npm test
截图
<p align="center"> <img src=".github/assets/screenshot-main.jpg" width="100%" alt="Hanako 主界面"> </p>
优质开源AI智能体框架，集记忆、个性和自主性于一身。代码活跃，社区认可度高，适合构建高级AI应用。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
- +Apache-2.0 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
AI Skill Hub 点评：开源AI工作流引擎 的核心功能完整，质量优秀。对于AI爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | openhanako |
| 原始描述 | 开源AI工作流：A personal AI agent with memory, personality, and autonomy.。⭐3.6k · JavaScript |
| Topics | AI智能体工作流JavaScript开源自主决策记忆系统 |
| GitHub | https://github.com/liliMozi/openhanako |
| License | Apache-2.0 |
| 语言 | JavaScript |
收录时间：2026-05-21 · 更新时间：2026-05-22 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。