docs: diagnose actual AutoModel GPU placement - #3740
Merged
Merged
Conversation
Signed-off-by: LauraGPT <18321252+LauraGPT@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Related to #3738. The reporter has since confirmed the environment remedy and closed the support issue; a runtime fallback warning remains a separate follow-up.
Only
docs/troubleshooting.mdanddocs/troubleshooting_zh.mdchange. No runtime behavior, dependencies, model defaults, deployment settings or generated site files change.Type of change
Validation
Exact signed head:
03e18dccb1c9228d49e2c59e6922546d34b22d8a, based on12e417f4fa4490296ea2d81c5352ea2de8e4cac2.git diff --check: passed. A separate Codex reviewer checked the two exact file hashes, source fallback semantics and translation parity; no actionable P1/P2 findings. This is not human maintainer approval.The remote observation wrapper timed out after receiving some test output. Terminal receipts were independently re-read for every native test/build/validation/comparison process; no completed work was restarted merely because observation expired.
No ASR model was downloaded or loaded, no real transcription or GPU inference was run, and no service was deployed. The issue's Windows/RTX 3080 behavior is not reproduced or claimed fixed. The diagnostic helper is documentation, not a new runtime API or a newly committed unit-test module. This contribution was generated and reviewed with Codex.
python -m compileall funasr examples tests(not run; documentation-only change)User impact
New Python SDK users can inspect effective placement before reinstalling packages or treating a low utilization graph as a GPU failure. Both language versions direct installation questions to the maintained, platform-aware guide.
Notes for reviewers
Review the device-versus-utilization distinction and the documented CPU fallback against
AutoModel.build_model. The original user issue still needs reporter output. The documentation catalogue already renders these two source files into the bilingual product site; no manual deployment or generated-file update is part of this PR.Merged Outcome
Merged as
e9d002b54d0ba0592797d13d6ffd742c7d41ca75. Exact-head Product site run 36682086015 completed successfully, including build-and-validate, legacy-docs-links and browser. The merge tree and both document bytes match the reviewed/tested head; the GitHub merge signature is verified. This used the existing administrator exemption through the normal SHA-guarded merge API, without changing protection rules or creating an approval.The reporter of #3738 independently reported that selecting a CUDA-enabled PyTorch build resolved their usage problem and closed the issue. This is reporter confirmation, not our hardware reproduction. Their suggestion for a visible fallback warning remains a separate runtime follow-up. No production website deployment is claimed.
Post-merge checks on
e9d002b54d0ba0592797d13d6ffd742c7d41ca75: Product site 36684747811 succeeded with all three jobs, including browser; Update API Documentation 36684747740 also succeeded. These are exact-merge CI results, not a claim that the production website was deployed.