nodus.workspace

Workspace: a development machine with SSH, VS Code, JupyterLab and a persistent home (resources.md §3.8).

Workspace

class Workspace(obj: Obj) -> None

Workspace.create

create(name: str, *, gpu: Any = None, cpu: Any = None, memory: Any = None, disk: Any = None, image: str | None = None, volume: str | _Volume | None = None, ephemeral: bool = False, tools: list[str] | None = None, idle_timeout: Any = None, secrets: list[Any] | None = None, env: dict[str, str] | None = None, max_cost: Any = None, project: str | None = None) -> _Workspace

Create a Workspace; unless ephemeral=True its home is volume (default <name>-home), made if missing.

Workspace.exec

exec(*command: str, pty: bool = False) -> _Process

Workspace.files

Type: _Files

Workspace.from_name

from_name(name: str, project: str | None = None) -> _Workspace

Workspace.logs

logs(follow: bool = False) -> AsyncIterator[str]

Workspace.name

Type: str

Workspace.open

open(tool: str = 'vscode', browser: bool = True) -> str

Mint a preview URL for VS Code or JupyterLab in the browser, open it, and return it.

Workspace.schedule

schedule(ready_by: str | datetime, stop_at: str | datetime | None = None) -> None

Be ready by ready_by (it starts 15 minutes earlier) and stop at stop_at.

Workspace.sessions

sessions() -> list[View]

Every running period of this Workspace, each an Attempt whose status is the session’s receipt.

Workspace.ssh

ssh() -> None

Open an interactive SSH session through the CLI’s ssh-proxy (the CLI writes ~/.ssh/config).

Workspace.start

start() -> None

Workspace.status

status() -> View

Workspace.stop

stop() -> None

Workspace.unschedule

unschedule() -> None

Workspace.wait_ready

wait_ready(timeout: float | None = None) -> View

Block until the tools answer (phase Running); raises when it fails or stops instead.