> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nanovm.dev.lithosai.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# LithosBox

> Create a sandbox, run code, and save your work with LithosBox.

LithosBox gives you isolated Linux environments for running code, testing applications,
and working with coding agents. Create a sandbox with the Python SDK or HTTP API,
install the dependencies you need, and delete it when you are finished.

You can also save a sandbox as a snapshot, restore it later, or fork copies to try
several approaches from the same starting point.

## Install and connect

Run this command in a macOS or Linux terminal, or in WSL on Windows:

```sh theme={null}
curl -fsSL https://console.sandbox.lithosai.cloud/install.sh | sh
```

The installer sets up Python and the SDK, offers agent skills, and prompts for an
API key. Create your key in **Console → API Keys**. Choose the optional sandbox
check to verify your connection; a successful check prints `VERDICT: PASS`.

Follow the activation command printed by the installer. See [Installation](/installation)
for other setup options and troubleshooting.

## Run your first command

Save this example as `hello.py` on your computer:

```python theme={null}
from lithosbox import LithosBox

with LithosBox() as box:
    with box.sandboxes.create() as sandbox:
        result = sandbox.run(["python3", "-c", "print(6 * 7)"]).check()
        print(result.stdout)
```

Run it with the installed SDK:

```sh theme={null}
lithosbox python hello.py
```

You should see `42`. The script runs on your computer and sends the Python command
to the sandbox. The sandbox is deleted when the inner `with` block ends.

The default sandbox includes Python 3.12 and Node.js 22. To use another environment,
pass an image to `create()`, such as `image="python:3.12-slim"`.

## Choose your next step

<CardGroup cols={2}>
  <Card title="Run commands" icon="terminal" href="/guides/run-commands">
    Run scripts, keep a shell session, and start background jobs.
  </Card>

  <Card title="Work with files" icon="folder" href="/guides/files">
    Upload inputs and retrieve results from your sandbox.
  </Card>

  <Card title="Save, restore, fork" icon="git-branch" href="/guides/save-restore">
    Save a checkpoint or create copies for parallel experiments.
  </Card>

  <Card title="Use a coding agent" icon="bot" href="/coding-agents">
    Set up Claude Code, Codex, or Cursor to work with LithosBox.
  </Card>
</CardGroup>

For API details, see the [Python SDK](/reference/sdk) and [HTTP API](/reference/http-api)
references. [Accounts and support](/launch) covers organizations, API keys, usage,
and getting help.