# Run GPU workloads and agent sandboxes with Nodus

Run training, fine-tuning, and batch experiments that need GPU capacity beyond
your local machine. Submit your command from Python or a workload file, follow
its progress, and retrieve logs and output files through the same interface.
For interactive agents, create a durable sandbox and execute multiple commands
with streamed output and stdin.
Nodus uses qualified estimates of runtime cost when every eligible configuration
has comparable measurements. Otherwise it orders compatible on-demand
configurations by hourly price. Spending limits and independent price limits
apply in both cases.
Set a workload budget to limit spending. Optimization tiers are not supported.

Install [nodus-compute from PyPI](https://pypi.org/project/nodus-compute/)
with Python 3.10 or newer, then sign in to get started.

## For coding agents

Start with [Connect your coding agent](https://nodus-compute.ai/docs/guides/connect/) for Claude Code,
Codex, Cursor and other clients. It includes install commands, agent skills,
and a connection check that does not start paid compute.

Follow the [coding agent guide](https://nodus-compute.ai/docs/guides/agents/) to prepare workloads, observe
their progress, and collect results. Use the [parameter reference](https://nodus-compute.ai/docs/reference/parameters/)
for supported arguments and the [OpenAPI specification](https://nodus-compute.ai/docs/openapi.yaml)
for HTTP schemas. Set a budget, keep the workload ID, and check `succeeded` after
waiting. An accepted workload is not necessarily a completed workload.

## Get started

1. [Install and sign in](https://nodus-compute.ai/docs/getting-started/authentication/)
2. [Run your first workload](https://nodus-compute.ai/docs/quickstart/#2-run-your-first-workload)
3. [Read logs and results](https://nodus-compute.ai/docs/guides/monitoring-and-outputs/)

## Run your code

- [Run a Python script](https://nodus-compute.ai/docs/guides/containers-and-scripts/)
- [Attach code and datasets](https://nodus-compute.ai/docs/guides/assets/)
- [Manage external data connections](https://nodus-compute.ai/docs/guides/connections/)
- [Train or fine-tune a model](https://nodus-compute.ai/docs/guides/gpu-workloads/)
- [Run from a workload file](https://nodus-compute.ai/docs/getting-started/workload-files/)
- [Run an agent sandbox](https://nodus-compute.ai/docs/guides/agent-sandboxes/)
- [Run from GitHub Actions and automation tools](https://nodus-compute.ai/docs/guides/automation/)
- [Connect MCP tools](https://nodus-compute.ai/docs/guides/mcp/)
- [Install Codex, Claude Code and Cursor plugins](https://nodus-compute.ai/docs/guides/plugins/)

## Go further

- [Concurrent experiments](https://nodus-compute.ai/docs/guides/async-sweeps/)
- [Stages and downloadable files](https://nodus-compute.ai/docs/guides/multi-stage-workloads/)
- [CI and safe retries](https://nodus-compute.ai/docs/guides/ci-and-idempotency/)

## Reference

- [Python client](https://nodus-compute.ai/docs/reference/python/client/)
- [Versioned workload and draft operations](https://nodus-compute.ai/docs/guides/operations/)
- [Terminal commands](https://nodus-compute.ai/docs/reference/cli/)
- [Workload parameters](https://nodus-compute.ai/docs/reference/parameters/)
- [GPU models and resources](https://nodus-compute.ai/docs/reference/parameters/requirements/#gpu-model)
- [Troubleshooting](https://nodus-compute.ai/docs/operations/errors/)