cudaq-guide

Guide CUDA-Q users through installation, validation, kernel basics, GPU simulation, and QPU planning.

Updated May 23, 2026
One-click install
npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill cudaq-guide-yo-steven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cudaq-guide
Source: https://github.com/yo-steven/skills-exploration-20260522/tree/main/skills/CUDA-Q/cudaq-guide
Command: npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill cudaq-guide-yo-steven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill helps users install CUDA-Q and quickly progress from writing a minimal working quantum kernel to running simulations on GPU targets and preparing to execute on real QPU hardware.

Core Features & Use Cases

  • Guided onboarding menu: Routes users to the right topic based on a single argument (install, test program, GPU simulation, QPU, applications, or parallelization).
  • Practical workflow for validation: Ensures users complete the expected verification step (Bell state) after installation.
  • Decision support for backends and hardware: Recommends GPU simulation targets by comparing options and runs a two-step QPU provider selection flow.
  • Parallelization patterns: Explains when to use mgpu versus mqpu and how to batch execution for common scaling goals.

Quick Start

Ask the AI: "Run /cudaq-guide install and tailor the steps for my operating system."

Frequently Asked Questions about cudaq-guide

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

FAQPage Schema
How do I install CUDA-Q and validate the setup with a test program?

To install CUDA-Q, route the onboarding guide with the install argument to get operating system-specific steps, then execute the Bell state kernel validation to confirm your quantum computing environment is correctly configured.

What is the difference between mgpu and mqpu parallelization in CUDA-Q?

mgpu parallelization utilizes multiple GPUs for a single simulation, while mqpu distributes workloads across multiple QPU simulators. Choosing between them depends on whether your scaling goal requires deep circuit execution or broad parallel kernel batching.

How do I run GPU-accelerated quantum simulations using CUDA-Q?

GPU-accelerated quantum simulation in CUDA-Q is executed by routing the guide to the GPU simulation topic, which compares available simulation targets and recommends the appropriate backend for running your quantum kernels.

How do I select a QPU hardware provider for executing CUDA-Q kernels?

Selecting a QPU hardware provider for CUDA-Q kernel execution involves using the guide's two-step QPU provider selection flow, which routes you through decision support to match your quantum computing requirements with available hardware backends.

Can I use CUDA-Q for quantum kernel basics and onboarding without prior quantum computing experience?

CUDA-Q onboarding provides a practical workflow for writing a minimal working quantum kernel and progressing to QPU hardware execution, requiring only a single routing argument to guide beginners through installation and kernel basics.

When should I use GPU simulation targets versus real QPU hardware in CUDA-Q?

Use GPU simulation targets for accelerated local testing and comparing execution options, and transition to real QPU hardware execution when you need to validate quantum kernels on actual physical quantum processing units.