Skip to main content

mymyr

CI Wheels PyPI

A data-oriented, lifted-first rewrite of the mimir classical-planning core, with free-threaded Python bindings and an optional CUDA backend.

mymyr parses PDDL, searches for plans, builds state spaces and provides batched reinforcement-learning environments and relational state encodings for NumPy, JAX and PyTorch. Native work releases the GIL. Free-threaded Python also lets Python callbacks and concurrent Python callers run in parallel; on a GIL interpreter, Python callbacks take turns on the GIL.

Install from PyPI

With uv installed:

uv venv .venv --python 3.14t
uv pip install --python .venv/bin/python mymyr

CPU wheels support CPython 3.14 and 3.15, both GIL (3.14, 3.15) and free-threaded (3.14t, 3.15t), on Linux x86_64 with glibc 2.34 or newer and macOS arm64 with macOS 15 or newer. Change --python to select an interpreter. Wheels include the PDDL parser and C++ SDK. For Gymnasium environments, install mymyr[gym]; install JAX or PyTorch separately when using those integrations.

Releases after 0.1.0 attach CUDA wheels for free-threaded CPython 3.14 and 3.15 on Linux x86_64 to their GitHub Release, with the version <version>+cu13 (v0.1.0 has CPU wheels only). They need an NVIDIA driver 580 or newer and carry GPU code for compute capabilities 8.6, 8.9 and 9.0. With <version> the release's version:

uv pip install --python .venv/bin/python "mymyr==<version>+cu13" \
    --find-links https://github.com/maichmueller/mymyr/releases/expanded_assets/v<version>

See Installing a CUDA wheel for other GPUs and source builds.

Pushing a v* tag that matches the package version publishes to TestPyPI and PyPI; a manual release workflow run is a TestPyPI rehearsal with a unique .devN version. The CUDA wheels of a release are built on a large Linux host with ci/local_cuda_wheels.sh (a manual run of the CUDA wheel workflow builds them where there is none), and ci/attach_cuda_wheels.sh tests them on a GPU and attaches them to the GitHub Release.

Try it

Run this with .venv/bin/python; it needs no task files:

import mymyr
from mymyr import rl, search

domain = mymyr.Domain.from_string("""
(define (domain switch)
  (:requirements :strips)
  (:predicates (ready) (done))
  (:action finish
    :parameters ()
    :precondition (ready)
    :effect (and (not (ready)) (done))))
""")
problem = domain.instantiate_string("""
(define (problem example) (:domain switch)
  (:init (ready))
  (:goal (done)))
""")
task = mymyr.Task(problem)
result = search.astar(task, heuristic="max")
assert result.solved and len(result.plan) == 1 and result.cost == 1
print(search.format_plan(task, result.plan))

pool = rl.CpuEnvPool(task, num_envs=4, seed=0)
pool.reset()
batch = pool.step()
assert batch.terminated.all()
print(batch.states.shape, batch.reward, batch.terminated)

For your own task files, use mymyr.Task.from_pddl("domain.pddl", "problem.pddl").

Build from source

Source builds need CPython 3.14 or newer, a C++26 compiler, CMake 3.25 or newer and Ninja. The commands below run from a source checkout on Linux x86_64 with uv, Git, curl and sha256sum on PATH. The toolchain script downloads GCC 16.1 from conda-forge using micromamba and builds the pinned dependencies (loki, Abseil, fmt, Boost headers and googletest for the C++ tests) under build/toolchain; no system compiler installation is needed.

uv venv .venv --python 3.14t
uv pip install --python .venv/bin/python "cmake>=3.25" ninja
export PATH="$PWD/.venv/bin:$PATH"
export CMAKE_BUILD_PARALLEL_LEVEL=8
bash ci/wheel_toolchain.sh "$PWD/build/toolchain"
export CC="$PWD/build/toolchain/gcc/bin/x86_64-conda-linux-gnu-gcc"
export CXX="$PWD/build/toolchain/gcc/bin/x86_64-conda-linux-gnu-g++"
export CMAKE_ARGS="-DMYMYR_DEPS_PREFIX=$PWD/build/toolchain/deps"
uv pip install --python .venv/bin/python -e ".[test]"
.venv/bin/python -m pytest -W error tests/python

An existing GCC 16 build also works: set CC and CXX to its gcc and g++, build the dependencies with that compiler, and set MYMYR_DEPS_PREFIX through CMAKE_ARGS to their install prefix. -DMYMYR_FRONTEND=OFF skips the parser and its dependencies. On macOS use a C++26-capable Apple Clang/libc++ toolchain; see the C++ package guide for native builds and SDK consumers.

For CUDA, follow the existing-GCC route above with a system or source-built GCC 16 and dependencies built with that compiler. CI uses a system GCC 16 as nvcc's host compiler. With CC and CXX selecting that compiler and CMAKE_ARGS pointing to its dependency prefix, put CUDA 13.4 or newer's nvcc on PATH, then rebuild with CMake 4.4 or newer:

uv pip install --python .venv/bin/python "cmake>=4.4"
CMAKE_ARGS="$CMAKE_ARGS -DMYMYR_CUDA=ON -DCMAKE_CUDA_COMPILER=$(command -v nvcc) -DCMAKE_CUDA_HOST_COMPILER=$CXX" \
  uv pip install --python .venv/bin/python --reinstall-package mymyr -e ".[test]"

The default CUDA architecture is the visible GPU. NVIDIA drivers 580 or newer can run matching SASS; PTX needs a driver that understands the toolkit's PTX version. See CUDA for architecture selection and backend limits. Reference-comparison tests need the separate data described in tests/parity/README.md.

Documentation

Start with the user guides, API conventions and runnable examples. See parsing and task options, search, RL and Gymnasium, relational encodings, the CLI, the C API and the C++ SDK.

License

mymyr is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version (SPDX: GPL-3.0-or-later; the full text is in LICENSE). These are the terms of mimir (Copyright (C) 2023 Dominik Drexler and Simon Stahlberg), from which mymyr is derived.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Metadata

Release files for mymyr 0.2.1

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

Source distribution (sdist)

Source distribution for mymyr 0.2.1
File Size Uploaded Provenance Actions
mymyr-0.2.1.tar.gz 5.0 MB With provenance Details for mymyr-0.2.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mymyr 0.2.1
File Actions
mymyr-0.2.1-cp315-cp315t-manylinux_2_34_x86_64.whl CPython 3.15 CPython 3.15 free-threading Linux glibc 2.34+ x86-64 Details for mymyr-0.2.1-cp315-cp315t-manylinux_2_34_x86_64.whl
mymyr-0.2.1-cp315-cp315t-macosx_15_0_arm64.whl CPython 3.15 CPython 3.15 free-threading macOS 15.0+ ARM64 Details for mymyr-0.2.1-cp315-cp315t-macosx_15_0_arm64.whl
mymyr-0.2.1-cp315-cp315-manylinux_2_34_x86_64.whl CPython 3.15 CPython 3.15 Linux glibc 2.34+ x86-64 Details for mymyr-0.2.1-cp315-cp315-manylinux_2_34_x86_64.whl
mymyr-0.2.1-cp315-cp315-macosx_15_0_arm64.whl CPython 3.15 CPython 3.15 macOS 15.0+ ARM64 Details for mymyr-0.2.1-cp315-cp315-macosx_15_0_arm64.whl
mymyr-0.2.1-cp314-cp314t-manylinux_2_34_x86_64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.34+ x86-64 Details for mymyr-0.2.1-cp314-cp314t-manylinux_2_34_x86_64.whl
mymyr-0.2.1-cp314-cp314t-macosx_15_0_arm64.whl CPython 3.14 CPython 3.14 free-threading macOS 15.0+ ARM64 Details for mymyr-0.2.1-cp314-cp314t-macosx_15_0_arm64.whl
mymyr-0.2.1-cp314-cp314-manylinux_2_34_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.34+ x86-64 Details for mymyr-0.2.1-cp314-cp314-manylinux_2_34_x86_64.whl
mymyr-0.2.1-cp314-cp314-macosx_15_0_arm64.whl CPython 3.14 CPython 3.14 macOS 15.0+ ARM64 Details for mymyr-0.2.1-cp314-cp314-macosx_15_0_arm64.whl

Total release size: 105.8 MB

Release files / mymyr-0.2.1.tar.gz

Download URL mymyr-0.2.1.tar.gz
Size 5.0 MB
Tags Source
SHA-256 checksum
How to use checksums
b0cdbbb178c56844be195d7253b382fc9d6b0909f8d4a61806948175d4da2267
BLAKE2b-256 checksum
How to use checksums
6576fe1d910ed58425ad030b4e30bbe87af8ed39d54097c43c690ea83792729a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp315-cp315t-manylinux_2_34_x86_64.whl

Download URL mymyr-0.2.1-cp315-cp315t-manylinux_2_34_x86_64.whl
Size 14.7 MB
Tags CPython 3.15 CPython 3.15 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
12025805f1575f4e3c6be61505944461e20fab6237fb7d8ab467d721686b1392
BLAKE2b-256 checksum
How to use checksums
2a8b978fc32a60e6873c4ac4e5b372794116fe9b84e88cade07d2a722beca2a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp315-cp315t-macosx_15_0_arm64.whl

Download URL mymyr-0.2.1-cp315-cp315t-macosx_15_0_arm64.whl
Size 10.6 MB
Tags CPython 3.15 CPython 3.15 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
3357ac81e943b4fb144d058e75190160e69265285fc68f75a1a4de424ffe573c
BLAKE2b-256 checksum
How to use checksums
33b118a6562e78ab601f7031a5f44970db796d15b08de7a56897971bee58e643
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp315-cp315-manylinux_2_34_x86_64.whl

Download URL mymyr-0.2.1-cp315-cp315-manylinux_2_34_x86_64.whl
Size 14.7 MB
Tags CPython 3.15 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
5cdb2c2a9ccb29113dcc368372ca9ac42680cbb3d446d9a4630e177612812cb4
BLAKE2b-256 checksum
How to use checksums
53af2de2bb29ebf9d118931ebb005986ab2453e3a73c5b668ada127580699f1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp315-cp315-macosx_15_0_arm64.whl

Download URL mymyr-0.2.1-cp315-cp315-macosx_15_0_arm64.whl
Size 10.5 MB
Tags CPython 3.15 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
7f8a98dc9560e441d32a48d35522ce1119d2e17cacd5b1e12a2da20c98283d18
BLAKE2b-256 checksum
How to use checksums
3d773ed00e60fa59efe022a51b869c1647516153b64cdac98add0e1b46712856
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp314-cp314t-manylinux_2_34_x86_64.whl

Download URL mymyr-0.2.1-cp314-cp314t-manylinux_2_34_x86_64.whl
Size 14.7 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
68a610eb6baf5c0b2671921890071474e17c93812cbcc6223aa293b89c83f126
BLAKE2b-256 checksum
How to use checksums
80f491508dac7dce13e446a243d3f0ca98c6d03b89d6d557d1fd9394bb6ce272
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp314-cp314t-macosx_15_0_arm64.whl

Download URL mymyr-0.2.1-cp314-cp314t-macosx_15_0_arm64.whl
Size 10.6 MB
Tags CPython 3.14 CPython 3.14 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
0df4b1d565350837e88af71cbf0929a8fe6ee722f3a92f8353c1d7e7efc10955
BLAKE2b-256 checksum
How to use checksums
2b08c95cc961bf09a8b06c6b4958b92c74d1fc97c4bb3a5bf4db1ea9d5501104
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp314-cp314-manylinux_2_34_x86_64.whl

Download URL mymyr-0.2.1-cp314-cp314-manylinux_2_34_x86_64.whl
Size 14.7 MB
Tags CPython 3.14 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
574b4e0d3fe27e674bd9a35fae47c9c47f51f9a4b17b8515f3128e80b22c0169
BLAKE2b-256 checksum
How to use checksums
1266ad40a2e4326d2c251ee55abb4e42f5e2aa0f5dfbba04bc3192c50cdf46cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Release files / mymyr-0.2.1-cp314-cp314-macosx_15_0_arm64.whl

Download URL mymyr-0.2.1-cp314-cp314-macosx_15_0_arm64.whl
Size 10.5 MB
Tags CPython 3.14 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
f017d48534d6d625f758845b07417e9aa4e87a03908fc3aa602a4ccbf6671667
BLAKE2b-256 checksum
How to use checksums
9a5de9d4634b10d7bfb9869445595704fe217ebb85b792a415b449e5a711b006
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 1, 2026.

Transparency log

Security for mymyr 0.2.1

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

Select from 9 files

Attestation for mymyr-0.2.1.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 1, 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