Back to Skills

cupynumeric-install

Install and verify cuPyNumeric for Python — requirements, commands, verification. Source builds are out of scope.

2,665stars303forksUpdated 7/25/2026

Security Assessment

Safe(93/100)
Security Score93/100

About cupynumeric-install

cuPyNumeric Install is an NVIDIA-authored guidance skill for installing and verifying cuPyNumeric (a distributed, GPU-accelerated drop-in for NumPy built on Legate) for use from Python. It solves the problem of getting a working, correctly isolated cuPyNumeric environment via conda or pip and then proving the install actually works, including confirming genuine GPU usage. Building cuPyNumeric from source is explicitly out of scope.

A defining feature is its safety posture: the skill's mandatory rules state it must never run installers itself. It prints commands for the user to run, always isolates into a dedicated environment (never base conda, system Python, or shared global envs), and only performs read-only version detection before recommending anything. It documents prerequisites (GPU compute capability 7.0+, CUDA 12.2+, supported OS and Python versions, conda 24.1+), scoping questions, conda and pip install paths, an optional forced-GPU-variant override, and a nightly channel. Verification is thorough: a self-contained smoke test run through the legate launcher with expected outputs, a mandatory GPU-usage check (since a CPU-variant install on a GPU box still returns correct results), plus bundled reference commands for nvidia-smi sampling, verbose Legate startup, package-version checks, CPU-only fallback, and container sanity checks. A BENCHMARK.md documents that the skill passed NVSkills-Eval across security, correctness, discoverability, effectiveness, and efficiency dimensions.

Target users are data scientists, ML engineers, and HPC practitioners who want cuPyNumeric running reliably on a laptop, server, cloud, or container and want to confirm GPU acceleration is actually engaged.

FAQ

Will this skill run the installation for me?

No. Its mandatory rules forbid running any installer; it prints the exact commands and lets you run them, and it always installs into an isolated environment rather than base conda or system Python.

What are the main prerequisites?

A GPU with compute capability 7.0+ (CPU-only is also supported), CUDA 12.2+, Linux (x86_64/aarch64), macOS aarch64 via pip wheels, or Windows via WSL, Python 3.11+, and conda 24.1+ for the conda path.

Does a passing smoke test prove GPU usage?

No. A CPU-variant install on a GPU machine still returns correct results, so the skill mandates a separate GPU-usage check using the legate launcher and nvidia-smi when a supported GPU is present.

Can it build cuPyNumeric from source?

No. Source builds (for modifying or contributing) are explicitly out of scope; this skill is for installing and verifying it for use.

What if I have neither conda nor pip?

It provides bootstrap guidance (recommending Miniforge or installing Python and pip) and shares the command and docs link, but notes curl-piped installs require user trust and it will not run them for you.

All Files

6 files
references/verification_examples.md4.8 KB
View
BENCHMARK.md3.9 KB
View
SKILL.md7.7 KB
View
skill-card.md3.6 KB
View
evals/evals.json30.0 KB
View
skill.oms.sig4.7 KB
View

Install cupynumeric-install

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

nvidia/skills