Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

OMMX

Docs/en Docs/ja Discord-EN Discord-JP Ask DeepWiki

OMMX (Open Mathematical prograMming eXchange) lets you describe what you want to solve separately from how you solve it. Its Python and Rust SDKs provide a common representation for optimization problems and candidate solutions. You can change the formulation you send to a solver and still evaluate the result against the domains, constraints, and objective of your original problem.

Why use OMMX?

Suppose a production line can make up to 100 units per hour, but only 60 in reduced mode. You can record the conditional limit once as an indicator constraint. The PySCIPOpt adapter can pass this constraint directly to SCIP. To try a different formulation with the same solver, you can instead use OMMX to convert the rule to a linear inequality using the known upper bound of 100.

Either way, a candidate that produces 65 units per hour in reduced mode violates the original rule. OMMX can check that rule for a candidate from either formulation, or even one proposed by a planner. You can try a new formulation without rewriting the requirement or the check. Checking feasibility tells you whether the candidate satisfies the model; proving optimality requires a separate guarantee.

The same division of work applies to other tasks:

  • Prepare a problem for a solver or sampler. Reuse supported operations such as integer encoding and bound tightening. You choose which transformations are appropriate and, when constraints become penalties, how to weight them. Adapters handle backend input and translate results back into OMMX.
  • Compare candidates on the original problem. Recover fixed or dependent variable values when a transformation records the information needed to do so. Evaluate candidates against the same constraints and objective regardless of where they came from.
  • Save what you need for later. Artifacts package problems and results with metadata. Experiments record trials and settings when you want to revisit a comparison.

Today, OMMX provides individual transformations and preparation policies. The longer-term goal is to use the structure of a problem to select and combine preprocessing steps. Developing these techniques on a common representation lets improvements benefit multiple modeling tools and gives new solving methods a body of work to build on.

Find your next step

The Book explains when to use each capability and how to interpret the results. The API Reference documents individual operations, their conditions, and executable usage examples.

Purpose Start here
Understand OMMX and explore its capabilities English Book · 日本語Book
Choose how to represent a problem for a solver Transform a problem · 日本語
Check a candidate against your requirements Evaluate candidates · 日本語
Choose a solver or sampler integration Adapter packages and input contracts
Install the Python SDK and an optional adapter Installation guide · 日本語
Inspect and exchange saved data from the command line OMMX CLI

Until the 3.0.0 stable release, both the Book and API Reference describe main. The installation guide covers the latest published prerelease and installation from main; use main for features that have not been released yet. Rust and Python SDK versions are managed independently.

SDK Package API Reference
Python PyPI Python API Reference
Rust crates.io docs.rs

Development

See DEVELOPMENT.md to work on OMMX, or the Adapter API Reference to connect your own solving tool. The Rust-to-Python PyO3 bridge has its own API Reference.

CodSpeed Badge

License

© 2024 Jij Inc.

This project is licensed under either of

at your option.

Acknowledgement

BRIDGE

This work was performed for Council for Science, Technology and Innovation (CSTI), Cross-ministerial Strategic Innovation Promotion Program (SIP), "Promoting the application of advanced quantum technology platforms to social issues"(Funding agency : QST).

Metadata

Release files for ommx 3.0.0rc1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for ommx 3.0.0rc1
File Actions
ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl CPython 3.15 abi3t, abi3 Linux glibc 2.28+ x86-64 Details for ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl
ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl CPython 3.15 abi3, abi3t Linux glibc 2.28+ ARM64 Details for ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl
ommx-3.0.0rc1-cp315-abi3.abi3t-macosx_11_0_arm64.whl CPython 3.15 abi3, abi3t macOS 11.0+ ARM64 Details for ommx-3.0.0rc1-cp315-abi3.abi3t-macosx_11_0_arm64.whl
ommx-3.0.0rc1-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for ommx-3.0.0rc1-cp311-abi3-win_amd64.whl
ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.28+ x86-64 Details for ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_x86_64.whl
ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_aarch64.whl CPython 3.11 abi3 Linux glibc 2.28+ ARM64 Details for ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_aarch64.whl
ommx-3.0.0rc1-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for ommx-3.0.0rc1-cp311-abi3-macosx_11_0_arm64.whl

Total release size: 69.6 MB

Release files / ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl

Download URL ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl
Size 10.9 MB
Tags CPython 3.15 Linux glibc 2.28+ x86-64 abi3 abi3t
SHA-256 checksum
How to use checksums
476af33fbe3c4bc2c4d9086df10727a70451ff3ad530e1f59ef1c91fc755c462
BLAKE2b-256 checksum
How to use checksums
469bc1f61c156e8528fba94c138297f10d7459fd3910dddd2e9b12e26efd19f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl

Download URL ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_aarch64.whl
Size 9.7 MB
Tags CPython 3.15 Linux glibc 2.28+ ARM64 abi3 abi3t
SHA-256 checksum
How to use checksums
91ec24baa9ef01ed92b65942b42465fbd88c281d2e6c727f94a47c614aa9f842
BLAKE2b-256 checksum
How to use checksums
1a25c7549afeae6e3b96ed1d4ed91077d8eaae62c388eca93a1829d13a0ddea2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp315-abi3.abi3t-macosx_11_0_arm64.whl

Download URL ommx-3.0.0rc1-cp315-abi3.abi3t-macosx_11_0_arm64.whl
Size 9.6 MB
Tags CPython 3.15 abi3 abi3t macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1315cc3285593da61186cb0e969ef95cd6103935ffbf193f3a4ebdd0e5c148fb
BLAKE2b-256 checksum
How to use checksums
d769c6fa62b59c43b73ddb56e354c1a5291d5cf648f3c854578311cc625dce08
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp311-abi3-win_amd64.whl

Download URL ommx-3.0.0rc1-cp311-abi3-win_amd64.whl
Size 10.0 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
1b6277c2427a6b6aa9b7588ffab32d3a92bc468ee48600bf8a4b5b70049c8a47
BLAKE2b-256 checksum
How to use checksums
3d27a682f8317165cbf0f3e775827cc6383a3510409bb383f54218846ac372a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_x86_64.whl

Download URL ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_x86_64.whl
Size 10.5 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
6b25611b90a41890fdff6af0c73970bbc41d9905bb925f7fa17e8635f5594ac5
BLAKE2b-256 checksum
How to use checksums
68a4ed3ff0bfd373c1f254c07ea1692369379f774f38d6526a3040834464d20a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_aarch64.whl

Download URL ommx-3.0.0rc1-cp311-abi3-manylinux_2_28_aarch64.whl
Size 9.4 MB
Tags CPython 3.11 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
2b86c220a3263eb3b99745f458e08fadd613e94ab253973171c7bdf65210ba8e
BLAKE2b-256 checksum
How to use checksums
f17f1b5dba9001dc5aa4170459778914df878efcfeedbf00d0a275abf2e227c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / ommx-3.0.0rc1-cp311-abi3-macosx_11_0_arm64.whl

Download URL ommx-3.0.0rc1-cp311-abi3-macosx_11_0_arm64.whl
Size 9.3 MB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
39083ec4a087c3ad4218d0be86ebcbf3392fd48b263766681a450d621ba1abe0
BLAKE2b-256 checksum
How to use checksums
e323eb88511ceb5a750da21edda723fff6e4e979663ffb719c06dbe7ff12733b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for ommx 3.0.0rc1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 7 files in this release have been uploaded with provenance metadata.

Select from 7 files

Attestation for ommx-3.0.0rc1-cp315-abi3.abi3t-manylinux_2_28_x86_64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page