[Documentation] Python tutorial missing PyTorch export guidance and external data file handling
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 74/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- python, pytorch
- Domain
- documentation, machine-learning
Research direction
Start with the export-pytorch-model.html page and the Python inference tutorial linked in the issue. Verify the documented behavior for large PyTorch models with opset 17+ and external model data, then explain the companion .onnx.data requirement and how to merge the split files for a self-contained deployment file.
Written by the indexing model from the issue text.
Description
Describe the documentation issue
The Python inference tutorial (https://onnxruntime.ai/docs/api/python/tutorial.html) only covers sklearn → ONNX. The PyTorch export tutorial
(https://onnxruntime.ai/docs/tutorials/export-pytorch-model.html) only covers custom operators.
Neither page documents a common production gotcha: exporting large PyTorch models with opset 17+ automatically produces two files (model.onnx + model.onnx.data). InferenceSession fails if only model.onnx is present without the companion .data file.
Also undocumented: how to merge the split files into a single, self-contained .onnx file for distribution/deployment.
Page / URL
https://onnxruntime.ai/docs/tutorials/export-pytorch-model.html
- Dominant language
- C++
- Stars
- 21.9k
- Forks
- 4.2k
- Avg merge
- 3d 23h
- Merged PRs (30d)
- 172
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoft/onnxruntime
-
ep:MIGraphX
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
microsoft/onnxruntime#32352 · 1 comment ·
-
`optimization.disable_specified_optimizers` is documented as comma-separated but is parsed on `;` Open
Difficulty 1/5 Under an hour Newbie friendliness 88/100
microsoft/onnxruntime#32211 ·
-
stale
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
microsoft/onnxruntime#29750 · 3 comments ·
-
ep:WebGPU platform:web stale
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
microsoft/onnxruntime#28976 · 3 comments ·
-
[Documentation] Add C++ in-code profiling example code to the "Profiling Tools" documentation page Opendocumentation
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
microsoft/onnxruntime#28512 · 4 comments · 1 reaction ·
All issues in microsoft/onnxruntime
Similar issues
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
AXERA-TECH/ax-llm#77 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
bug-unconfirmed
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
NVIDIA/cuda-samples#453 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
infiniflow/infinity#3502 ·