Getting Started
Introduction

Introduction

Welcome to Akira, the sandbox execution platform for AI agents and autonomous systems. This guide will help you understand the platform and get started building.

What is Akira?

Akira provides programmatic control over isolated execution environments and persistent storage via snapshots. The platform is designed for:

  • AI Agents - Give your agents safe environments to execute code
  • Autonomous Systems - Run untrusted workloads without risk
  • Parallel Processing - Scale across thousands of sandboxes
  • Development Tools - Build cloud IDEs and coding assistants

Core Features

Instant Sandboxes

Spin up isolated environments in under a second. Each sandbox is a hardware-isolated micro-VM with:

  • Full Linux environment
  • Network access (configurable)
  • File system isolation
  • Resource limits (CPU, memory)

Snapshots & Persistence

Capture and restore sandbox state with snapshots:

  • Data persists across sessions
  • Clone sandboxes to share state
  • Snapshot and restore state

Simple API

Clean RESTful interface with official SDKs:

import SandboxSDK from '@akiralabs/sandbox-sdk';
 
const client = new SandboxSDK({
  apiKey: process.env['AKIRA_API_KEY'],
});
 
const sandboxes = await client.sandboxes.list();

Integration Options

TypeScript SDK

The official SDK provides type-safe access to all platform features:

npm install @akiralabs/sandbox-sdk

REST API

Access the API directly for any language:

curl -X POST https://api.akiralabs.ai/v1/sandboxes/create \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "akiralabs/akira-default-sandbox"}'

Architecture Overview

┌─────────────────────────────────────────────────────┐
│                    Your Application                  │
├─────────────────────────────────────────────────────┤
│              Akira SDK / REST API                   │
├─────────────────────────────────────────────────────┤
│                 Akira Platform                       │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐          │
│  │ Sandbox  │  │ Sandbox  │  │ Sandbox  │   ...    │
│  │  (VM)    │  │  (VM)    │  │  (VM)    │          │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘          │
│       │             │             │                 │
│  ┌────┴─────────────┴─────────────┴────┐           │
│  │             Snapshot Store           │           │
│  └──────────────────────────────────────┘           │
└─────────────────────────────────────────────────────┘

Getting Started

  1. Create a Sandbox - Launch your first environment
  2. Execute Commands - Run code in sandboxes
  3. Use Snapshots - Persist data across sessions
  4. Create Snapshots - Backup and restore state

Get Started

Sign up at app.akiralabs.ai (opens in a new tab) to create your API key and start building. You can also use the platform directly to spin up sandboxes without writing code.

Resources

QuickstartCreate Sandbox