Agent skill · NVIDIA
cuopt-server-api-python
cuOpt REST server — start server, endpoints, Python/curl client examples. Use when the user is deploying or calling the REST API.
What it needs
About 3k tokens when loaded.
What this skill does
cuOpt Server — Deploy and client (Python/curl) This skill covers starting the server and client examples (curl, Python). Server has no separate C API (clients can be any language). Purpose Use this skill when the user is deploying the cuOpt REST server or writing a client against it — choosing a deployment target, mapping a problem onto the HTTP endpoints, translating between Python-API and REST field names, or debugging a rejected payload. Prerequisites An NVIDIA GPU with a working CUDA driver (the server requires one; --gpus all for Docker). cuopt-server installed, or Docker with the NVIDIA Container Toolkit. See the install skill. Python clients need requests. No API key or auth token is required by the server itself. Problem types supported Problem type Supported -------------- :---------: Routing ✓ LP ✓ MILP ✓ QP ✗ Required questions Ask these if not already clear: 1. Problem type — Routing or LP/MILP? (QP not available via REST.) 2. Deployment — Local, Docker, Kubernetes, or cloud? 3. Client — Which language or tool will call the API (e.g. Python, curl, another service)? Start server Use latest-cu12 or latest-cu13 to match your driver's CUDA major version (latest-cu13-ubi10 for a UBI10 base). Prefer these over the CUDA+Python-specific tags such as latest-cuda12.9-py3.13 — those track a single Python line and go stale when it stops receiving builds. For production, pin rather than float: latest- tags are mutable and can silently move to a different image. Use a full release tag (nvidia/cuopt:<release>-cuda<cuda>-py<python>) or an immutable digest (nvidia/cuopt@sha256:<digest>). Check the nvidia/cuopt registry for available tags. Verify Instructions 1. POST to /cuopt/request → get reqId 2. Poll /cuopt/solution/{reqId} until solution ready 3. Parse response Treat reqId as untrusted input: validate it (e.g. re.fullmatch(r"[A-Za-z0-9-]{1,64}", reqid)) before interpolating it into the polling URL, and set an explicit timeout on every request. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/cuopt-server-api-python