onnx-ir

What's Changed

API

• Optional MetadataStore deep copy when cloning by @AyoubMDL in #354

Core

• Add path traversal and symlink protection to ExternalTensor by @Copilot in #386
• Harden ExternalTensor: hardlink detection and security documentation by @Copilot in #388

Graph Passes

• Fix identity preservation for initializers by @justinchuby in #360
• Fix name collision bug in LiftSubgraphInitializersToMainGraphPass by @srikris-sridhar in #381
• Fix initializer-safe bulk renaming and NameFixPass initializer iteration by @enpasos in #369
• Fix ShapeInferencePass crash on initializers without const_value by @Copilot in #380

New Contributors

• @srikris-sridhar made their first contribution in #381
• @enpasos made their first contribution in #369
• @AyoubMDL made their first contribution in #354

Full Changelog: v0.2.0...v0.2.1

What's Changed

API

• Create the infrastructure for symbolic shape inferencing by @justinchuby in #327, #344
• Improve magic methods in SymbolicDim by @justinchuby in #343

Graph Passes

• Improve error messages from the inliner by @justinchuby in #335

Bug fixes

• Fix sort() on subgraphs by @justinchuby in #347

Documentation

• Create docs for the analysis module by @justinchuby in #337
• Fix merge_shapes docstring to match implementation behavior by @Copilot in #348
• Restructure the skills folder by @justinchuby in #346

Other Changes

• Migrate test results upload to codecov-action@v5 by @Copilot in #334

Full Changelog: v0.1.16...v0.2.0

What's Changed

API

• Create the journaling system by @justinchuby in #322
• Create onnx_ir.schemas by migrating OpSignature from onnxscript by @justinchuby in #329

Graph Passes

• [pass] Update Inliner pass to allow specifying which node to inline by @justinchuby in #321

Documentation

• Document version addition for output fix pass by @justinchuby in #319
• Fix documentation for onnx_ir.journaling by @justinchuby in #330

Full Changelog: v0.1.15...v0.1.16

What's Changed

API

• Support saving external data as safetensors by @justinchuby in #306
• Add allow_outer_scope_values option in Graph.clone() by @justinchuby in #313

Graph Passes

• Add AddDefaultAttributesPass to populate missing optional attributes by @Copilot in #308
• Create implicit usage analysis by @justinchuby in #307

Bug fixes

• Use typing_extensions for missing types on Python 3.9 by @hsanzg in #312
• Copy node output shape/dtype information in clone() by @justinchuby in #314

Documentation

• Create examples for using IR passes by @justinchuby in #300
• Add pass writing skill for AI agents by @Copilot in #311

New Contributors

• @hsanzg made their first contribution in #312

Full Changelog: v0.1.14...v0.1.15

What's Changed

API

• Implement graph cloning methods by @justinchuby in #286
• Implement the graph extractor by @justinchuby in #294
• Create Value.merge_shapes() by @justinchuby in #290
• Define magic methods on Value by @justinchuby in #297

Other Changes

• Improve speed of op_identitifer by @xadupre in #279
• Bump version to 0.1.14 by @justinchuby in #301

Full Changelog: v0.1.13...v0.1.14_1

What's Changed

API

• Add methods to resize inputs and outputs in Node class by @justinchuby in #244

Core

• Escape [...] in text for rich display by @justinchuby in #243
• Adds INT2 (2-bit signed) and UINT2 (2-bit unsigned) data type by @vraspar in #251

Graph Passes

• Minor cleanup of cloning logic in inliner by @gramalingam in #252
• Add OutputFixPass to fix invalid graph outputs by @justinchuby in #269

Bug fixes

• Fix serialization of attribute reference by @gramalingam in #253

Documentation

• Improve documentation on replace_all_uses_with by @justinchuby in #237
• Create doctest for Tape by @justinchuby in #266

New Contributors

• @gramalingam made their first contribution in #253
• @vraspar made their first contribution in #251

Full Changelog: v0.1.12...v0.1.13

What's Changed

This update introduces the Value.replace_all_uses_with method, added for its convenience and discoverability. A new replace_graph_outputs option has been included, allowing users to replace graph outputs as well.

BC Breaking

• Implement replace_all_uses_with on Value by @justinchuby in #235

Bug fixes

• Avoid override new_value info with None from old_value by @titaiwangms in #227

Other Changes

• Remove an inline import by @justinchuby in #222

Full Changelog: v0.1.11...v0.1.12

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

This release introduces a new API tofile() on Tensors. It helps avoid unnecessary copies with tobytes() when a model is saved with external data. The API is introduced in a backward-compatible manner. See https://github.com/onnx/ir-py/pull/210 for more information.

API

• Implement tofile on tensors to reduce data write time by 40% by @justinchuby in https://github.com/onnx/ir-py/pull/210

Core

• Improve value renaming by @justinchuby in https://github.com/onnx/ir-py/pull/208

Graph Passes

• Implement shape merging in identity elimination pass by @justinchuby in https://github.com/onnx/ir-py/pull/206

Bug fixes

• Fix big endian handling in tobypes by @justinchuby in https://github.com/onnx/ir-py/pull/209

Other Changes

• Remove Python version classifiers from pyproject.toml by @justinchuby in https://github.com/onnx/ir-py/pull/219
• Add a torch tensor contiguous check by @titaiwangms in https://github.com/onnx/ir-py/pull/220

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.10...v0.1.11

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Update the graph initializers dictionary when renaming Value by @justinchuby in https://github.com/onnx/ir-py/pull/197
• Create is_unknown and has_unknown_dim on Shape by @justinchuby in https://github.com/onnx/ir-py/pull/201

Graph Passes

• [pass] Preserve value metadata in LiftConstantsToInitializersPass by @justinchuby in https://github.com/onnx/ir-py/pull/204

Bug fixes

• Fix metadata props handling for values by @justinchuby in https://github.com/onnx/ir-py/pull/198
• Handle when the value type is not known when serializing shapes by @justinchuby in https://github.com/onnx/ir-py/pull/203

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.9...v0.1.10

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

Breaking Changes and Deprecations

• Simplify attribute signatures and use tuples for repeating attrs by @justinchuby in https://github.com/onnx/ir-py/pull/186
• Deprecate ir.Input in favor of ir.val by @justinchuby in https://github.com/onnx/ir-py/pull/185

API

• Ensure int/float attributes are stored as Python int/float by @justinchuby in https://github.com/onnx/ir-py/pull/178
• Create a convenience constructor for Value by @justinchuby in https://github.com/onnx/ir-py/pull/179

Core

• Support deserializing non-utf8 attributes in rare case by @justinchuby in https://github.com/onnx/ir-py/pull/184

Documentation

• Add missing .. versionadded:: for DataType.is_string by @iksnagreb in https://github.com/onnx/ir-py/pull/177

Other Changes

• Require ml_dtypes>=0.5.0 by @justinchuby in https://github.com/onnx/ir-py/pull/188
• Change Attr __str__ to use repr() by @justinchuby in https://github.com/onnx/ir-py/pull/190

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.8...v0.1.9

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

[!NOTE] This patch release includes a fix in the protobuf serialization logic to handle Boolean attributes for compatibility with protobuf>=6.

Bug fixes

• [serde] Cast attribute values to int or float by @justinchuby in https://github.com/onnx/ir-py/pull/175

API

• Add more properties for numeric types to DataType by @iksnagreb in https://github.com/onnx/ir-py/pull/171

Graph Passes

• Support string tensors in DeduplicateInitializersPass and call_onnx_api by @iksnagreb in https://github.com/onnx/ir-py/pull/169

Documentation

• Create diagram for IR objects by @justinchuby in https://github.com/onnx/ir-py/pull/69
• Fix typos in the diagram by @justinchuby in https://github.com/onnx/ir-py/pull/173

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.7...v0.1.8

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Add meta field to attributes for metadata storage by @Copilot in https://github.com/onnx/ir-py/pull/154
• Expose the graph property in ir.Function by @justinchuby in https://github.com/onnx/ir-py/pull/158
• Default attribute type to INTS to avoid breaking BC by @justinchuby in https://github.com/onnx/ir-py/pull/162
• Expose DeduplicateHashedInitializersPass by @justinchuby in https://github.com/onnx/ir-py/pull/163

Core

• Update node deser logic to support out of order subgraphs by @justinchuby in https://github.com/onnx/ir-py/pull/159

Graph Passes

• Fix initializer handling in LiftSubgraphInitializersToMainGraphPass pass by @justinchuby in https://github.com/onnx/ir-py/pull/148
• [pass] Deduplicate initializers in subgraphs and fix bug in subgraph() by @justinchuby in https://github.com/onnx/ir-py/pull/156
• [pass] Create DeduplicateHashedInitializersPass by @justinchuby in https://github.com/onnx/ir-py/pull/133

Documentation

• Fix a typo in NameFixPass docs by @justinchuby in https://github.com/onnx/ir-py/pull/147

Other Changes

• Bump version to 0.1.7 by @justinchuby in https://github.com/onnx/ir-py/pull/146
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/onnx/ir-py/pull/153
• Bump ruff from 0.12.8 to 0.12.9 in /requirements/lintrunner by @dependabot[bot] in https://github.com/onnx/ir-py/pull/152
• Bump editorconfig-checker from 3.2.1 to 3.4.0 in /requirements/lintrunner by @dependabot[bot] in https://github.com/onnx/ir-py/pull/151
• Adjust serde to remove outdated comments and fix error handling by @justinchuby in https://github.com/onnx/ir-py/pull/149
• Create a tabular model printer tool by @justinchuby in https://github.com/onnx/ir-py/pull/155
• Update license to a valid SPDX license expression by @justinchuby in https://github.com/onnx/ir-py/pull/160
• Bump types-pyyaml from 6.0.12.20250516 to 6.0.12.20250809 in /requirements/lintrunner by @dependabot[bot] in https://github.com/onnx/ir-py/pull/143
• Update pyproject.toml to require setuptools>=77 by @justinchuby in https://github.com/onnx/ir-py/pull/161

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.6...v0.1.7

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

[!NOTE] This patch release includes a fix for compatibility with PyTorch <2.7.0 in the tensor_adapters module. It is recommended that you update to this version if you leverage onnx_ir.tensor_adapters to interact with torch tensors.

Graph Passes

• Create a name fix pass to ensure unique names for all values and nodes by @Copilot in https://github.com/onnx/ir-py/pull/124

Bug fixes

• Fix support for torch.float8_e8m0fnu for older versions of PyTorch by @justinchuby in https://github.com/onnx/ir-py/pull/145

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.5...v0.1.6

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Add support for FLOAT8E8M0 data type by @Copilot in https://github.com/onnx/ir-py/pull/128

Graph Passes

• Create a identity-elimination pass by @Copilot in https://github.com/onnx/ir-py/pull/121

Other Changes

• Remove import from _custom_element_types in test by @justinchuby in https://github.com/onnx/ir-py/pull/136

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.4...v0.1.5

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

[!NOTE] This release includes a fix to the 4 bit dtype handling logic in the TensorProtoTensor.numpy() method. You should update to this version if you use onnx-ir to process 4 bit tensor data (uint4, int4, float4e2m1) numerically with NumPy.

Bug Fixes

• Fix 4bit tensor unpacking by @justinchuby in https://github.com/onnx/ir-py/pull/118

API

• [DataType] Add is_integer and is_signed queries by @iksnagreb in https://github.com/onnx/ir-py/pull/110

Documentation

• Add versionadded in docs for enum methods by @justinchuby in https://github.com/onnx/ir-py/pull/113

Other Changes

• Bump version to 0.1.4 by @justinchuby in https://github.com/onnx/ir-py/pull/111
• Update CONTRIBUTING on DCO by @justinchuby in https://github.com/onnx/ir-py/pull/112
• Create py.typed to allow type checkers by @justinchuby in https://github.com/onnx/ir-py/pull/114
• Move py.typed by @justinchuby in https://github.com/onnx/ir-py/pull/115

New Contributors

• @iksnagreb made their first contribution in https://github.com/onnx/ir-py/pull/110

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.3...v0.1.4

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Create adapters for torch by @justinchuby in https://github.com/onnx/ir-py/pull/94
• Expose DeduplicateInitializersPass in common passes module by @copilot-swe-agent in https://github.com/onnx/ir-py/pull/99

Graph Passes

• Add deduplication pass for initializer tensors by @AbhishekHerbertSamuel in https://github.com/onnx/ir-py/pull/67
• [Pass] Support CSE constant nodes by @titaiwangms in https://github.com/onnx/ir-py/pull/92

Bug fixes

• Support numpy scalars in Tensor by @justinchuby in https://github.com/onnx/ir-py/pull/102

Documentation

• Document changes between versions in docstrings by @justinchuby in https://github.com/onnx/ir-py/pull/105
• Create CONTRIBUTING.md with development setup and lintrunner guidance by @copilot-swe-agent in https://github.com/onnx/ir-py/pull/107

Other Changes

• Bump version to 0.1.3 by @justinchuby in https://github.com/onnx/ir-py/pull/91
• [docs] Expose ir_tensor_adapters by @justinchuby in https://github.com/onnx/ir-py/pull/95
• Set up copilot by @justinchuby in https://github.com/onnx/ir-py/pull/97

New Contributors

• @AbhishekHerbertSamuel made their first contribution in https://github.com/onnx/ir-py/pull/67
• @copilot-swe-agent made their first contribution in https://github.com/onnx/ir-py/pull/99

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.2...v0.1.3

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Support initializers with onnxtext by @justinchuby in https://github.com/onnx/ir-py/pull/60
• Implement all_nodes() and subgraphs() as convenience methods by @justinchuby in https://github.com/onnx/ir-py/pull/76
• Update from_onnx_text method by @justinchuby in https://github.com/onnx/ir-py/pull/80
• External data callback and ir.save fixes by @justinchuby in https://github.com/onnx/ir-py/pull/85
• Convenience function get_const_tensor by @justinchuby in https://github.com/onnx/ir-py/pull/45

Graph Passes

• [pass] Check post conditions on the resulting model by @justinchuby in https://github.com/onnx/ir-py/pull/78

Documentation

• Improve docs for attributes and initializers by @justinchuby in https://github.com/onnx/ir-py/pull/64
• Create logos for the documentation site by @justinchuby in https://github.com/onnx/ir-py/pull/65
• Set autodoc_typehints to descriptions in docs by @justinchuby in https://github.com/onnx/ir-py/pull/68
• Improve docstrings by @justinchuby in https://github.com/onnx/ir-py/pull/75
• Use copilot to improve documentation by @justinchuby in https://github.com/onnx/ir-py/pull/88
• Add PackedTensor and MetadataStore to docs by @justinchuby in https://github.com/onnx/ir-py/pull/90

Other Changes

• Bump version to 0.1.2 by @justinchuby in https://github.com/onnx/ir-py/pull/61
• [Easy] Update name as ir-py instead of onnx-ir by @jcwchen in https://github.com/onnx/ir-py/pull/49
• Improve README.md by @xadupre in https://github.com/onnx/ir-py/pull/71
• Print value type in Tensor init error message by @justinchuby in https://github.com/onnx/ir-py/pull/74
• Create PackedTensor for representing 4bit tensors by @justinchuby in https://github.com/onnx/ir-py/pull/89
• Ban onnx imports by @justinchuby in https://github.com/onnx/ir-py/pull/87

New Contributors

• @jcwchen made their first contribution in https://github.com/onnx/ir-py/pull/49
• @xadupre made their first contribution in https://github.com/onnx/ir-py/pull/71

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.1...v0.1.2

<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

API

• Create add methods on initializers and attributes by @justinchuby in https://github.com/onnx/ir-py/pull/33

Core

• Prevent values produced by other nodes to be added as graph inputs by @justinchuby in https://github.com/onnx/ir-py/pull/51

Graph Passes

• [pass] Add CSE by @titaiwangms in https://github.com/onnx/ir-py/pull/36

Bug fixes

• Revert changes to LiftConstantsToInitializersPass by @justinchuby in https://github.com/onnx/ir-py/pull/41

Documentation

• Remove RefAttr from docs because it is not a class by @justinchuby in https://github.com/onnx/ir-py/pull/35
• Create release.yml for generating release notes by @justinchuby in https://github.com/onnx/ir-py/pull/52

Other Changes

• Rename reuse job to make required by @justinchuby in https://github.com/onnx/ir-py/pull/37
• Configure the do-not-merge bot by @justinchuby in https://github.com/onnx/ir-py/pull/40
• Bump version number to v0.1.1 by @justinchuby in https://github.com/onnx/ir-py/pull/42
• Update codecov.yml to ignore unit tests by @justinchuby in https://github.com/onnx/ir-py/pull/53

New Contributors

• @titaiwangms made their first contribution in https://github.com/onnx/ir-py/pull/36

Full Changelog: https://github.com/onnx/ir-py/compare/v0.1.0...v0.1.1

First official release of the onnx_ir package.