# Kun — AI Agent Workspace with Code and Design Modes

> An open-source AI agent workspace that embeds code-writing and visual design modes directly into your application, supporting multi-agent orchestration.

## Install

Save in your project root:

# Kun — AI Agent Workspace with Code and Design Modes

## Quick Use
```bash
git clone https://github.com/KunAgent/Kun.git
cd Kun
npm install
npm run dev

# Open http://localhost:3000 to access the workspace
```

## Introduction
Kun is an open-source AI agent workspace that combines code-writing and visual design capabilities into a single interface. Built with TypeScript, it provides a web-based environment where AI agents can write code, generate designs, and iterate on both simultaneously — bridging the gap between coding agents and design tools in a unified workspace.

## What Kun Does
- Provides a web-based workspace with switchable Code and Design modes
- Integrates AI coding agents for writing, editing, and refactoring code
- Offers a visual design mode for generating and iterating on UI layouts
- Supports multi-agent orchestration for complex tasks spanning code and design
- Renders live previews of generated code and design output

## Architecture Overview
Kun is a TypeScript web application with a modular agent integration layer. The Code mode connects to coding agent backends (Claude, OpenAI, or local models) through a unified API adapter. The Design mode uses a canvas-based renderer that translates agent-generated layout descriptions into visual previews. Both modes share a project state model, so code changes reflect in design previews and vice versa. Agent orchestration is handled by a task router that dispatches work to specialized agent instances.

## Self-Hosting & Configuration
- Clone the repository and install dependencies with npm
- Configure your LLM provider API keys in the environment file
- Run the development server locally or build for production deployment
- Customize agent configurations and available tools through the settings panel
- Deploy to any Node.js hosting platform or run behind a reverse proxy

## Key Features
- Dual-mode workspace combining code and design in one interface
- Live preview rendering for immediate visual feedback on code changes
- Multi-agent task routing for parallel code and design workflows
- Provider-agnostic LLM integration supporting multiple backends
- Web-based interface accessible from any browser without local installation

## Comparison with Similar Tools
- **Cursor** — a full IDE with AI features; Kun is a workspace focused on the code-plus-design workflow
- **v0 / Lovable** — AI app builders; Kun provides a more developer-oriented workspace with agent orchestration
- **Bolt.new** — AI-driven app generation; Kun emphasizes dual-mode editing over one-shot generation
- **Open Design** — AI design alternative; Kun integrates coding and design in a single workspace

## FAQ
**Q: Does Kun replace my code editor?**
A: Not necessarily. It is designed as a workspace for AI-assisted development tasks. You can use it alongside your primary editor for agent-driven code and design work.

**Q: Which LLM providers are supported?**
A: Kun supports OpenAI, Anthropic, and local models through its provider adapter layer. Add new providers by implementing the adapter interface.

**Q: Can I deploy Kun for a team?**
A: Yes. The web-based architecture supports deployment on shared infrastructure with multiple concurrent users.

**Q: Is there a desktop application?**
A: Currently Kun is web-only. A desktop version may be developed in the future by the community.

## Sources
- https://github.com/KunAgent/Kun
- https://github.com/KunAgent/Kun/blob/master/README.md

---
Source: https://tokrepo.com/en/workflows/asset-cc148b48
Author: AI Open Source