ONNX Model Structure Viewer failed or looks wrong? Troubleshooting guide
Troubleshoot extensions, file structure, dependencies, encoding, memory, and output error in ONNX Model Structure Viewer while preserving the source.
Preserve the source first
Do not rename and overwrite the original, and do not treat a browser preview as the only acceptance record. Use a small copy and record size, producer, version, browser, and exact error.
The easy-to-miss fact for this format
For images: float32[1,3,640,640] with a dynamic detection output, record the opset and custom domains, then actually load it in the target ONNX Runtime release.
Recommended troubleshooting order
- Test the page example or a smaller known-good file to confirm the tool runs.
- Check extension, signature, companion files, remote URL, and CORS; exclude a downloaded HTML error page.
- Supply the input again according to the workflow:
- Choose an .onnx model.
- Review IR/opset, producer, input/output names, and shapes.
- Search nodes, operator domains, initializers, and dynamic dimensions.
- Export a summary for debugging and test compatibility in the target runtime.
- Close memory-heavy tabs and retry in current Chrome or Edge.
- If it still fails, re-export from the producing application and validate in the receiving system.
Common questions and answers
Can it prove browser compatibility?
No. Operator coverage, dynamic shapes, and runtime versions require an execution test.
Does it execute model code?
No, it only parses model structure.
Are weights uploaded?
Processing runs in this browser tab; the file is not uploaded to FreeTool to perform the task.
Limits that must not be bypassed
- No inference, benchmarking, or numeric correctness testing
- External data and custom operators are shown as references only
- Huge initializers expose metadata rather than every value
Privacy handling
Local input is not uploaded to FreeTool for processing; remote IIIF/DZI URLs are requested by the browser from their source. Troubleshooting images, OCR text, model summaries, and converted files may contain sensitive or copyrighted content. De-identify and confirm rights before sharing.