kaos

KAOS Sandbox Examples

KAOS (Kimi Agent Operating System) is a runtime abstraction layer that decouples agent tools from the underlying execution environment. It defines a standard interface for file system operations, process execution, and path manipulation — allowing the same agent code to run locally or inside any supported sandbox.

This directory contains three ready-to-run backends that demonstrate the pattern:

Backend	Environment	Description
boxlite/	Local container	Runs tools inside a BoxLite box on your machine
e2b/	Cloud sandbox	Runs tools inside an E2B remote sandbox
sprites/	Cloud sandbox	Runs tools inside a Sprites persistent environment

How It Works

All three backends follow the same four-step pattern:

1. Create or connect to a sandbox resource (box / sandbox / sprite)
2. Install the backend via set_current_kaos(...)
3. Call prompt(...) or Session — tools are transparently routed to the sandbox
4. Reset KAOS context and clean up resources

flowchart LR
    subgraph Server
        App["Your App"] --> SDK["Kimi Agent SDK"] --> CLI["Kimi CLI"]
        subgraph Tools["Tools"]
            ReadFile["ReadFile"]
            WriteFile["WriteFile"]
            Shell["Shell"]
        end
        CLI --- Tools
    end

    subgraph Sandbox["Sandbox (BoxLite / E2B / Sprites)"]
        FS[("Filesystem")]
        SH{{"Shell"}}
    end

    ReadFile -->|"Kaos.readtext()"| FS
    WriteFile -->|"Kaos.writetext()"| FS
    Shell -->|"Kaos.exec()"| SH

    style Tools stroke-dasharray: 5 5

Loading

Note: The Grep tool currently only supports local KAOS, so all sandbox examples disable it in their agent.yaml.