// agents · KunAgent/Kun

Kun

Kun is an open-source ai agents project by KunAgent (KunAgent/Kun on GitHub). It has 6,319 GitHub stars and 594 forks, is released under the PolyForm Noncommercial 1.0.0 license, and was last updated on GitHub on 7 October 2026.

A local-first AI agent workspace for coding, writing, design, research and automation.

★ 6.3k stars⑂ 594 forksPolyForm Noncommercial 1.0.0updated 2026-10

View on GitHub ↗Official site ↗

▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.

// project facts

Project facts

Repository: KunAgent/Kun
GitHub stars: 6,319
Forks: 594
License: PolyForm Noncommercial 1.0.0
Last updated on GitHub: 7 October 2026
Category: AI Agents
Listing: Full install guide
Official site: Official site

// how it works

How it works

Clarify your first task
Pick a real task — a code change, a document, a research job — and note its constraints and acceptance criteria.
Get Kun
Download the desktop app for macOS, Windows or Linux, or clone the repo to run from source.
Connect a model
Add at least one model connection (an OpenAI-compatible endpoint or a supported provider) in the settings.
Run your first task
State the goal; Kun plans the steps, executes with visible tool calls and file changes, and delivers with diff and test evidence for your review.

// features

Why people love it

One runtime, GUI and TUI

The desktop GUI and the terminal TUI share the same Kun runtime, so you can move between visual and terminal work.

Plan-driven execution

Agents work from an explicit plan and todo list; tool calls, file changes, browser/terminal results and approvals stay attached to the task.

Rooms for multi-agent work

Create a room, choose agent profiles, models and authorized local repos, and collaborate via private or group chat with coordinator or peer modes.

Isolated, reviewable delivery

Each execution task runs in its own Git worktree and is delivered as an immutable version for a reviewer, with declared checks, diffs and logs kept in the room.

Local-first data

Requirements and plans can live inside your project, so they enter version control, code review and later recovery.

MCP and OpenAI-compatible models

Connects to MCP tools and OpenAI-compatible model endpoints, including DeepSeek.

// run it

Run it yourself

Clone the repository

Clone Kun to run it from source.

git clone https://github.com/KunAgent/Kun.git
cd Kun

Install and build
Install dependencies (Node.js 22.19+ required) — the dev script builds the runtime.
```
npm install
```
Start Kun
Launch the Electron development environment, or use the TUI variant.
```
npm run dev
# TUI instead: npm run dev:tui
```

// use cases

What you can build

Driving a coding task from goal to reviewed diff without leaving one workspace
Coordinating several specialized agents in a Room on a larger project
Drafting and organizing documents with an agent that keeps sources attached
Automating recurring research and organizing tasks with a visible plan and approvals

// faq

Questions, answered

Who maintains Kun?

Kun is maintained by the KunAgent organization.

Is Kun free?

Kun is source-available under the PolyForm Noncommercial License 1.0.0 — free for noncommercial use; commercial use is not covered by that license.

Does it need a paid API key?

You need at least one working model connection; Kun supports OpenAI-compatible endpoints, so you can use your own provider or a local/self-hosted endpoint.

How does it compare to Cursor or a chat assistant?

Kun is a local-first workspace spanning coding, writing, design and research, with plan-driven tasks, Git-worktree isolation and multi-agent Rooms — not just an editor or a chat window.

How do I get started?

Install the desktop app (or npm run dev from source), connect a model, and give Kun a goal with constraints.

// keep exploring

Similar tools

AI Agents

holaOS

Local-first agentic workspace where Claude Code, Codex and a built-in agent share memory, apps and tools.

★ 11.5k starsModified Apache-2.0

View guide →

AI Agents

neo-chat

Local-first AI chat workspace for models.

★ 1.9k starsMIT

View guide →

AI Agents

ZCode

ZCode — Z.ai's AI coding workspace: desktop app, browser interface and terminal agent in one open-source harness

★ 7.9k starsApache-2.0

View guide →

Agents

nanocoder

Community-built terminal coding agent: bring your own model, keep code local.

★ 2.5k starsCustom

View guide →

Agents

lime

Full-stack AI agent for coding, research, content, and multi-agent workflows.

★ 1.5k starsCustom

View guide →

AI Agents

openhuman

A fast, local-first open-source agent harness written in Rust, with desktop, browser and terminal apps

★ 41.7k starsGPL-3.0

View guide →

// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if Kun is not the right fit.

openclaw★ 391.6k
A personal AI that really does things — on any OS, with your data staying yours.
superpowers★ 294.9k
An agentic skills framework & software development methodology that works.
ECC★ 275.2k
Agent harness optimization system with skills, memory and security for Claude Code, Codex and more
hermes-agent★ 252.0k
The agent that grows with you — a Python framework for adaptive AI agents.
deepseek-harness★ 245.5k
DeepSeek's plugin-based agent harness where everything is a plugin.

// more in agents

Get Kun

Free and open — grab the source, star the repo, and start creating.

View on GitHub ↗← More AI Agents tools

Kun

Project facts

How it works

Why people love it

One runtime, GUI and TUI

Plan-driven execution

Rooms for multi-agent work

Isolated, reviewable delivery

Local-first data

MCP and OpenAI-compatible models

Run it yourself

What you can build

Questions, answered

Similar tools

holaOS

neo-chat

ZCode

nanocoder

lime

openhuman

Alternatives in AI Agents

More in AI Agents

Get Kun