← all repositories
Farama-Foundation/MO-Gymnasium

Vector rewards for the chronically indecisive agent

It provides a standard API and shared environments for developing and comparing multi-objective RL algorithms, extending the familiar Gymnasium interface so rewards come back as numpy arrays instead of scalars.

772 stars Python ML Frameworks
MO-Gymnasium
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

MO-Gymnasium is a collection of multi-objective reinforcement learning environments built on top of the standard Gymnasium API. Instead of returning a single scalar reward, each env.step() yields a numpy array of rewards, letting an agent optimize for multiple—often conflicting—objectives at once. The library includes classic MORL problems as well as multi-objective versions of existing domains like MuJoco, all version-locked for reproducibility.

The interesting bit

The clever part isn’t the environments themselves, but the standardization: by keeping the exact same Gymnasium interface and only changing the reward shape, existing tools mostly just work, and the ecosystem gets a shared benchmark rather than a dozen incompatible custom loops. A LinearReward wrapper lets you collapse the vector back into a scalar if you want to pretend your agent only cares about one thing.

Key highlights

  • Extends the standard Gymnasium API; env.step() returns a vectorized numpy reward array instead of a float
  • Bundles classic MORL literature environments plus multi-objective variants of MuJoco and other classical domains
  • Includes reward wrappers like LinearReward for scalarization when you need a single objective
  • Strict environment versioning (e.g., -v0) bumped on any change that could affect learning results
  • Backed by the Farama Foundation and published at NeurIPS 2023

Caveats

  • The README notes that installing all environment families at once ([all]) can be problematic on some systems, so expect dependency friction depending on your OS
  • Beyond the API change and bundled envs, the library is intentionally narrow; you’ll likely want to pair it with something like MORL-Baselines for actual algorithms

Verdict

Worth a look if you’re researching or building multi-objective RL agents and need a common interface. Skip it if you’re happy with single-objective rewards and standard Gymnasium—this is a specialization, not an upgrade.

Frequently asked

What is Farama-Foundation/MO-Gymnasium?
It provides a standard API and shared environments for developing and comparing multi-objective RL algorithms, extending the familiar Gymnasium interface so rewards come back as numpy arrays instead of scalars.
Is MO-Gymnasium open source?
Yes — Farama-Foundation/MO-Gymnasium is open source, released under the MIT license.
What language is MO-Gymnasium written in?
Farama-Foundation/MO-Gymnasium is primarily written in Python.
How popular is MO-Gymnasium?
Farama-Foundation/MO-Gymnasium has 772 stars on GitHub.
Where can I find MO-Gymnasium?
Farama-Foundation/MO-Gymnasium is on GitHub at https://github.com/Farama-Foundation/MO-Gymnasium.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.