Skip to main content

mxlpy-native

The compiled Radau, LSODA and CVODE solvers behind MxlPy's Native integrator, plus llvmlite, which compiles models to machine code for them. Install it through MxlPy rather than on its own:

pip install "mxlpy[native]"

Solvers and licences

Solver Origin Licence
RADAU5 E. Hairer and G. Wanner, via f2c c/vendor/HAIRER-LICENCE.txt
LSODA SciPy's C translation of ODEPACK c/vendor/SCIPY-LICENCE.txt
CVODE (BDF and Adams) SUNDIALS v7.9.0, © Lawrence Livermore National Security and the SUNDIALS contributors c/vendor/SUNDIALS-LICENCE.txt (BSD-3-Clause), c/vendor/SUNDIALS-NOTICE.txt

All three are vendored from mxl-solvers, whose README lists the papers to cite for SUNDIALS. The licence files ship in every wheel.

Platforms

Wheels are published for Linux (x86_64, aarch64; glibc 2.28+), macOS (arm64, 12+) and Windows (amd64, arm64), the platforms llvmlite has wheels for. On anything else, mxlpy[native] installs the WASM backend (wasmtime) instead, which runs the same solvers without a compiler, a little slower.

If pip has to build from the sdist anyway, it needs a C11 compiler (GCC 8+, Clang 7+ or MSVC 2019 16.8+), and nothing else: no Fortran, BLAS/LAPACK or Python headers. The build says what to install if the compiler is missing or fails.

Troubleshooting

python -m mxlpy_native

prints the installed version, the solver ABI, and whether the compiled solvers and llvmlite load, with a fix for each failure.

Development

uv sync           # builds the extension in place
uv run pytest

c/vendor/ is copied from mxl-solvers by its scripts/vendor.sh. vendor/VENDORED records the commit and file hashes, which tests/test_vendor.py checks. Fix solvers there, not here. c/mxn_solvers.c is the glue MxlPy calls, compiled unchanged into the wheel and into MxlPy's solvers.wasm (scripts/build_native_wasm.sh in MxlPy).

When an exported function's signature or meaning changes, bump MXN_ABI_VERSION in c/mxn_solvers.c, ABI_VERSION in src/mxlpy_native/__init__.py and the ABI MxlPy expects, then release both. MxlPy refuses a mismatched pair with an upgrade hint instead of crashing.

Releasing

Bump version in pyproject.toml and publish a GitHub release v<version>. The release workflow builds the wheels with cibuildwheel plus an sdist and uploads them to PyPI via trusted publishing.

Metadata

Release files for mxlpy-native 0.4.0

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

Source distribution (sdist)

Source distribution for mxlpy-native 0.4.0
File Size Uploaded Provenance Actions
mxlpy_native-0.4.0.tar.gz 233.4 kB With provenance Details for mxlpy_native-0.4.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mxlpy-native 0.4.0
File Actions
mxlpy_native-0.4.0-cp312-abi3-win_arm64.whl CPython 3.12 abi3 Windows ARM64 Details for mxlpy_native-0.4.0-cp312-abi3-win_arm64.whl
mxlpy_native-0.4.0-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for mxlpy_native-0.4.0-cp312-abi3-win_amd64.whl
mxlpy_native-0.4.0-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 Details for mxlpy_native-0.4.0-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
mxlpy_native-0.4.0-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.17+ ARM64, Linux glibc 2.28+ ARM64 Details for mxlpy_native-0.4.0-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
mxlpy_native-0.4.0-cp312-abi3-macosx_12_0_arm64.whl CPython 3.12 abi3 macOS 12.0+ ARM64 Details for mxlpy_native-0.4.0-cp312-abi3-macosx_12_0_arm64.whl

Total release size: 1.6 MB

Release files / mxlpy_native-0.4.0.tar.gz

Download URL mxlpy_native-0.4.0.tar.gz
Size 233.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e7246c493c4cdecfca6d7d52ad94f46b3d80851f889c4655df9d3ddc1f91a62a
BLAKE2b-256 checksum
How to use checksums
b3acad1c62d8eeb4cab14c99f85b5a282b03f69eb92acdaa2797085afd9f67ca
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 6, 2026.

Transparency log

Release files / mxlpy_native-0.4.0-cp312-abi3-win_arm64.whl

Download URL mxlpy_native-0.4.0-cp312-abi3-win_arm64.whl
Size 85.9 kB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
768fedf9aafc791050fdc03eee6503ca77aa57e291e4333d6fc237c8a795fd1a
BLAKE2b-256 checksum
How to use checksums
4350474b3641865ec59944d1e30a76bc8c4489f8f359abd0bc9059becebc1edd
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 6, 2026.

Transparency log

Release files / mxlpy_native-0.4.0-cp312-abi3-win_amd64.whl

Download URL mxlpy_native-0.4.0-cp312-abi3-win_amd64.whl
Size 96.1 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
ebcbccaf7f161155b9470d7a7d0eb3ec7993a00da75dbd7401769cfb89c36907
BLAKE2b-256 checksum
How to use checksums
2d84f765a2d29874b48f357f6c6f5bd450606f1fc98fcaee3aca4081749ca962
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 6, 2026.

Transparency log

Release files / mxlpy_native-0.4.0-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL mxlpy_native-0.4.0-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 490.6 kB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
fd59c1f07c3186cc2a78dd2b79902c5cd5f7b897488140444964e2e7b70bcff5
BLAKE2b-256 checksum
How to use checksums
9e3a310e315baf5341ce82e641f0c3fadf371c4e76514d9dc0b2c7392790268e
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 6, 2026.

Transparency log

Release files / mxlpy_native-0.4.0-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl

Download URL mxlpy_native-0.4.0-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
Size 473.2 kB
Tags CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
ac6890b441e2c29406e06d577d02fd9d483a54cc837eedec2bfc842ef714c318
BLAKE2b-256 checksum
How to use checksums
eeb7b62e3cdade99f855b3846ac01c106a420470ea9e793de2241a4545ce682c
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 6, 2026.

Transparency log

Release files / mxlpy_native-0.4.0-cp312-abi3-macosx_12_0_arm64.whl

Download URL mxlpy_native-0.4.0-cp312-abi3-macosx_12_0_arm64.whl
Size 182.2 kB
Tags CPython 3.12 abi3 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
76d4d43d0183195051f855b2934f8f59335fdbea31b5dde9bbc754af7ee7275f
BLAKE2b-256 checksum
How to use checksums
2939af859863383e075de9816dc0489346499d5761b4c446ae8c92fb14dd941d
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 6, 2026.

Transparency log

Security for mxlpy-native 0.4.0

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 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for mxlpy_native-0.4.0.tar.gz

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 6, 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.

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