← all repositories
facebookresearch/BenchMARL

A Standardized Sparring Ring for MARL Algorithms

BenchMARL exists to stop multi-agent RL researchers from rewriting the same training boilerplate every time they want a fair algorithm comparison.

BenchMARL
Not currently ranked — collecting fresh signals.
star history

What it does

BenchMARL is a training and benchmarking library for multi-agent reinforcement learning. It wraps algorithms, tasks, and models behind a standardized interface so you can compare methods like MAPPO and MASAC across different environments without rebuilding training infrastructure for every test. It uses TorchRL as its backend and Hydra for configuration, and it reports results in a format compatible with the marl-eval standard.

The interesting bit

The library decouples experiments from algorithm, environment, and model choices, so swapping a PettingZoo task for a VMAS robot swarm does not require retouching the training logic. Each release ships with locked default configurations, making reproducibility a structural guarantee rather than a documentation suggestion.

Key highlights

  • Built on TorchRL, inheriting its performance and state-of-the-art RL primitives instead of reimplementing them from scratch.
  • Compatible with the marl-eval protocol for statistically rigorous plotting and reporting.
  • Supports both on-policy and off-policy methods, continuous and discrete actions, and probabilistic or deterministic policies through shared experiment hyperparameters.
  • Environments are optional dependencies; VMAS, PettingZoo, MeltingPot, MAgent2, and SMACv2 are supported but not forced on you at install.
  • Treats structured comparisons across algorithms and tasks as first-class objects called benchmarks, which share a single experiment configuration.

Verdict

Researchers who need to compare MARL algorithms fairly across multiple environments should look here; if you only need to train a single agent in a custom environment with no intention of systematic comparison, it is likely overkill.

Frequently asked

What is facebookresearch/BenchMARL?
BenchMARL exists to stop multi-agent RL researchers from rewriting the same training boilerplate every time they want a fair algorithm comparison.
Is BenchMARL open source?
Yes — facebookresearch/BenchMARL is open source, released under the MIT license.
What language is BenchMARL written in?
facebookresearch/BenchMARL is primarily written in Python.
How popular is BenchMARL?
facebookresearch/BenchMARL has 642 stars on GitHub.
Where can I find BenchMARL?
facebookresearch/BenchMARL is on GitHub at https://github.com/facebookresearch/BenchMARL.

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