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.2

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.2
File Size Uploaded Provenance Actions
mymyr-0.2.2.tar.gz 5.2 MB With provenance Details for mymyr-0.2.2.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mymyr 0.2.2
File Actions
mymyr-0.2.2-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.2-cp315-cp315t-manylinux_2_34_x86_64.whl
mymyr-0.2.2-cp315-cp315t-macosx_15_0_arm64.whl CPython 3.15 CPython 3.15 free-threading macOS 15.0+ ARM64 Details for mymyr-0.2.2-cp315-cp315t-macosx_15_0_arm64.whl
mymyr-0.2.2-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.2-cp315-cp315-manylinux_2_34_x86_64.whl
mymyr-0.2.2-cp315-cp315-macosx_15_0_arm64.whl CPython 3.15 CPython 3.15 macOS 15.0+ ARM64 Details for mymyr-0.2.2-cp315-cp315-macosx_15_0_arm64.whl
mymyr-0.2.2-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.2-cp314-cp314t-manylinux_2_34_x86_64.whl
mymyr-0.2.2-cp314-cp314t-macosx_15_0_arm64.whl CPython 3.14 CPython 3.14 free-threading macOS 15.0+ ARM64 Details for mymyr-0.2.2-cp314-cp314t-macosx_15_0_arm64.whl
mymyr-0.2.2-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.2-cp314-cp314-manylinux_2_34_x86_64.whl
mymyr-0.2.2-cp314-cp314-macosx_15_0_arm64.whl CPython 3.14 CPython 3.14 macOS 15.0+ ARM64 Details for mymyr-0.2.2-cp314-cp314-macosx_15_0_arm64.whl

Total release size: 109.6 MB

Release files / mymyr-0.2.2.tar.gz

Download URL mymyr-0.2.2.tar.gz
Size 5.2 MB
Tags Source
SHA-256 checksum
How to use checksums
7c5d9b49c394f1cd2ed05c2d5698e87848b57982c6da327aba15ae826ca3caee
BLAKE2b-256 checksum
How to use checksums
e6d9548d8a6e27e5b849a5df0992f1529129d64593da3a670ca00c716c11c8f6
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp315-cp315t-manylinux_2_34_x86_64.whl
Size 15.2 MB
Tags CPython 3.15 CPython 3.15 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
8750ad409ffe94643a2cbfbdc8cf6e24c835497243db250d180c0c27bde10a8f
BLAKE2b-256 checksum
How to use checksums
ee852867137576e36a43496da4e9f632e9bec6af94583be9f13c2fd66e6c6afd
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp315-cp315t-macosx_15_0_arm64.whl
Size 10.9 MB
Tags CPython 3.15 CPython 3.15 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
2abe47ce1094c7f57dca37e05de1a3c215ca0ebb2debbce84522d70bd980e59d
BLAKE2b-256 checksum
How to use checksums
c50df72da4764dc1f30c200c76d5bc070f0d21bbf289aa7d88970ee0313b5073
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp315-cp315-manylinux_2_34_x86_64.whl
Size 15.2 MB
Tags CPython 3.15 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
8662af156bd379ce65845e3c5bfd4fcf26da2d3d65b7e3737646f9059114e69d
BLAKE2b-256 checksum
How to use checksums
eced4e0f13958435d390bff9f37538db5a6107e8a606f21af6f716578fcc8b53
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp315-cp315-macosx_15_0_arm64.whl
Size 10.9 MB
Tags CPython 3.15 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
fb6e987c3240cc8a7b32e02eee778b6832cdcda1c2f683bbc104e198534cdb8c
BLAKE2b-256 checksum
How to use checksums
52df43cef2acd7cab8238ce3956637678435e3d278b002eca89b13765e25670b
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp314-cp314t-manylinux_2_34_x86_64.whl
Size 15.2 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
a311f472a2b8f30a4e5b581642686dd450ec66259125384d6649c58a65063e11
BLAKE2b-256 checksum
How to use checksums
ca83657b0956565092140d92d259024ec7487e9ddb96e06f019379b9753fbe69
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp314-cp314t-macosx_15_0_arm64.whl
Size 10.9 MB
Tags CPython 3.14 CPython 3.14 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
29d2060774b6b616239ce572dbc94a3e37c8168db15511c33d3ba88222403970
BLAKE2b-256 checksum
How to use checksums
28ee11e80cf879abab42ec2e5443d360b61ae3c6f4c84473fa08aec6a5e3f056
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp314-cp314-manylinux_2_34_x86_64.whl
Size 15.2 MB
Tags CPython 3.14 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
27aaccf2921bf195a9701da74d1295126c4b514ed707939047845d4a74046801
BLAKE2b-256 checksum
How to use checksums
c3534c8877101a2a9c22ba400adc2e7df1d215fe565b1fc9ab15e5853b5b8b9c
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 6, 2026.

Transparency log

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

Download URL mymyr-0.2.2-cp314-cp314-macosx_15_0_arm64.whl
Size 10.9 MB
Tags CPython 3.14 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
6e630527116c4a6c47c037f21ea055ec4c7ca0b9e0495ada15e85ae85d870f14
BLAKE2b-256 checksum
How to use checksums
f4d2046ea246eb16547d29e9d5b5500267b43309446a788bf24a081747ac3d9b
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 6, 2026.

Transparency log

Security for mymyr 0.2.2

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.2.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