Kun
本地优先的 AI 工作台：写代码、做文档、和 Agent 一起推进事情。
Kun 能做什么
Kun 是跑在你电脑上的桌面应用。代码、文档和 Agent 对话共用一个本地运行时；会话、记忆和设置都留在本机，模型由你自己接入。
还有：插件与技能市场（MCP / Skills）、提醒与定时任务、终端 TUI、手机远程、Kun 账号与衣橱。完整列表见 0.4.0 更新日志。
三步开始
- 下载安装。 从 Releases 选择对应平台的安装包。
- 连接一个模型。 首次启动的引导里填 API Key，或登录已有订阅。支持 OpenAI / Anthropic 兼容接口与本地模型，见 Provider 文档。
- 给一件具体的事。 打开一个项目文件夹交给 Code，或把资料拖进 Work。Agent 动手前会先请你确认。
| 平台 | 安装包 | 架构 |
|---|---|---|
| macOS | .dmg / .zip |
Apple Silicon / Intel |
| Windows | .exe |
x64 |
| Linux | .AppImage / .deb |
x64 |
看一眼
Code · 项目、任务与改动
Work · 资料、文档与论文
本地优先，权限在你
- 数据在本机。 会话、记忆、日志存在本地；用云端模型时，只有本次请求的上下文发给你选的 Provider。
- 动手先确认。 工具、目录和工作台权限默认需要批准；记忆和群聊不会扩大权限。
- 模型随你换。 DeepSeek、Kimi、GLM、Qwen、Ollama 等预设，也可自定义 Provider。
- GUI 与 TUI 共用。 同一个
kun serve运行时，线程、计划和审批两边都能接着用。
从源码运行
需要 Node.js 22.19+。
git clone --branch develop https://github.com/KunAgent/Kun.git
cd Kun && npm ci && npm run dev
常用命令
| 命令 | 用途 |
|---|---|
npm run dev |
构建运行时并启动 Electron 开发环境 |
npm run dev:tui |
构建运行时并启动终端 TUI |
npm run typecheck |
TypeScript 类型检查 |
npm run lint |
ESLint 与文件大小检查 |
npm run test |
运行测试 |
npm run build |
生产构建 |
npm run dist:mac / dist:win / dist:linux |
构建对应平台安装包 |
中国大陆网络较慢时可加 --registry=https://registry.npmmirror.com。
终端 TUI 的两种用法
保持桌面应用运行，在项目目录连接它的运行时，与 GUI 共用线程和审批：
kun --no-start
单独使用时先退出桌面应用，再运行 kun；TUI 会启动自己的运行时，退出时一并停止。更多见 Kun TUI 文档。
文档
| 上手 | 模型 Provider · 个人 Agent 与记忆 · 终端 TUI |
| 工作台 | Code 中的 Agent 对话 · Design 画布 · 论文与证据 |
| 扩展 | MCP 与 Skills · Loops · Extension 平台 · 本地网关 |
| 开发 | 本地开发 · 运行时架构 · 贡献指南 |
参与贡献
欢迎提交 bug 修复、UI、运行时、Provider 和文档改进。PR 请以 develop 为目标分支，开始前读一下 贡献指南；外部贡献需要签署 CLA。
许可证
PolyForm Noncommercial 1.0.0，仅限学习、研究和非商业用途。商业使用、托管服务或集成进商业产品，需要作者单独书面授权。
记忆架构参考了 Nowledge Mem 公开文档中的 Thread / Memory 分离与来源追踪理念，实现保持独立。
觉得有用？点个 Star，让更多人看到 Kun。