# nodus

> Nodus Python SDK (`pip install nodus-compute`).

Source: https://nodus-platform-site.pages.dev/docs/reference/python/nodus/
Build revision: 211ad9f836655b1c3a2668c4693e442471f28614

<!-- Generated by scripts/gen-reference.mjs from the SDK docstrings (griffe). Do not edit: run make gen. -->

Nodus Python SDK (`pip install nodus-compute`).

Layer 2, the Modal-shaped layer, is what most code uses: `App`, `@app.function` with `.remote()`, `.spawn()` and `.map()`, `@app.cls`, `Image`, `Volume`, `Secret`, `Sandbox`, `Job`, `Sweep`, `Workspace`, `Agent`, `nodus.llm` and `@nodus.clustered`. Layer 1, `nodus.api`, is the generic resource client under it. Every blocking call also has an `.aio` form for asyncio code (`await f.remote.aio(x)`). Errors are in `nodus.errors`.

Submodules load on first attribute access, so `import nodus` stays fast and in-container helpers such as `nodus.progress` pull in nothing they do not need.

## Exports

* `Agent`: defined in `nodus.agent`
* `AgentGroup`: defined in `nodus.agent`
* `AgentRun`: defined in `nodus.agent`
* `App`: defined in `nodus.app`
* `ClaudeAgent`: defined in `nodus._runtime.agents.claude`
* `Client`: defined in `nodus.api`
* `Cls`: defined in `nodus.functions`
* `Distributed`: defined in `nodus.job`
* `Egress`: defined in `nodus._spec`
* `Function`: defined in `nodus.functions`
* `FunctionCall`: defined in `nodus.functions`
* `GPU`: defined in `nodus._spec`
* `Image`: defined in `nodus.image`
* `InferenceEndpoint`: defined in `nodus.llm`
* `Init`: defined in `nodus.sandbox`
* `Job`: defined in `nodus.job`
* `Process`: defined in `nodus.process`
* `Retries`: defined in `nodus._spec`
* `RunContext`: defined in `nodus.agent`
* `Sandbox`: defined in `nodus.sandbox`
* `Secret`: defined in `nodus.secret`
* `Service`: defined in `nodus.sandbox`
* `Sweep`: defined in `nodus.sweep`
* `TrainingJob`: defined in `nodus.recipes`
* `Tunnel`: defined in `nodus.sandbox`
* `Volume`: defined in `nodus.volume`
* `Workspace`: defined in `nodus.workspace`
* `clustered`: defined in `nodus.functions`
* `enter`: defined in `nodus.functions`
* `exit`: defined in `nodus.functions`
* `method`: defined in `nodus.functions`
* `progress`: defined in `nodus.runtime`
* `restored`: defined in `nodus.runtime`
* `self`: defined in `nodus.runtime`
* `state_dir`: defined in `nodus.runtime`