MoonshotAI/kimi-agent-sdk

MoonshotAI/kimi-agent-sdk

Description: Kimi Agent SDK provides a programmatic interface to interact with the Kimi CLI

Language: TypeScript

License: Apache-2.0

Stars: 486

Forks: 67

Open issues: 79

Created: 2026-01-08T05:15:07Z

Pushed: 2026-05-29T05:29:38Z

Default branch: main

Fork: no

Archived: no

README:

Kimi Agent SDK

Kimi Agent SDK is a set of multi-language libraries that expose the Kimi Code (Kimi CLI) agent runtime in your applications. Use it to build products, automations, and custom tooling while keeping the CLI as the execution engine.

The SDKs are thin, language-native clients that reuse the same Kimi CLI configuration, tools, skills, and MCP servers. They stream responses in real time, surface approvals and tool calls, and let you orchestrate sessions programmatically.

Overview

Kimi Agent SDK provides a programmatic interface to interact with the Kimi CLI, enabling you to:

• Build custom applications - Integrate Kimi Agent into your own tools and workflows
• Automate tasks - Script complex multi-turn conversations
• Extend capabilities - Register custom tools that the model can call
• Handle approvals - Programmatically respond to permission requests

Available SDKs

| Language | Package | Status | |----------|---------|--------| | Go | [go/](./go) | Available | | Node.js | [node/agent_sdk/](./node/agent_sdk/) | Available | | Python | [python/](./python/) | Available |

Quick Start

Installation

# Go
go get github.com/MoonshotAI/kimi-agent-sdk/go

Go quick start: [guides/go/quickstart.md](./guides/go/quickstart.md)

# Node.js
npm install @moonshot-ai/kimi-agent-sdk

Node.js quick start: [node/agent_sdk/README.md#quick-start](./node/agent_sdk/README.md#quick-start)

# Python
pip install kimi-agent-sdk

Python quick start: [guides/python/quickstart.md](./guides/python/quickstart.md)

Examples

• Go: [examples/go/ralph-loop](./examples/go/ralph-loop), [examples/go/rumor-buster](./examples/go/rumor-buster)
• Python: [examples/python/customized-tools](./examples/python/customized-tools), [examples/python/kaos](./examples/python/kaos) (KAOS sandbox backends: run the same agent tools in BoxLite, E2B, or Sprites)