discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
KunAgent/Kun · source

Snapshot 0 · 2026-11-04T12:47:28Z · TypeScript ·
Content fingerprint
2aa0a08f2f32c48fa54ad7391dd9556692f8b4070f51c7ba99a521b02e7c6847
GitHub description at capture

Local-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.
README at capture

<p align="center">
  <img src="src/asset/img/kun.png" width="72" alt="Kun 蓝色 K 标识">
</p>

<h1 align="center">Kun</h1>

<p align="center">
  本地优先的 AI 工作台：写代码、做文档、和 Agent 一起推进事情。
</p>

<p align="center">
  <a href="https://github.com/KunAgent/Kun/releases">下载</a>
  &nbsp;·&nbsp;
  <a href="https://www.kun-agent.com/docs">文档</a>
  &nbsp;·&nbsp;
  <a href="./release/release-v0.4.4.md">更新日志</a>
  &nbsp;·&nbsp;
  <a href="./README.en.md">English</a>
</p>

<p align="center">
  <a href="https://github.com/KunAgent/Kun/releases"><img src="https://img.shields.io/github/v/release/KunAgent/Kun?label=release" alt="Kun 最新 GitHub Release"></a>
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey" alt="支持 macOS、Windows 和 Linux">
  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-PolyForm%20NC%201.0-blue" alt="Kun 使用 PolyForm Noncommercial 1.0.0 许可证"></a>
</p>

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/readme/hero-dark.webp">
    <img src="./docs/assets/readme/hero-light.webp" width="100%" alt="Kun：本地优先的 AI 工作台。桌面 Code 界面、终端 TUI 与吉祥物">
  </picture>
</p>

## Kun 能做什么

Kun 是跑在你电脑上的桌面应用。Code、Work 和对话共用一个本地运行时：写代码、做设计、处理文档和论文，也能把任务交给不同的 Agent 协作完成。会话、记忆和设置留在本机，模型由你自己接入。

<table>
  <tr>
    <td><a href="docs/DESIGN_MODE.md"><img src="./docs/assets/readme/feature-code.png" width="420" alt="Code：项目、终端、Git 与 Diff 在一处，Design 画布把原型带进代码"></a></td>
    <td><a href="docs/paper-evidence-workspace.md"><img src="./docs/assets/readme/feature-work.png" width="420" alt="Work：文档、论文和资料放在同一个工作区"></a></td>
  </tr>
  <tr>
    <td><a href="docs/code-agent-chats-and-rooms.md"><img src="./docs/assets/readme/feature-agents.png" width="420" alt="Agent 对话：和个人 Agent、Codex、Claude Code、OpenCode 私聊或拉群"></a></td>
    <td><a href="docs/provider-configuration-and-gateway.md"><img src="./docs/assets/readme/feature-models.png" width="420" alt="模型与网关：接入任意兼容 Provider，本地网关复用同一份配置"></a></td>
  </tr>
</table>

- **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 更新日志](release/release-v0.4.4.md)。

## 三步开始

1. **下载安装。** 从 [Releases](https://github.com/KunAgent/Kun/releases) 选择对应平台的安装包。
2. **连接一个模型。** 首次启动的引导里填 API Key，或登录已有订阅。支持 OpenAI / Anthropic 兼容接口与本地模型，见 [Provider 文档](docs/model-provider-presets.md)。
3. **给一件具体的事。** 打开一个项目文件夹交给 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` 不处理依赖，在精简系统上会装不上。

## 看一眼

<table>
  <tr>
    <td align="center"><img src="./docs/assets/readme/code-mode-overview.webp" alt="Code 界面：项目、任务入口与输入区"><br><b>Code</b> · 项目、任务与改动</td>
    <td align="center"><img src="./docs/assets/readme/work-mode-overview.webp" alt="Work 界面：文件树、文档与 Work 助手"><br><b>Work</b> · 资料、文档与论文</td>
  </tr>
</table>

## 本地优先，权限在你

- **数据在本机。** 会话、记忆、日志存在本地；用云端模型时，只有本次请求的上下文发给你选的 Provider。
- **动手先确认。** 工具、目录和工作台权限默认需要批准；记忆和群聊不会扩大权限。
- **模型随你换。** DeepSeek、Kimi、GLM、Qwen、Ollama 等预设，也可自定义 Provider。
- **GUI 与 TUI 共用。** 同一个 `kun serve` 运行时，线程、计划和审批两边都能接着用。

## 从源码运行

需要 Node.js 22.19+。

```bash
git clone --branch develop https://github.com/KunAgent/Kun.git
cd Kun && npm ci && npm run dev
```

<details>
<summary>常用命令</summary>

| 命令 | 用途 |
| --- | --- |
| `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`。

</details>

<details>
<summary>终端 TUI 的两种用法</summary>

保持桌面应用运行，在项目目录连接它的运行时，与 GUI 共用线程和审批：

```bash
kun --no-start
```

单独使用时先退出桌面应用，再运行 `kun`；TUI 会启动自己的运行时，退出时一并停止。更多见 [Kun TUI 文档](docs/kun-tui.md)。

</details>

## 文档

| | |
| --- | --- |
| **上手** | [模型 Provider](docs/model-provider-presets.md) · [个人 Agent 与记忆](docs/independent-agents.md) · [终端 TUI](docs/kun-tui.md) |
| **工作台** | [Code 中的 Agent 对话](docs/code-agent-chats-and-rooms.md) · [Design 画布](docs/DESIGN_MODE.md) · [论文与证据](docs/paper-evidence-workspace.md) |
| **扩展** | [MCP 与 Skills](docs/project-mcp-skills.md) · [Loops](docs/workflow-loop.md) · [Extension 平台](docs/extensions/README.md) · [本地网关](docs/provider-configuration-and-gateway.md) |
| **开发** | [本地开发](docs/DEVELOPMENT.zh-CN.md) · [运行时架构](docs/kun-architecture.md) · [贡献指南](docs/CONTRIBUTING.zh-CN.md) |

## 参与贡献

欢迎提交 bug 修复、UI、运行时、Provider 和文档改进。PR 请以 `develop` 为目标分支，开始前读一下 [贡献指南](docs/CONTRIBUTING.zh-CN.md)；外部贡献需要签署 [CLA](./CLA.md)。

<a href="https://github.com/KunAgent/Kun/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=KunAgent/Kun" alt="Kun 贡献者">
</a>

## 许可证

[PolyForm Noncommercial 1.0.0](./LICENSE)，仅限学习、研究和非商业用途。商业使用、托管服务或集成进商业产品，需要作者单独书面授权。

记忆架构参考了 [Nowledge Mem](https://mem.nowledge.co/zh/docs) 公开文档中的 Thread / Memory 分离与来源追踪理念，实现保持独立。

<p align="center">
  <img src="src/asset/img/kun_cheer.png" width="88" alt=""><br>
  <sub>觉得有用？点个 Star，让更多人看到 Kun。</sub>
</p>