[CMAKE] Enable realtime cmake component in CUDA-Q by 1tnguyen · Pull Request #4709 · NVIDIA/cuda-quantum

1tnguyen · 2026-06-10T00:13:46Z

Added realtime to CUDAQ_ALL_PROJECTS. This is still disabled by default, -DCUDAQ_ENABLE_PROJECTS=...;realtime to enable. Once enabled, it will build realtime along the local simulator support for device_call's realtime dispatch.
Added source-tree cudaq::cudaq-realtime* aliases so that in-source builds use the same target names as installed realtime exports.

There are some other cmake fixes in test mainly to facilitate in-source build (-DCUDAQ_ENABLE_PROJECTS=...;realtime) under various build configurations (e.g., wheels/installers) of CUDA-Q.

Note: there will be a follow-up CI update to enable realtime in the main CUDA-Q CI.

Signed-off-by: Thien Nguyen <thiennguyen@nvidia.com>

github-actions · 2026-06-10T01:07:32Z

CI Summary (`push`) — ✅ passed

Run #27246949100 · ✅ 6 · ⏩ 7 · ❌ 0 · ⛔ 0

Top-level jobs (13)

Job	Result
`binaries`	⏩ skipped
`build_and_test`	✅ success
`config_devdeps`	✅ success
`config_source_build`	⏩ skipped
`config_wheeldeps`	✅ success
`devdeps`	✅ success
`docker_image`	⏩ skipped
`gen_code_coverage`	⏩ skipped
`metadata`	✅ success
`python_metapackages`	⏩ skipped
`python_wheels`	⏩ skipped
`source_build`	⏩ skipped
`wheeldeps`	✅ success

⏩ Skipped jobs (7) — intentionally skipped on PR builds; run on merge_group / workflow_dispatch

Job
`binaries`
`config_source_build`
`docker_image`
`gen_code_coverage`
`python_metapackages`
`python_wheels`
`source_build`

All sub-jobs (42) — every matrix leg, with links

Job	Status	Link
Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Python)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view
CI Summary	❔ in_progress	view
Configure build (devdeps)	✅ success	view
Configure build (source_build)	⏩ skipped	view
Configure build (wheeldeps)	✅ success	view
Create CUDA Quantum installer	⏩ skipped	view
Create Docker images	⏩ skipped	view
Create Python metapackages	⏩ skipped	view
Create Python wheels	⏩ skipped	view
Gen code coverage	⏩ skipped	view
Load dependencies (amd64, gcc12) / Caching	✅ success	view
Load dependencies (amd64, gcc12) / Finalize	✅ success	view
Load dependencies (amd64, gcc12) / Metadata	✅ success	view
Load dependencies (amd64, llvm) / Caching	✅ success	view
Load dependencies (amd64, llvm) / Finalize	✅ success	view
Load dependencies (amd64, llvm) / Metadata	✅ success	view
Load dependencies (arm64, gcc12) / Caching	✅ success	view
Load dependencies (arm64, gcc12) / Finalize	✅ success	view
Load dependencies (arm64, gcc12) / Metadata	✅ success	view
Load dependencies (arm64, llvm) / Caching	✅ success	view
Load dependencies (arm64, llvm) / Finalize	✅ success	view
Load dependencies (arm64, llvm) / Metadata	✅ success	view
Load source build cache	⏩ skipped	view
Load wheel dependencies (amd64, 12.6) / Caching	✅ success	view
Load wheel dependencies (amd64, 12.6) / Finalize	✅ success	view
Load wheel dependencies (amd64, 12.6) / Metadata	✅ success	view
Load wheel dependencies (amd64, 13.0) / Caching	✅ success	view
Load wheel dependencies (amd64, 13.0) / Finalize	✅ success	view
Load wheel dependencies (amd64, 13.0) / Metadata	✅ success	view
Load wheel dependencies (arm64, 12.6) / Caching	✅ success	view
Load wheel dependencies (arm64, 12.6) / Finalize	✅ success	view
Load wheel dependencies (arm64, 12.6) / Metadata	✅ success	view
Load wheel dependencies (arm64, 13.0) / Caching	✅ success	view
Load wheel dependencies (arm64, 13.0) / Finalize	✅ success	view
Load wheel dependencies (arm64, 13.0) / Metadata	✅ success	view
Prepare cache clean-up	❔ in_progress	view
Retrieve PR info	✅ success	view

✅ Required checks (6/6) — declared in .github/required-checks.yml for push

Required check	Status	Link
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Python)	✅ success	view

sacpis · 2026-06-10T15:30:48Z

+      "-D_AVXNECONVERTINTRIN_H_INCLUDED")
+  endif()
+
+  if(CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 12)


Duplicate (line 77) if loops condition? Can be merged into one.

sacpis

Overall LGTM. Thanks @1tnguyen. Left a few comments.

sacpis · 2026-06-10T16:06:58Z

+constexpr std::uint32_t fnv1aHash(const char *str) {
+  std::uint32_t hash = 2166136261u;
+  while (*str) {
+    hash ^= static_cast<std::uint32_t>(*str++);
+    hash *= 16777619u;
+  }
+  return hash;
+}


Let's use the fnv1a_hash from cudaq/realtime/daemon/dispatcher/dispatch_kernel_launch.h" instead?

sacpis · 2026-06-10T16:12:02Z

+else()
+  set(CUDAQ_REALTIME_STANDALONE_BUILD FALSE)


nit: False can be set as a default outside the loop. This can help with getting rid of else.

sacpis · 2026-06-10T16:15:00Z

+    set(CMAKE_CUDA_FLAGS "${CMAKE_CUDA_FLAGS} -shared -std=c++17 ${CUDA_gencode_flags} --compiler-options ${_host_compiler_opts}")
+
+    enable_language(CUDA)
+    set(CUDA_FOUND TRUE)
+    set(CMAKE_CUDA_STANDARD 17)


I read the comment above but would like to go with C++20 here. Is it always the case that nvcc's C++20 frontend hit the internal compiler error? Or is there any workaround for the same?

sacpis · 2026-06-10T16:31:29Z

+  if ((requestLen > 0 && !request) || !responseLen)
+    return DeviceCallInvalidArgumentStatus;
+  if (responseCapacity > 0 && !response)
+    return DeviceCallInvalidArgumentStatus;


nit: can be put in a validate function.

1tnguyen and others added 2 commits June 9, 2026 23:59

Enable realtime cmake component

5fe14c8

Signed-off-by: Thien Nguyen <thiennguyen@nvidia.com>

Merge branch 'main' into tnguyen/realtime-cmake

7955bb0

1tnguyen linked an issue Jun 10, 2026 that may be closed by this pull request

Add realtime to the CUDAQ_ENABLE_PROJECTS variable #4626

Open

1tnguyen marked this pull request as ready for review June 10, 2026 01:28

Merge branch 'main' into tnguyen/realtime-cmake

9a84bbe

1tnguyen requested review from mitchdz, sacpis and schweitzpgi June 10, 2026 01:28

sacpis reviewed Jun 10, 2026

View reviewed changes

sacpis approved these changes Jun 10, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[CMAKE] Enable realtime cmake component in CUDA-Q#4709

[CMAKE] Enable realtime cmake component in CUDA-Q#4709
1tnguyen wants to merge 3 commits into
NVIDIA:mainfrom
1tnguyen:tnguyen/realtime-cmake

1tnguyen commented Jun 10, 2026

Uh oh!

github-actions Bot commented Jun 10, 2026 •

edited

Loading

Uh oh!

sacpis Jun 10, 2026

Uh oh!

sacpis left a comment

Uh oh!

sacpis Jun 10, 2026

Uh oh!

sacpis Jun 10, 2026

Uh oh!

sacpis Jun 10, 2026

Uh oh!

sacpis Jun 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

1tnguyen commented Jun 10, 2026

Uh oh!

github-actions Bot commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI Summary (push) — ✅ passed

Uh oh!

sacpis Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

sacpis left a comment

Choose a reason for hiding this comment

Uh oh!

sacpis Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

sacpis Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

sacpis Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

sacpis Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Jun 10, 2026 •

edited

Loading

CI Summary (`push`) — ✅ passed