Skip to content

talon-org/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 

Repository files navigation

Talon Sandbox

Isolated container environments for AI agents β€” fast, secure, and programmable.

Talon Sandbox gives AI agents their own ephemeral Linux containers with a full process model, filesystem, networking, and browser β€” all controllable through a clean API or SDK.


πŸš€ Quick Start

Pick your language and spin up a sandbox in seconds:

import { Sandbox } from "talon-sandbox";

const sb = await Sandbox.create({ image: "node:20-bookworm" });
const result = await sb.run("node --version");
console.log(result.stdout);
await sb.kill();
from talon_sandbox import Sandbox

async with await Sandbox.create(image="node:20-bookworm") as sb:
    result = await sb.run("node --version")
    print(result.stdout)
sb, _ := sandbox.Create(ctx, sandbox.Opts{Image: "node:20-bookworm"})
defer sb.Kill(ctx)
result, _ := sb.Run(ctx, "node --version")
fmt.Println(result.Stdout)

πŸ“¦ Repositories

Repository Description
talon-sandbox-sdk-typescript TypeScript/Node.js SDK β€” npm install talon-sandbox
talon-sandbox-sdk-python Python SDK (async + sync) β€” pip install talon-sandbox
talon-sandbox-sdk-go Go SDK β€” go get x.xgit.pro/dark/talon-sandbox-sdk-go
talon-sandbox-sdk-dotnet .NET SDK (.NET 8+, async-first)
talon-sandbox-cli tsb β€” official CLI for managing sandboxes
agent-sandbox-docs Documentation site (VitePress)
talon-sandbox-ci Public CI runner workflows

✨ Features

  • Ephemeral containers β€” each sandbox is a clean, isolated Linux environment
  • Full process model β€” run commands, spawn long-running processes, and attach to interactive PTY terminals
  • Filesystem API β€” read, write, list, and remove files inside any sandbox
  • Port exposure β€” expose a sandbox port as a public preview URL with optional signed access
  • Browser automation β€” launch a headless Chrome instance and connect via CDP (Playwright / Puppeteer)
  • Multi-language SDKs β€” TypeScript, Python, Go, and .NET
  • CLI β€” tsb for scripting and local workflows

πŸ”‘ Configuration

All SDKs and the CLI read the same two environment variables:

export TALON_SANDBOX_SERVER=https://api.talon-sandbox.dev
export TALON_SANDBOX_API_KEY=ask_...

πŸ“š Documentation

Full docs, API reference, and deployment guides are available at the agent-sandbox-docs repository.


πŸ“„ License

Proprietary β€” All rights reserved Β© 2026 Talon Sandbox.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors