Skip to main content
The nullspace command is distributed with the Python SDK. Install the CLI extra when you want terminal commands for sandboxes, files, templates, volumes, lifecycle events, code execution, desktop automation, PTY sessions, and MCP.

​
Requirements

  • Python 3.11, 3.12, or 3.13.
  • pip or uv.
  • A hosted private-beta API key, or a self-hosted appliance API key from /etc/nullspace/operator-api-key.

​
Install

python -m pip install "nullspace-sdk[cli]==0.1.9"
Install the MCP extra too if you want coding agents to call the CLI through the local MCP server: 
python -m pip install "nullspace-sdk[cli,mcp]==0.1.9"

​
Verify The Command

Hosted private beta: 
nullspace --help
nullspace auth login --api-url https://api.13-215-85-171.sslip.io
nullspace doctor
nullspace quickstart
nullspace schema sandbox create
Self-hosted single-host: 
nullspace --help
export NULLSPACE_API_KEY="$(sudo cat /etc/nullspace/operator-api-key)"
export NULLSPACE_API_URL=http://localhost
nullspace doctor
nullspace schema sandbox create
nullspace schema prints machine-readable command metadata. It is useful for tooling and is also the source used by the MCP server to expose CLI commands as typed tools.

​
Configure Credentials

For local interactive use, save both the API key and endpoint: 
nullspace auth login --api-url https://api.13-215-85-171.sslip.io
The CLI also reads NULLSPACE_API_KEY and NULLSPACE_API_URL from your environment for scripts, CI, and coding agents. See Authentication for precedence and config-file details.

​
Next Steps

Authentication

Set credentials with environment variables, .env, or local config.

Create Sandbox

Start a sandbox from a template, snapshot, or attached volume.

Manage Templates

Build, inspect, tag, rename, and delete reusable sandbox environments.

Manage Volumes

Create persistent volumes, edit files, transfer data, and mount into sandboxes.

Manage Files

Read, write, upload, download, search, replace, and watch sandbox files.

Local MCP

Let Codex, Claude Code, Cursor, or VS Code call Nullspace tools.