SDK client

Top-level Sandbox and Template exports read connection settings from the environment. Create an AgentBox client when one process needs explicit settings or more than one isolated configuration.

mjs

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

const client = new AgentBox({ apiKey: process.env.AGENTBOX_API_KEY });
const sandbox = await client.Sandbox.create();

try {
  const result = await sandbox.commands.run("printf 'explicit client works'");
  console.log(result.stdout);
} finally {
  await sandbox.kill();
}

import os

from agentbox import AgentBox


client = AgentBox(api_key=os.environ["AGENTBOX_API_KEY"])
sandbox = client.Sandbox.create()

try:
    result = sandbox.commands.run("printf 'explicit client works'")
    print(result.stdout)
finally:
    sandbox.kill()

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"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(agentbox.WithAPIKey(os.Getenv("AGENTBOX_API_KEY")))
	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{"explicit client works"},
	})
	if err != nil {
		return err
	}
	fmt.Print(string(result.Stdout))
	return nil
}

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

Client settings are defaults. Options passed to a particular SDK call take precedence. JavaScript exposes Sandbox and Template, Python also exposes their async variants, and Go exposes client.Sandboxes and client.Templates.

Use the SDK reference for the exact options supported by each language.

SDK client ​

SDK client