Skip to content

index.mdx

Latest commit

 

History

History
110 lines (83 loc) · 3.5 KB

index.mdx

File metadata and controls

110 lines (83 loc) · 3.5 KB
title description
Introduction
Moru - Open-source cloud infrastructure for AI agents

Moru provides isolated cloud sandboxes for AI agents that need full computer access—like Claude Agent SDK—to run commands, write files, and execute code.

Why Moru?

Each sandbox runs in its own Firecracker microVM, providing strong security isolation between workloads. Complete Linux environment with filesystem, networking, and command execution - everything your agent needs. Stream command output, file changes, and logs in real-time as your agent works. Pause and resume sandboxes to maintain agent state across sessions.

Quick Example

Create a sandbox, run a command, and read the output:

```python Python from moru import Sandbox

Create a sandbox

sandbox = Sandbox.create()

Run a command

result = sandbox.commands.run("echo 'Hello from Moru!'") print(result.stdout) # Hello from Moru!

Clean up

sandbox.kill()


```javascript JavaScript
import Sandbox from '@moru-ai/core'

// Create a sandbox
const sandbox = await Sandbox.create()

// Run a command
const result = await sandbox.commands.run("echo 'Hello from Moru!'")
console.log(result.stdout)  // Hello from Moru!

// Clean up
await sandbox.kill()

Core Concepts

Sandboxes

A sandbox is an isolated compute environment where your agent can safely execute code, manipulate files, and run commands. Each sandbox:

  • Runs in a dedicated Firecracker microVM
  • Has its own filesystem (10 GB default)
  • Can execute arbitrary shell commands
  • Supports network access (configurable)
  • Auto-terminates after a timeout (default 1 hour)

Templates

Templates define the starting state of a sandbox - the base image, installed packages, and startup configuration. Use built-in templates or create custom ones with your specific dependencies.

Files and Commands

Sandboxes provide full access to:

  • Filesystem operations: Read, write, list, watch files and directories
  • Command execution: Run shell commands with streaming output
  • PTY support: Interactive terminal sessions for REPL environments

Get Started

Create your first sandbox in 5 minutes. Learn how sandboxes work and their lifecycle. Complete Python SDK reference. Complete JavaScript/TypeScript SDK reference.

Use Cases

Moru is designed for AI agent workloads:

  • Code execution agents: Run code generated by LLMs in isolated environments
  • Development assistants: Provide agents with full development environments
  • Data processing: Execute data transformation pipelines securely
  • Testing and CI: Run tests in clean, reproducible environments
Learn how to run Claude Agent SDK in Moru sandboxes with session persistence and tool execution.