로컬 우선의 AI 작업대: 코드를 작성하고, 문서를 만들고, Agent와 함께 업무를 진행합니다.
Kun：本地优先的 AI 工作台。桌面 Code 界面、终端 TUI 与吉祥物
Kun은 사용자의 컴퓨터에서 실행되는 데스크톱 애플리케이션입니다. 코드, 문서, 그리고 Agent 대화가 하나의 로컬 런타임 환경을 공유하며; 세션, 메모리, 설정 등 모든 데이터는 본체에 보관되며, 모델은 사용자가 직접 연결합니다.
|
|
|
|
또한 다음 기능들을 제공합니다: 플러그인 및 스킬 마켓(MCP / Skills), 알림 및 예약 작업, 터미널 TUI, 모바일 원격 접속, Kun 계정 및 옷장(Wardrobe). 전체 목록은 0.4.0 업데이트 로그를 참조하세요.
다운로드 및 설치. Releases에서 해당 플랫폼의 설치 파일을 선택하세요. 모델 연결. 처음 실행할 때 안내에 따라 API Key를 입력하거나 기존 구독으로 로그인합니다. OpenAI / Anthropic과 호환되는 인터페이스와 로컬 모델을 지원하며, Provider 문서를 참고하세요. 구체적인 임무 부여. 프로젝트 폴더를 열어 Code에 전달하거나 자료를 Work로 드래그하세요. Agent가 작업을 시작하기 전에는 반드시 사용자에게 확인을 요청합니다.
| 플랫폼 | 설치 파일 | 아키텍처 |
|---|
| macOS | .dmg / .zip | Apple Silicon / Intel |
| Windows | .exe | x64 |
| Linux | .AppImage / .deb | x64 |
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 플랫폼 · 로컬 게이트웨이 |
개발자 가이드 |
로컬 개발 · 런타임 아키텍처 · 기여 가이드|
버그 수정, UI, 런타임, Provider 및 문서 개선 사항을 제출해 주시면 환영합니다. PR은 develop 브랜치를 대상으로 하고, 시작하기 전에 기여 가이드를 읽어보세요. 외부 기여는 CLA(Contributor License Agreement) 서명이 필요합니다.
PolyForm Noncommercial 1.0.0으로, 학습, 연구 및 비상업적 용도로만 제한됩니다. 상업적 사용, 호스팅 서비스 또는 상업 제품에 통합하려면 저자의 별도 서면 승인이 필요합니다.
메모리 아키텍처는 Nowledge Mem 공개 문서의 Thread / Memory 분리 및 출처 추적 개념을 참고하여 독립성을 유지하도록 구현되었습니다.
