Skip to content

Document how new problems support Nsight Compute profiling - #171

Merged
msaroufim merged 1 commit into
mainfrom
docs/ncu-problem-guide
Sep 17, 2026
Merged

msaroufim merged 1 commit into
mainfrom
docs/ncu-problem-guide

Conversation

@msaroufim

@msaroufim msaroufim commented Sep 17, 2026 •

Copy link
Copy Markdown
Member

Follow-up: hosted setup and provenance corrections are in #172.

New problem authors need a real NCU profile path to produce hardware-counter reports. Add a contributor guide, linked from the README, covering the custom_kernel NVTX range, benchmark selection, child-process capture, separate NCU/PyTorch paths, result logging, and GPU validation.

--profile uses normal Popcorn registration and the hosted GPU Mode API. Users need no provider SDK, account, credentials, or endpoint configuration. --profile-brev explicitly selects Brev; failures never switch providers. The guide explains that hosted tasks must be synced by an operator and local evaluator edits do not update the service.

Validation: compiled all three Python examples in their intended scope, checked relative links and whitespace, and checked the contract against problems/linalg/qr_v2 and the shared NVIDIA evaluator at 51e22db671d36c1c76091c43c36a44546ba324a1. The QR v2 benchmark-0 B200 integration run returned a report and text/CSV exports through the revised API with no Modal executable or credentials available to the CLI. This does not establish support for every problem or metric.

Companion CLI: gpu-mode/popcorn-cli#80. Backend: gpu-mode/kernelbot#530. The CLI release depends on that API/runner deployment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant