Skip to content
KunAgentPublic

About

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

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6.4k stars

Watchers

126 watching

Forks

Latest commit

 

History

4,433 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kun 蓝色 K 标识

Kun

本地优先的 AI 工作台:写代码、做文档、和 Agent 一起推进事情。

下载  ·  文档  ·  更新日志  ·  English

Kun 最新 GitHub Release 支持 macOS、Windows 和 Linux Kun 使用 PolyForm Noncommercial 1.0.0 许可证

Kun:本地优先的 AI 工作台。桌面 Code 界面、终端 TUI 与吉祥物

Kun 能做什么

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

Code:项目、终端、Git 与 Diff 在一处,Design 画布把原型带进代码 Work:文档、论文和资料放在同一个工作区
Agent 对话:和个人 Agent、Codex、Claude Code、OpenCode 私聊或拉群 模型与网关:接入任意兼容 Provider,本地网关复用同一份配置
  • 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 更新日志。

三步开始

  1. 下载安装。 从 Releases 选择对应平台的安装包。
  2. 连接一个模型。 首次启动的引导里填 API Key,或登录已有订阅。支持 OpenAI / Anthropic 兼容接口与本地模型,见 Provider 文档。
  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 不处理依赖,在精简系统上会装不上。

看一眼

Code 界面:项目、任务入口与输入区
Code · 项目、任务与改动
Work 界面:文件树、文档与 Work 助手
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。

Kun 贡献者

许可证

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

记忆架构参考了 Nowledge Mem 公开文档中的 Thread / Memory 分离与来源追踪理念,实现保持独立。


觉得有用?点个 Star,让更多人看到 Kun。

About

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

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6.4k stars

Watchers

126 watching

Forks

Releases

Packages

Used by

Contributors

Languages