Welcome to Nullspace

Nullspace gives AI agents composable machines: on-demand isolated machines with first-class lifecycle primitives, all driven from Python, TypeScript, the CLI, raw HTTP, or MCP. This is what it looks like:

Run a command
Run code
Expose a port
Pause, resume & fork

from nullspace import Machine

with Machine.create(template="base", timeout=300) as machine:
    result = machine.commands.run("echo 'hello from a machine'", shell=True)
    print(result.stdout)

    machine.files.write("/workspace/app.py", "print('hi')\n")
    print(machine.commands.run("python3 /workspace/app.py", shell=True).stdout)

Commands run inside an isolated VM with its own filesystem — see Commands and Filesystem.

from nullspace import Machine

with Machine.create(template="code-interpreter", timeout=300) as machine:
    machine.run_code("value = 21")                     # state persists
    result = machine.run_code("value * 2")
    print(result.results[0].text)                      # "42"

    machine.install_packages(["pandas"])
    machine.run_code("import pandas; print(pandas.__version__)")

A live Jupyter kernel with stateful cells, runtime installs, and rich results — see Code Interpreter.

from nullspace import Machine

with Machine.create(template="base", timeout=300) as machine:
    machine.commands.run(
        "cd /workspace && python3 -m http.server 8080 --bind 0.0.0.0",
        shell=True, background=True,
    )
    print(machine.get_url(8080))   # signed public URL into the machine

Any port becomes a signed public URL — see Preview URLs.

from nullspace import Machine

machine = Machine.create(template="base", timeout=300)
snapshot = machine.hibernate()          # full VM state, pauses billing
machine = Machine.resume(machine.id)    # wakes exactly where it stopped

child = machine.fork()                  # branch the *running* machine

State survives exactly; wakes are near-instant via lazy memory loading — see Persistence and Fork.

Private beta — signup is closed for now. Public availability timing will be announced when capacity opens. If you have a beta key, you can be running these snippets in about five minutes: create your first machine. The full stack is open source and can be self-hosted on a single host.

Get started

First machine in 5 minutes

Install the CLI, save your key, and run nullspace quickstart.

Copy a runnable example

Code interpreter, agents, fork, templates, volumes, desktop, and more.

Self-host the OSS stack

Run the whole platform on one Ubuntu/KVM host.

The lifecycle primitives

Everything in Nullspace builds on six explicit operations. Pause/resume and fork are what set it apart: full VM state is preserved exactly, wakes use lazy memory loading so they feel instant, and forks branch a running machine.

Primitive	What it does
Create	Boot a fresh machine from a template, image, or snapshot — or claim a pre-booted one from a warm pool
Exec	Run commands and processes, stream output
Hibernate	Pause and persist full VM state
Resume	Wake exactly where it paused, near-instantly
Fork	Branch a running machine into independent children
Destroy	Tear down and release everything

Explore the platform

Machines

The machine lifecycle end to end.
Create & connect · Persistence · Fork example

Code Interpreter

Stateful notebook-style execution.
Analyze data · Charts · Example

Agents

Coding agents in machines, or your agent as a managed service.
Functions · Local MCP · Job example

Templates & warm pools

Bake dependencies once; start instantly.
Quickstart · Warm pools · Build example

Filesystem & volumes

Machine files plus durable shared storage.
Uploads · Volumes · Shared-volume example

Networking

Signed URLs, WebSockets, custom proxies.
Preview URLs · Access control · Port example

Computer use

GUI environments for agents and humans.
Automation · Viewer · Viewer example

Observability & access

Watch and debug long-running work.
Lifecycle events · Webhooks · SSH & PTY

Reference

Client reference

Choose Python, TypeScript, CLI, MCP, or raw HTTP.

Python SDK

Python package, object references, and task guides.

TypeScript SDK

Node and browser SDK for machines, files, templates, volumes, and Functions.

CLI

nullspace commands for machines, templates, volumes, and agents.

HTTP API

The full REST contract with an interactive playground.

​Get started

First machine in 5 minutes

Copy a runnable example

Self-host the OSS stack

​The lifecycle primitives

​Explore the platform

Machines

Code Interpreter

Agents

Templates & warm pools

Filesystem & volumes

Networking

Computer use

Observability & access

​Reference

Client reference

Python SDK

TypeScript SDK

CLI

HTTP API

Get started

The lifecycle primitives

Explore the platform

Reference