Agent Workspace

A common agent pattern: clone a repo into an isolated machine, inspect it, and run checks — without touching the host machine. This example uses a public repository; for private repos, inject credentials via envs at create time.

Setup

uv pip install "nullspace-sdk==1.0.0"
export NULLSPACE_API_KEY=ns_live_...
export NULLSPACE_API_URL=https://api.your-nullspace-domain

Python

workspace_example.py

from nullspace import Machine

REPO = "https://github.com/pypa/sampleproject.git"

with Machine.create(template="base", timeout=120) as machine:
    clone = machine.commands.run(
        f"git clone --depth 1 {REPO} /workspace/repo", shell=True, timeout=90
    )
    assert clone.exit_code == 0, clone.stderr

    head = machine.commands.run(
        "git -C /workspace/repo rev-parse --short HEAD", shell=True
    )
    print("repo head:", head.stdout.strip())

    checks = machine.commands.run(
        "cd /workspace/repo && python3 -m compileall -q src && echo checks-passed",
        shell=True,
    )
    print(checks.stdout.strip())

Expected output

repo head: <short-sha>
checks-passed

From here an agent typically reads files (machine.files.read), edits them (machine.files.write), re-runs tests, and forks the warm workspace to try multiple approaches in parallel. To run a coding agent itself inside the machine — Codex, Claude Code, Amp, or OpenCode — see Agent workspaces. Related: Commands · Filesystem

Overview

Machine patterns

Networking and access

Agent deployments

Setup

Python

Expected output

​Setup

​Python

​Expected output

Setup

Python

Expected output