AgentBox SDK

Official Go, JavaScript, Python, and CLI clients for running isolated AgentBox sandboxes and code interpreters.

Package	Install	Import
JavaScript SDK	npm install @abox-dev/sdk	@abox-dev/sdk
Python SDK	pip install abox-sdk	agentbox
Go SDK	go get github.com/abox-dev/sdk/packages/go-sdk	github.com/abox-dev/sdk/packages/go-sdk
JavaScript Code Interpreter	npm install @abox-dev/code-interpreter	@abox-dev/code-interpreter
Python Code Interpreter	pip install abox-code-interpreter	agentbox_code_interpreter
Go Code Interpreter	go get github.com/abox-dev/sdk/packages/go-sdk/codeinterpreter	github.com/abox-dev/sdk/packages/go-sdk/codeinterpreter
CLI	npm install --global @abox-dev/cli	agentbox

Quick start

Create an API key as described in the API key guide and export it:

export AGENTBOX_API_KEY=ab_...

JavaScript:

import { Sandbox } from '@abox-dev/sdk'

const sandbox = await Sandbox.create()
try {
  const result = await sandbox.commands.run('echo "Hello from AgentBox"')
  console.log(result.stdout)
} finally {
  await sandbox.kill()
}

Python:

from agentbox import Sandbox

with Sandbox.create() as sandbox:
    result = sandbox.commands.run('echo "Hello from AgentBox"')
    print(result.stdout)

Go:

client, err := agentbox.NewClient()
if err != nil {
    log.Fatal(err)
}
sandbox, err := client.Sandboxes.Create(context.Background(), nil)
if err != nil {
    log.Fatal(err)
}
defer sandbox.Kill(context.Background())

result, err := sandbox.Commands.Run(context.Background(), "echo", &agentbox.CommandOptions{Args: []string{"Hello from AgentBox"}})
if err != nil {
    log.Fatal(err)
}
fmt.Print(string(result.Stdout))

Configuration

The SDKs use AGENTBOX_API_KEY and optionally AGENTBOX_PROJECT_ID, AGENTBOX_DOMAIN, AGENTBOX_API_URL, and AGENTBOX_SANDBOX_URL. The production defaults are agentbox-runtime.ru, api.agentbox-runtime.ru, and sandbox.agentbox-runtime.ru. Go requires Go 1.24 or newer.

The CLI stores local configuration in ~/.agentbox/config.json; environment variables take precedence. See CLI configuration.

Documentation

• Quickstart
• Core SDK
• Sandboxes
• Commands
• Files
• Templates and builds
• Code Interpreter
• CLI
• API reference

Development

Contributor setup, spec synchronization, verification, KVM testing, versioning, and publication are documented in RELEASING.md.

The Go command streaming design documents the opt-in output policy for long-running processes.

The Go envd user-selection guide describes per-operation users and the unified filesystem options API.

AgentBox SDK is derived from upstream work described in UPSTREAM.md. Licensing notices are in LICENSE and NOTICE.