Skip to main content
The fastest way to try Moru is with the CLI.

​
CLI Quickstart

​
Install the CLI

curl -fsSL https://moru.io/cli/install.sh | bash

​
Hello World

# Login
moru auth login

# Run a command and get destroyed automatically
moru sandbox run base echo 'hello world!'

# List sandboxes
moru sandbox list

# View logs
moru sandbox logs <id>

​
Create/Kill

# Create a sandbox
moru sandbox create base

# Run a command inside
moru sandbox exec <id> 'sh -c "echo Hello Moru > /tmp/note.txt"'

# Run another command
moru sandbox exec <id> cat /tmp/note.txt

# Kill when done
moru sandbox kill <id>

​
SDK Quickstart

​
Install the SDK

pip install moru

​
API Key Set Up

export MORU_API_KEY=your_api_key
Go to the API Keys tab if you didn’t create an API key yet.

​
Create/Kill

from moru import Sandbox

# Create a sandbox using the 'base' template (default)
sandbox = Sandbox.create()
print(f"Sandbox created: {sandbox.sandbox_id}")

# Run a command
result = sandbox.commands.run("echo 'Hello from Moru!'")
print(f"Output: {result.stdout}")

# Clean up
sandbox.kill()

​
Streaming Output

Stream stdout/stderr in real-time for long-running commands. 
sandbox.commands.run(
    "for i in 1 2 3; do echo $i; sleep 1; done",
    on_stdout=lambda data: print(data),
    on_stderr=lambda data: print(data),
)

​
Monitor Sandbox Logs

After running your sandbox, you can view logs, monitor activity, and debug issues from the Sandboxes tab in your dashboard.

​
Using a Custom Template

With custom templates, you can build your own VM snapshot with your own agent pre-installed. See the Maru agent example and the templates documentation for more information. 
sandbox = Sandbox.create("my-template")

​
Next Steps

Sandbox Lifecycle

Understand sandbox states and lifecycle management.

File Operations

Learn all file and directory operations.

Command Execution

Master foreground, background, and interactive commands.

Custom Templates

Build templates with your specific dependencies.