Skip to content
Nodus

Workspaces

View Markdown

A Workspace is a development machine with a persistent home directory. It stops when idle, and its home is saved when it stops.

lab = nodus.Workspace.create("lab", gpu="H100:2", image="nodus/workspace-pytorch-cuda", idle_timeout="2h")
lab.wait_ready()
url = lab.open("vscode")          # or "jupyter"; opens the browser and returns the URL
lab.ssh()                         # an SSH session through the nodus CLI
lab.schedule(ready_by="2026-10-01T08:45:00-07:00", stop_at="2026-10-01T19:00:00-07:00")
lab.stop()
for s in lab.sessions():          # one entry per running period, with what it cost
    print(s.billed_seconds, s.charge_usd, s.stop_reason)
  • The home Volume is volume= or <name>-home, created if it does not exist. ephemeral=True skips it: files are lost on stop.
  • lab.start() wakes it after an idle or schedule stop; an SSH connection also wakes it.
  • lab.exec(...) and lab.files work as on Sandboxes.