Skip to main content
open source · self-hosted · apache-2.0

Your Agent programs, running in the cloud 24/7.

AstraBox is an open-source, self-hosted runtime for AI Agents. You do not have to turn an Agent program into a service, manage execution sandboxes, or maintain long-lived connections. Create an Agent and start a Session; complex tasks run in the cloud while results stream back in real time.

Get startedRead the overview
start AstraBox on one machine
git clone https://github.com/Colton-z/astrabox.git
cd astrabox

make build-agent-image

export ANTHROPIC_API_KEY=your-anthropic-api-key
export ANTHROPIC_MODEL=your-model-name
scripts/compose.sh up --build -d
01 · Core concepts

Agent, Environment, Session, and Event

ConceptDescriptionAnalogy
AgentA cloud Agent powered by an installed Agent program.Cloud teammate
EnvironmentThe Agent program, sandbox, model connection, network access, and lifecycle used for a Session.Desk and toolbox
SessionOne stateful Agent execution, including its messages, Events, and current state.A specific piece of work
EventThe real-time output and state changes produced by a Session.Live progress feed
02 · Workflow

From deployment to a running Agent

Step 1

Deploy AstraBox

Run the AstraBox service and OpenSandbox on a Docker host, Kubernetes, or infrastructure you already operate.

Step 2

Configure an Environment

Choose the Agent program, sandbox image, model connection, network access, and lifecycle.

Step 3

Create an Agent

Select the Environment and model. Add a system prompt, MCP servers, Plugins, Skills, or a repository only when the Agent needs them.

Step 4

Start a Session and follow Events

Send a message, follow live output, answer questions or approvals, and return later without keeping the original browser open.

03 · When to use AstraBox

Put cloud Agents to work in your products and operations

Long-running

Let work continue after you disconnect

Run coding, research, operations, and other tasks without depending on a developer computer or browser staying online.

API integration

Use Agents from your products

Start and follow Agent work from an application without building and operating another Agent runtime.

Batch processing

Run independent work in parallel

Start multiple Sessions for bulk requests while keeping each Session's state and output separate.

Automations

Start work on a schedule or event

Connect an Agent to schedules, webhooks, external systems, or messaging platforms and keep a Run record for every execution.

04 · How it works

AstraBox keeps the Agent available; OpenSandbox runs its sandbox

Clients connect to AstraBox. AstraBox authenticates the caller, stores Session state, creates or resumes a sandbox through OpenSandbox, and sends work to the selected Agent program. Events stream back while Session history remains outside the sandbox.

web console / APIrequests · live outputSession servicestreaming · approvalsOpenSandboxsandbox lifecycleSession storagehistory · stateAstraBox sandbox serviceconnects to the Agent programAgent programselected by the Environmentworkspacefiles · commandsmodel serviceconfigured by the operatorAstraBox serviceAgent sandboxtasks · eventscreate · pause · resumemodel requestsSession history
  1. 01web console / APIrequests · live output
  2. 02Session servicestreaming · approvals · Session storage
  3. 03OpenSandboxsandbox lifecycle
  4. 04Agent programAstraBox sandbox service · workspace
  5. 05model serviceconfigured by the operator

Solid lines show live requests and events. The dashed line shows Session history stored by AstraBox. On snapshot-capable deployments, pausing preserves sandbox files; resuming starts fresh processes from those files.

05 · Next steps

Choose what you want to do next

Quickstart

Run AstraBox locally

Start the maintained Docker deployment, open the web console, and create an Agent. Follow the quickstart →

Deployment

Deploy for a team

Add authentication, durable storage, TLS, backups, and the sandbox capacity your team needs. Read the deployment guide →

Integration

Connect AstraBox to your systems

Use the HTTP API with your applications, and connect your existing authentication, model, storage, and messaging services. Open the API guide →