Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL
All skills

cudaq-guide

Walks you through CUDA-Q setup, GPU simulation targets, QPU access, and writing @cudaq.kernel code.

  • Part of NVIDIA/skills
  • 2.5k installs
  • Machine Learning · GPU acceleration

When to use it

You have CUDA-Q installed or are about to install it, but need a working Bell-state test, a GPU target choice, or help fixing a kernel that won't compile.

For example

You say

Use cudaq-guide to write a Bell-state kernel in Python, run it on the qpp-cpu target, and show me how to switch it to a GPU target.

You get
  • Bell-state kernel code
  • Target switch instructions

How it works

  • Covers choosing between GPU, multi-GPU, tensor-network, and CPU simulation targets.
  • Explains the restricted kernel-language subset and common silent-failure pitfalls when authoring kernels.
  • QPU setup guidance keeps provider credentials in environment variables or a secrets manager.

Before installing

Python 3.10+ for Python workflows; GPU targets need the CUDA Toolkit and an NVIDIA GPU on Linux, and C++ needs Linux or WSL with C++20.