Kun
Introduction: AI agent workspace for DeepSeek models, with Code and Claw modes built into your application.
Tags:
Kun
本地优先的 AI 工作台：写代码、做文档、和 Agent 一起推进事情。
Kun 是跑在你电脑上的桌面应用。Code、Work 和对话共用一个本地运行时：写代码、做设计、处理文档和论文，也能把任务交给不同的 Agent 协作完成。会话、记忆和设置留在本机，模型由你自己接入。
 |
 |
 |
 |
- Code / Design：项目、终端、Git 与 Diff 放在一处。先在 Design 画布中比较多屏、状态与方案，确认后再交给 Agent 实现；Claude Code、Codex 等外部 Agent 也能打开设计。
- Work / 论文：会话与文件用标签页组织，需要时分屏对照；选中文字即可改写、扩写或引用到会话，选中表格单元格可查看统计并交给 Kun 分析。独立论文库集中管理导入、阅读、笔记与相关会话。
- 对话 / Agent 协作：与个人 Agent、Codex、Claude Code、OpenCode 私聊或拉群，为计划选择执行 Agent，分派任务并查看各自的进展和结果。个人助理任务工作流可在“设置 → Lab”启用，需服务端开放并完成助理接入。
- 报告 / 产物：让 Kun 把实际数据整理成指标、图表和说明组成的报告，直接在对话里查看，并保存到产物库继续打开或更新；缩略图帮助你更快找到需要的产物。
- 连接 / 扩展：统一管理可用的 GitHub、Gmail 连接，通过 MCP / Skills、Loops 和 Extension 平台扩展工作流。本地模型网关复用同一份 Provider 配置。
还有：提醒与定时任务、存储管理、终端 TUI、手机远程、Kun 账号与衣橱。最新变化见 0.4.4 更新日志。
三步开始
- 下载安装。 从 Releases 选择对应平台的安装包。
- 连接一个模型。 首次启动的引导里填 API Key，或登录已有订阅。支持 OpenAI / Anthropic 兼容接口与本地模型，见 Provider 文档。
- 给一件具体的事。 打开一个项目文件夹交给 Code，或把资料拖进 Work。Agent 动手前会先请你确认。
| 平台 | 安装包 | 架构 |
|---|---|---|
| macOS | .dmg / .zip |
Apple Silicon / Intel |
| Windows | .exe |
x64 |
| Linux | .AppImage / .deb |
x64 |
Linux 的 .deb 请用 sudo apt install ./Kun-*.deb 安装，apt 会一并装上 libnotify4 等依赖；dpkg -i 不处理依赖，在精简系统上会装不上。
看一眼
 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。
