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

# Examples

> Runnable, self-contained examples for every major Nullspace capability.

Every example on this page runs against the hosted private-beta API with
Python 3.11+, the published SDK, and a beta key — copy, paste, run. Pages note
it explicitly when a feature needs deployment-side support.

New here? Do the [First Machine quickstart](../quickstarts/first-machine)
once, then start with **Code Interpreter**, **Agent Workspace**, or **Fork**
below.

## Machine patterns

<CardGroup cols={2}>
  <Card title="Code Interpreter" icon="square-terminal" href="./code-interpreter">
    Stateful notebook-style cells, a runtime package install, and a rendered
    plot.
  </Card>

  <Card title="Agent Workspace" icon="bot" href="./agent">
    Clone a repository and run checks inside a machine, the way an agent
    would.
  </Card>

  <Card title="Fork" icon="git-fork" href="./fork">
    Branch a running machine and watch parent and child diverge.
  </Card>

  <Card title="Template Build" icon="layers" href="./template-build">
    Bake dependencies into a reusable template and launch from it.
  </Card>

  <Card title="Template Warm Pools" icon="flame" href="./template-warm-pools">
    Keep pre-booted machines ready and choose checkout fallback behavior.
  </Card>

  <Card title="Shared Volume" icon="hard-drive" href="./shared-volume">
    Mount one durable volume into two machines — writer and read-only
    reader.
  </Card>

  <Card title="CI/CD Pipelines" icon="workflow" href="../use-cases/ci-cd">
    Run untrusted build and test steps in disposable machines.
  </Card>
</CardGroup>

## Networking and access

<CardGroup cols={2}>
  <Card title="Port Forwarding" icon="globe" href="./port-forwarding">
    Serve HTTP from a machine and fetch it through a signed preview URL.
  </Card>

  <Card title="Custom Preview Proxy" icon="route" href="./custom-preview-proxy">
    Front machine previews with your own Node or Python proxy.
  </Card>

  <Card title="Desktop Viewer" icon="monitor" href="./desktop-viewer">
    Start a desktop machine and open the managed browser viewer.
  </Card>

  <Card title="Resumable Upload" icon="upload" href="./resumable-upload">
    Upload large files and directories with progress and retry recovery.
  </Card>

  <Card title="Lifecycle Webhook" icon="webhook" href="./lifecycle-webhook">
    Register HMAC-signed webhooks and inspect deliveries.
  </Card>
</CardGroup>

## Agent deployments

Deploy a local agent project as a managed `job` or `service` — named,
versioned, with logs, outputs, and URLs.

<CardGroup cols={2}>
  <Card title="Minimal Job" icon="play" href="./agent-deployment-job">
    Package a small project, run it as a job, collect declared outputs.
  </Card>

  <Card title="HTTP Service" icon="server" href="./agent-deployment-service">
    Deploy a long-running HTTP agent service and fetch its public URL.
  </Card>

  <Card title="OpenAI Agents SDK" icon="bot" href="./agent-deployment-openai-agents">
    Run an OpenAI Agents SDK app as a finite job.
  </Card>

  <Card title="Claude Agent SDK" icon="bot" href="./agent-deployment-claude-agent-sdk">
    Run a Claude Agent SDK app as a finite job.
  </Card>

  <Card title="LangGraph Service" icon="git-branch" href="./agent-deployment-langgraph-service">
    Deploy a graph-backed HTTP service.
  </Card>

  <Card title="CrewAI Job" icon="users" href="./agent-deployment-crewai-job">
    Run a CrewAI project as a bounded job.
  </Card>

  <Card title="TypeScript Service" icon="file-code" href="./agent-deployment-typescript-service">
    Deploy a Node/TypeScript HTTP service.
  </Card>
</CardGroup>

Looking for pause/resume or SSH? Those live in the product docs:
[Auto-Resume](../machines/auto-resume) and [SSH access](../access/ssh) both
include runnable walkthroughs.