pydgens 0.6.1

Python/JAX-based numerical solvers for dynamic/differential game equilibria

PYDGENS: Python/JAX Differential Game Equilibria Numerical Solvers

PYDGENS provides numerical solvers for approximating equilibrium solutions in multi-player, general-sum dynamic and differential games. The package currently focuses on linear-quadratic feedback Nash games, iterative linear-quadratic methods for nonlinear games, and augmented-Lagrangian workflows for constrained games.

PYDGENS is a pre-1.0 release. The package is ready for early adopters, but the public API may continue to evolve as the modeling frontend, examples, and solver interfaces mature.

Installation

pip install pydgens

PYDGENS requires Python 3.12 or newer.

Solvers

PYDGENS currently supports three main solver paths:

• LQ: linear-quadratic, unconstrained games solved for feedback Nash strategies
• iLQ: nonlinear, unconstrained games solved for local feedback Nash strategies
• AL: constrained nonlinear games solved with an augmented-Lagrangian workflow for local open-loop trajectories

Examples

Run a minimal linear-quadratic tug-of-war game solved with the LQ solver:

python src/pydgens/examples/tug_o_war.py

Run a nonlinear two-player unicycle game solved with the iterative LQ solver:

python src/pydgens/examples/unicycle.py

Run a constrained two-player integrator game solved with the augmented-Lagrangian solver:

python src/pydgens/examples/constrained_integrators.py

More examples live in src/pydgens/examples/.

Documentation

Documentation is available at https://mit-ll.github.io/pydgens/.

Development

For development from a local clone:

pip install -e .[full]

Contributors can also use uv for a reproducible environment:

uv sync --extra dev
source .venv/bin/activate

Testing

Quick tests:

pytest tests/ -v -s -m "not slow"

Slow and benchmark-oriented tests:

pytest tests/ -v -m "slow" --benchmark-columns='mean, min, max, stddev, rounds'

Disclaimer

DISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.

This material is based upon work supported by the Under Secretary of War for Research and Engineering under Air Force Contract No. FA8702-15-D-0001 or FA8702-25-D-B002. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the Under Secretary of War for Research and Engineering.

© 2026 Massachusetts Institute of Technology.

Subject to FAR52.227-11 Patent Rights - Ownership by the contractor (May 2014)

SPDX-License-Identifier: MIT

The software/firmware is provided to you on an As-Is basis.

Delivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part 252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government rights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed above. Use of this work other than as specifically authorized by the U.S. Government may violate any copyrights that exist in this work.