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. CUDA requires a source build.

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.

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.1.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 mymyr 0.1.0
File Size Uploaded Provenance Actions
mymyr-0.1.0.tar.gz 4.4 MB With provenance Details for mymyr-0.1.0.tar.gz

Built distributions (wheels)

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

Total release size: 96.0 MB

Release files / mymyr-0.1.0.tar.gz

Download URL mymyr-0.1.0.tar.gz
Size 4.4 MB
Tags Source
SHA-256 checksum
How to use checksums
237f99c0246181d140dd9539cb1b7ef662e21b69f29064eeba37888d3716bf4d
BLAKE2b-256 checksum
How to use checksums
ec4510022734b7930ee70c54f9c4cd956f9c9a2c915758401d255d6ccd32b79e
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp315-cp315t-manylinux_2_34_x86_64.whl
Size 13.4 MB
Tags CPython 3.15 CPython 3.15 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
c3edb69b4fb9bfe02848c94dc08f1941e8be37213150515efb29724259e40065
BLAKE2b-256 checksum
How to use checksums
218d721627be943a871afd5c1a69b4980732c2178910b344c270d5b50137ec50
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp315-cp315t-macosx_15_0_arm64.whl
Size 9.5 MB
Tags CPython 3.15 CPython 3.15 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
51cd4e5448cbebe0dd5bca7e2b58771f029ac7d2921508ad29f18eb1066b9abe
BLAKE2b-256 checksum
How to use checksums
5ad23f68e6255cd0640013420941fbfbabd718b2520016f173edd7d947485eba
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp315-cp315-manylinux_2_34_x86_64.whl
Size 13.4 MB
Tags CPython 3.15 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
8a422a12a3cbf63712ca3e56ea9f903c530c8a239a6689b9fa0c1b2fc13cf65f
BLAKE2b-256 checksum
How to use checksums
0104947bda8df9e25c18491f881ce63c03e17f047ad81002b9053f421f0dc459
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp315-cp315-macosx_15_0_arm64.whl
Size 9.5 MB
Tags CPython 3.15 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
c64162245598fffce8d6a4136f47ae9f4cf1515fd94f4afeb7753193c12c9cc2
BLAKE2b-256 checksum
How to use checksums
1c2c138e0e84d3dcf5eef49371dd16cee2770fe6be84587291d6576040d5f540
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp314-cp314t-manylinux_2_34_x86_64.whl
Size 13.4 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
13f3a0a25f3d2dad6990cbd4ec0eab20f88c7f3064f749bdf39f133606f74e4d
BLAKE2b-256 checksum
How to use checksums
ece81919e515042d7f539dc9bd949c54f0878a00e7ddcccc89502c422627c701
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp314-cp314t-macosx_15_0_arm64.whl
Size 9.5 MB
Tags CPython 3.14 CPython 3.14 free-threading macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
bde33f8aef5cd7436660e55496f72e25e37bfbf3944294add3521323cc9624a7
BLAKE2b-256 checksum
How to use checksums
7ff1575baf833e6d96dedca16c50310a909fedd4a25a3dfe065c8eb174915c95
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp314-cp314-manylinux_2_34_x86_64.whl
Size 13.4 MB
Tags CPython 3.14 Linux glibc 2.34+ x86-64
SHA-256 checksum
How to use checksums
17f9ee74ffad0de1813e382ba1d1d7424432cae5cf30b64e2a63b8020dd97cdb
BLAKE2b-256 checksum
How to use checksums
99034f62a6c7b61d2730fe579f08d3e8409ef8f2e05daa230db9f6bb60203c68
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 Oct 25, 2026.

Transparency log

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

Download URL mymyr-0.1.0-cp314-cp314-macosx_15_0_arm64.whl
Size 9.5 MB
Tags CPython 3.14 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
ecf89e8885feb71c379dc7452e2f383d83f3f59d2de2b3e299f75b57b86f0068
BLAKE2b-256 checksum
How to use checksums
eb08a50d76435c7792820302c3e6885c51f9176085bcd5a2d9c109ffe356e097
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 Oct 25, 2026.

Transparency log

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

Select from 9 files

Attestation for mymyr-0.1.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 Oct 25, 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