MARGoS: A Configuration-Driven Platform for Reproducible MARL Experiments in ARGoS
Authors: Tom Philipp Backert, Mohammad D. Soorati, Javad Ghofrani
Organizations: University of Lübeck, Lübeck, Germany · University of Southampton, Southampton, UK · Bonn-Rhein-Sieg University of Applied Sciences, Sankt Augustin, Germany
Multi-agent reinforcement learning (MARL) has become a prominent research direction, particularly within collective robotics, where the ARGoS simulator is widely used to study emergent swarm behavior. Yet despite this growth, systematic support for reuse and reproducibility in MARL-based swarm robotics remains limited and insufficiently standardized: a single experiment is assembled from manually aligned simulator files, training scripts, configuration values, paths, seeds, and environment details, so reuse and reproduction stay fragile even within one research group. To address this gap, we introduce MARGoS, a lightweight, configuration-driven platform developed in this project that elevates these experiment-defining inputs to first-class, platform-managed artifacts. MARGoS enables reproducible experimentation through configuration hashing, end-to-end seed propagation, frozen (immutable) configurations, structured logging, environment fingerprinting, and exportable experiment bundles that facilitate sharing, replay, and verification of results across machines and over time. A five-dimension evaluation (architecture, efficiency, reproducibility, usability, and collaboration) supports our claim that managing experiment variation as a platform responsibility makes ARGoS+MARL experiments easier to reuse, reproduce, and hand off. Our code is available at https://github.com/tombackert/margos.
Figures & tables
Dimension
Question
Evidence used in this paper
RQ1 Architecture (enablement)
Can the platform execute the evaluation protocols?
Protocol enablement across RQ2-RQ5
RQ2 Efficiency
Does integration reduce repeated workflow effort?
Time and step reduction vs manual workflow
RQ3 Reproducibility
Can identical experiments be rerun reliably on the same hardware?
Reference run plus 20 automated reproductions
RQ4 Usability
Does the design reduce interaction complexity?
Heuristic audit and KLM analysis
RQ5 Collaboration
Can experiment bundles be handed off reliably to a prepared collaborator?
Export/import handoff trials
Table 1: Project goals and evaluation dimensions. Each dimension maps to a guiding question and to the evidence used to answer it in this paper; RQ1 is enablement-validated through protocol execution, RQ2-RQ5 are threshold-tested.
Figure 1: MARGoS architecture. Control flow runs top-down from the five-command CLI through the five-stage pipeline (configuration → orchestration → logging → analysis → export/import); managed-artifact flow runs from each stage into the bottom row (frozen configs, runs and seeds, structured logs, reports, exportable bundles with environment fingerprints). The run command intentionally fans out because it spans configuration, orchestration, and logging rather than naming one stage. The ArgosToZoo bridge couples the orchestration stage to ARGoS via ZeroMQ.
Table 2: Executed evaluation design: primary metrics, sample sizes, and predefined practical targets across the four empirically tested dimensions. RQ1 Architecture is omitted because it is validated by protocol enablement: the platform must execute the RQ2-RQ5 protocols end-to-end rather than pass a separate threshold test.
Dimension
Metric result
Threshold
Judgment
RQ2 Efficiency
Time -78.2%; steps -66.7%
≥ 50% reduction
Supported
RQ3 Reproducibility
100% success (20/20); 0.0000 SD
≥ 90% success
Strongly supported
RQ4 Usability
85.7% heuristic compliance; 56.9% KLM reduction
≥ 80%; ≥ 50%
Supported
RQ5 Collaboration
100% handoff success; share time -65.3%; reproduce time -45.9%; first run +7.4% slower
≥ 50% reductions; ≥ 90% success
Partially supported
Table 3: Measured outcomes across the four empirically tested dimensions. RQ2-RQ4 meet their predefined practical targets, while RQ5 is partially supported; jointly the four rows are the evidence bundle that platform-owned managed variation translates into measurable workflow effort reduction, deterministic self-reproducibility, analytical usability gains, and verified handoff at a first-run overhead.
Figure 2: Cross-dimension effort reductions on the executed project evaluation: every metric is plotted against the manual baseline at 0%, and the predefined ≥ 50% target appears as a dashed line. The chart is a visual comparison, not pooled inference: it juxtaposes workflow-effort gains on the RQ2 reference task, analytical KLM reductions on the RQ4 task set, and sharing-phase gains on RQ5, while showing the RQ5 reproduce-time metric narrowly below the 50% target.
Figure 3: Collaboration tradeoff (RQ5): the four timing metrics relative to the manual baseline at 0%. Large sharing-phase gains and reliable handoff success are set against the first-run overhead introduced by bundle validation and import checks. The figure shows the RQ5 partial verdict as a single tradeoff in the evidence bundle rather than as a missed target in isolation.
A key challenge in multi-agent reinforcement learning (MARL) lies in designing learning signals that effectively promote coordination among agents. Designing such signals requires estimating how one agent's current action affects its teammates over future interaction steps. To address this, we introduce Multi-step Advantage-Gated Interventional Causal MARL (MAGIC), a framework that estimates multi-step action effects between agents and selectively converts them into intrinsic rewards. MAGIC uses counterfactual action interventions to compare teammate futures under factual and counterfactual branches, and introduces a gate based on advantage to direct exploration toward beneficial behaviors aligned with the task goal. Experiments on Multi-Agent Particle Environments (MPE) and StarCraft micromanagement benchmarks (SMAC and SMACv2) show that MAGIC consistently outperforms leading prior methods, with average relative final performance improvements of 26.9% and 10.1%, respectively.
Haohan Yu, Jinmiao Cong, Shengzhi Wang +2
1Dalian University of Technology · 2Microsoft, Beijing, China
We present GzDRL, a novel single-process reinforcement learning (RL) framework for Gazebo that overcomes longstanding bottlenecks in scalable, reproducible robotics experimentation. Unlike conventional middleware-based RL-Gazebo integrations that suffer from nondeterminism and irreproducibility, GzDRL introduces a systematic, middleware-free environment-stepping mechanism that directly synchronizes agent actions and physics updates. This design enables deterministic, high-throughput data collection, efficient vectorization, and reproducible RL training and evaluation. Comprehensive benchmarks demonstrate that GzDRL achieves the highest workstation throughput among the evaluated frameworks while remaining competitive with GPU-accelerated simulators on laptop hardware, and maintains precise agent-environment synchronization, multi-agent scalability, and experiment-level reproducibility. We further validate sim-to-real transfer by deploying learned policies directly onto a physical quadrotor, without fine-tuning. Our results establish GzDRL as an accessible and reproducible platform for advancing RL in robotics and automation.
Benchmarks are crucial in the development of machine learning algorithms, with available environments significantly influencing reinforcement learning (RL) research. Traditionally, RL environments run on the CPU, which limits their scalability with typical academic compute. However, recent advancements in JAX have enabled the wider use of hardware acceleration, enabling massively parallel RL training pipelines and environments. While this has been successfully applied to single-agent RL, it has not yet been widely adopted for multi-agent scenarios. In this paper, we present JaxMARL, the first open-source, Python-based library that combines GPU-enabled efficiency with support for a large number of commonly used MARL environments and popular baseline algorithms. Our experiments show that, in terms of wall clock time, our JAX-based training pipeline is around 14 times faster than existing approaches, and up to 12500x when multiple training runs are vectorized. This enables efficient and thorough evaluations, potentially alleviating the evaluation crisis in the field. We also introduce and benchmark SMAX, a JAX-based approximate reimplementation of the popular StarCraft Multi-Agent Challenge, which removes the need to run the StarCraft II game engine. This not only enables GPU acceleration, but also provides a more flexible MARL environment, unlocking the potential for self-play, meta-learning, and other future applications in MARL. The code is available at https://github.com/flairox/jaxmarl.
Alexander Rutherford, Benjamin Ellis, Matteo Gallici +18
University of Oxford · Universitat Politècnica de Catalunya · University College London +2