AgentBox documentation

AgentBox creates lightweight, isolated Linux environments for AI agents and applications that are unsafe to run on your own machine. Create a sandbox, transfer files, run commands, and remove the environment when the task is done.

First sandbox

Install @abox-dev/sdk for JavaScript, abox-sdk for Python, or github.com/abox-dev/sdk/packages/go-sdk for Go 1.24+. Every SDK reads the API key from AGENTBOX_API_KEY.

mjs

import { Sandbox } from "@abox-dev/sdk";

const sandbox = await Sandbox.create();

try {
  const result = await sandbox.commands.run("printf 'hello from AgentBox'");
  console.log(result.stdout);
} finally {
  await sandbox.kill();
}

from agentbox import Sandbox


sandbox = Sandbox.create()

try:
    result = sandbox.commands.run("printf 'hello from AgentBox'")
    print(result.stdout)
finally:
    sandbox.kill()

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/abox-dev/sdk/packages/go-sdk"
)

func kill(sandbox *agentbox.Sandbox) {
	if _, err := sandbox.Kill(context.Background()); err != nil {
		log.Printf("cleanup sandbox: %v", err)
	}
}

func run() (err error) {
	ctx := context.Background()
	client, err := agentbox.NewClient()
	if err != nil {
		return err
	}
	sandbox, err := client.Sandboxes.Create(ctx, nil)
	if err != nil {
		return err
	}
	defer kill(sandbox)

	result, err := sandbox.Commands.Run(ctx, "printf", &agentbox.CommandOptions{
		Args: []string{"hello from AgentBox"},
	})
	if err != nil {
		return err
	}
	fmt.Print(string(result.Stdout))
	return nil
}

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

The finally block removes the sandbox even when a command fails.

Main concepts

A sandbox is a temporary Linux microVM for commands, files, and services.
A template defines the software and resources available at startup.
The SDK manages sandboxes and templates from an application.
The CLI provides the same common workflows from a terminal.

Next steps

Quickstart — learn how to use AgentBox.
AI agents — learn how to run an agent in a sandbox.

AgentBox documentation ​

First sandbox ​

Main concepts ​

Next steps ​

AgentBox documentation

First sandbox

Main concepts

Next steps