Guidance on enabling CUDA-Q simulator on Windows

We operate a public community and tooling site at https://entangleall.com/ where anyone interested in quantum can discuss and experiment. On https://entangleall.com/quantum-lab, users can currently run quantum simulations using the IonQ–Qiskit simulator, IonQ Cloud, and local Qiskit environments.

We would like to expand this capability to include CUDA-Q, ideally allowing users to run the CPU-based simulator as well. Our understanding is that CUDA-Q is primarily supported on Linux environments. Our development environment, however, is Windows. With the utmost respect, may we ask if you could provide (or recommend) a way to run the CUDA-Q simulator on Windows—whether through a supported workflow, prebuilt environment, or other recommended approach (e.g., containerized tooling or a Windows-compatible path)? Any documentation, best practices, or program options you could share—even preliminary or in beta—would be sincerely appreciated.

Thank you very much for your time and consideration. We would be grateful for your guidance on the above and look forward to your reply.

Hi @jyjeon2,

There are 2 ways you can use CUDA-Q on Windows:

  1. Docker container
  2. wsl on Windows: This is a way to run Linux environment on Windows. Once you set it up you can use the Quick Start Instructions

To learn more about WSL see: Install WSL | Microsoft Learn

Thank you so much for your clear and helpful explanation! I really appreciate your support.