FlowRL: A Taxonomy and Modular Framework for Reinforcement Learning with Diffusion Policies
Organizations: Georgia Institute of Technology
Abstract
Thanks to their remarkable flexibility, diffusion models and flow models have emerged as promising candidates for policy representation. However, efficient reinforcement learning (RL) upon these policies remains a challenge due to the lack of explicit log-probabilities for vanilla policy gradient estimators. While numerous attempts have been proposed to address this, the field lacks a unified perspective to reconcile these seemingly disparate methods, thus hampering ongoing development. In this paper, we bridge this gap by introducing a comprehensive taxonomy for RL algorithms with diffusion/flow policies. To support reproducibility and agile prototyping, we introduce a modular, JAX-based open-source codebase that leverages JIT-compilation for high-throughput training. Finally, we provide systematic and standardized benchmarks across Gym-Locomotion, DeepMind Control Suite, and IsaacLab, offering a rigorous side-by-side comparison of diffusion-based methods and guidance for practitioners to choose proper algorithms based on the application. Our work establishes a clear foundation for understanding and algorithm design, a high-efficiency toolkit for future research in the field, and an algorithmic guideline for practitioners in generative models and robotics. Our code is available at https://github.com/typoverflow/flow-rl.
Figures & tables
| Guidance Method | Reference Policy | Algorithm Name |
| BoN Sampling | IDQL ( Hansen-Estruch et al., 2023 ) , SfBC ( Chen et al., 2022 ) | |
| Q-value Guidance | QSM ( Psenka et al., 2024 ) , iDEM ( Akhound-Sadegh et al., 2024 ) , DPS ( Jain et al., 2024 ) | |
| DAC ( Fang et al., 2024 ) , QGPO ( Lu et al., 2023 ) , Diffusion-DICE ( Mao et al., 2024 ) | ||
| Weighted Matching | SDAC ( Ma et al., 2025 ) , MaxEntDP ( Dong et al., 2025 ) , QVPO ( Ding et al., 2024 ) | |
| DPMD ( Ma et al., 2025 ) , FPMD ( Chen et al., 2025 ) , GeMPO ( Ma et al., 2026 ) | ||
| QIPO ( Zhang et al., 2024 ) |
| Dataset | IQL | IDQL † | QGPO † | QIPO † | Diffusion-QL | DAC | BDPO |
| halfcheetah-m | 47.4 | 51.0 | 54.1 | 54.2 ±1.3 | 50.7 ±0.7 | 59.1 ±0.6 | 71.2 ±0.9 |
| hopper-m | 66.3 | 65.4 | 98.0 | 94.0 ±13.3 | 80.4 ±15.7 | 103.5 ±0.3 | 100.6 ±0.7 |
| walker2d-m | 78.3 | 82.5 | 86.0 | 87.6 ±1.5 | 86.7 ±1.6 | 97.9 ±0.9 | 93.4 ±0.5 |
| halfcheetah-m-r | 44.2 | 45.9 | 47.6 | 48.0 ±0.8 | 47.4 ±0.6 | 55.4 ±0.5 | 58.9 ±0.9 |
| hopper-m-r | 94.7 | 92.1 | 96.9 | 101.3 ±2.2 | 101.0 ±0.3 | 103.1 ±0.1 | 101.4 ±0.5 |
| walker2d-m-r | 73.9 | 85.1 | 84.4 | 75.6 ±25.1 | 95.7 ±1.4 | 98.4 ±0.5 | 95.5 ±1.6 |
| Algorithm | Training (gradient steps/s) | Inference (actions/s) |
| SAC | 1242.3 | 2623.0 |
| QSM | 675.9 | 1285.6 |
| DACER | 603.3 | 728.3 |
| SDAC | 256.3 | 1219.6 |
| DPMD | 126.2 | 1313.3 |
| QVPO | 150.6 | 1397.4 |
| Setting | Gym-Locomotion | DMC | IsaacLab |
| Training frames | 1M | 1M | 200M |
| Batch size | 256 | 512 | 24576 |
| Replay buffer size | — | ||
| Discount | 0.99 | 0.99 | 0.99 |
| Warmup frames | 5K | 10K | — |
| Random frames | 5K | 10K | — |
| Environment | Max Return |
| Ant-v5 | 6000 |
| HalfCheetah-v5 | 11000 |
| Hopper-v5 | 4000 |
| Humanoid-v5 | 6000 |
| Swimmer-v5 | 150 |
| Walker2d-v5 | 6000 |