Experimental tools for converting PyTorch models to ONNX
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
PyTorch to ONNX Exporter
Experimental torch ONNX exporter. Compatible with torch>=2.1.
[!WARNING] This is an experimental project and is not designed for production use. Use
torch.onnx.exportfor these purposes.
Installation
pip install --upgrade torch-onnx
Usage
import torch
import torch_onnx
from onnxscript import ir
import onnx
# Get an exported program with torch.export
exported = torch.export.export(...)
model = torch_onnx.exported_program_to_ir(exported)
proto = ir.to_proto(model)
onnx.save(proto, "model.onnx")
# Or patch the torch.onnx export API
# Set error_report=True to get a detailed error report if the export fails
torch_onnx.patch_torch(report=True, verify=True, profile=True)
torch.onnx.export(...)
# Use the analysis API to print an analysis report for unsupported ops
torch_onnx.analyze(exported)
Design
{dynamo/jit} -> {ExportedProgram} -> {torchlib} -> {ONNX IR} -> {ONNX}
- Use ExportedProgram
- Rely on robustness of the torch.export implementation
- Reduce complexity in the exporter
- This does not solve dynamo limitations, but it avoids introducing additional breakage by running fx passes
- Flat graph; Scope info as metadata, not functions
- Because existing tools are not good at handling them
- Eager optimization where appropriate
- Because exsiting tools are not good at optimizing
- Drop in replacement for torch.onnx.export
- Minimum migration effort
- Build graph eagerly in the exporter
- Give the exporter full control over the graph being built
Why is this doable?
- We need to verify torch.export coverage on Huggingface Optimum https://github.com/huggingface/optimum/tree/main/optimum/exporters/onnx; and they are not patching torch.onnx itself.
- Patch torch.onnx.export such that packages do not need to change a single line to use dynamo
- We have all operators implemented and portable
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
torch_onnx-0.1.21.tar.gz
(72.1 kB
view details)
Built Distribution
File details
Details for the file torch_onnx-0.1.21.tar.gz.
File metadata
- Download URL: torch_onnx-0.1.21.tar.gz
- Upload date:
- Size: 72.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/4.0.1 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0e90128bccbfc256b84c99cb46551f345db988268fd18f144c20b7997e92d7e5 |
|
| MD5 | d5971dabfbfaa88b535808498b72a153 |
|
| BLAKE2b-256 | 2e5c8a2c9da4434f1427b6534b7032fe72edd29a1b288e8b3b3d3ac5e3528a73 |
File details
Details for the file torch_onnx-0.1.21-py3-none-any.whl.
File metadata
- Download URL: torch_onnx-0.1.21-py3-none-any.whl
- Upload date:
- Size: 80.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/4.0.1 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b572e764596f15de26df0eb4858cbb175edef8b456af063a92e9223ccea2e10f |
|
| MD5 | 56f3ac4d646ae98d99df75e636e2d2a5 |
|
| BLAKE2b-256 | 67a0332f2415e91fe1906f1a57934b3f2103bb8e95afb2b145aca6413e47ac4a |
