Skip to main content
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:
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 for other setup options and troubleshooting.

​
Run your first command

Save this example as hello.py on your computer:
Run it with the installed SDK:
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

Run commands

Run scripts, keep a shell session, and start background jobs.

Work with files

Upload inputs and retrieve results from your sandbox.

Save, restore, fork

Save a checkpoint or create copies for parallel experiments.

Use a coding agent

Set up Claude Code, Codex, or Cursor to work with LithosBox.
For API details, see the Python SDK and HTTP API references. Accounts and support covers organizations, API keys, usage, and getting help.