cuopt-install

Install NVIDIA cuOpt via pip, conda, or Docker with CUDA version matching.

1.0k|218|Updated Apr 8, 2025
One-click install
npx skills add https://github.com/NVIDIA/cuopt --skill cuopt-install-nvidia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cuopt-install
Source: https://github.com/NVIDIA/cuopt/tree/main/skills/cuopt-install
Command: npx skills add https://github.com/NVIDIA/cuopt --skill cuopt-install-nvidia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It removes uncertainty about how to correctly install NVIDIA cuOpt for GPU-accelerated optimization, including matching the right CUDA variant and choosing the right interface (Python, C, or REST server).

Core Features & Use Cases

  • Guided installation across interfaces: Install cuOpt via pip, conda, or Docker for Python usage, C API usage, or a REST server workflow.
  • Correct CUDA/runtime matching: Ensures users install the cuopt-cuXX / libcuopt-cuXX variants that match their installed CUDA major version (cu12 vs cu13), avoiding common runtime import/CUDA errors.
  • Verification and troubleshooting: Provides quick verification snippets (import/version checks, GPU-access exercises, server health checks) and explains common issues such as environment mismatch or missing modules.

Quick Start

Tell me which interface you want (Python, C, or REST server), your CUDA major version (12 or 13), and whether you prefer pip, conda, or Docker, and I will give you the exact install command plus a short verification step.

Frequently Asked Questions about cuopt-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install NVIDIA cuOpt for Python and avoid CUDA version mismatch errors?

To install NVIDIA cuOpt for Python without CUDA mismatch errors, select the cuopt-cuXX package variant matching your installed CUDA major version (12 or 13), then run the pip or conda install command followed by a quick import and version check.

Can I deploy the cuOpt REST server using Docker on a remote GPU workstation?

Yes, you can deploy the cuOpt REST server using Docker on remote GPU workstations or cloud instances, ensuring the container has proper GPU access and the libcuopt-cuXX runtime variant matches the host CUDA major version.

What's the best way to verify a cuOpt installation across Python, C API, and REST server interfaces?

The best way to verify cuOpt installation is by running interface-specific checks: executing import and version checks for Python, confirming C API linkage, and performing server health checks for the REST server to ensure full GPU compute access.

Why does my cuOpt setup fail with a runtime import error after pip install?

Your cuOpt setup fails with a runtime import error because of a CUDA major-version misalignment, meaning you likely installed a cuopt-cuXX or libcuopt-cuXX package variant that does not match your local GPU's CUDA driver.

Does cuOpt require a specific CUDA major version to function properly?

cuOpt requires your installed CUDA major version to align with the package suffix, choosing between cu12 or cu13 variants for cuopt-cuXX and libcuopt-cuXX, preventing common environment mismatches and missing module issues.

How do I install the cuOpt C API for local GPU optimization workloads?

To install the cuOpt C API for local GPU optimization, ensure your system has the correct CUDA major version, then install the libcuopt-cuXX package via pip or conda, verifying GPU compute capability and library linkage post-install.