Run your first sandbox

You need an AgentBox account, an API key, and Node.js, Python, or Go 1.24+.

1. Create an account

Register in the AgentBox dashboard. New projects receive 1,000 ₽ of promotional credit; a bank card is not needed to start.

2. Add an API key

Open your project in the dashboard, choose API keys, and select Create API key. Put the key in the AGENTBOX_API_KEY environment variable. Do not commit it to the repository. See API key safety.

3. Install the SDK

npm install @abox-dev/sdk

pip install abox-sdk

go get github.com/abox-dev/sdk/packages/go-sdk@v0.2.1

4. Run a command

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)
	}
}

Run the file with Node.js, Python, or Go. A successful run prints hello from AgentBox and then removes the sandbox.

Next, try transferring files or installing a package.

Run your first sandbox ​

1. Create an account ​

2. Add an API key ​

3. Install the SDK ​

4. Run a command ​

Run your first sandbox

1. Create an account

2. Add an API key

3. Install the SDK

4. Run a command