verl-project/verl

verl/HybridFlow: A Flexible and Efficient RL Post-Training Framework

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 17 minutes ago
Added to GitGenius on February 6th, 2025
Created on October 31st, 2024
Open Issues & Pull Requests: 1,152 (+0)
Number of forks: 4,444
Total Stargazers: 23,107 (+0)
Total Subscribers: 90 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 28.4 hours
Mean response time: 58.8 days
90th percentile: 291.0 days
Tracked items: 2,641

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 93% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "rollout" is answered fastest, typically in under an hour, while "bug" waits about 2 days. 32% of tracked open issues have had no activity in three months. Only 7% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 581
New in 7 days: 14
Closed in 7 days: 8
Avg open age: 202 days
Stale 30+ days: 445
Stale 90+ days: 137

Recent activity

Opened in 7 days: 14
Closed in 7 days: 8
Comments in 7 days: 12
Events in 7 days: 35

Top labels

  • bug (557)
  • Ascend (47)
  • call for contribution (29)
  • question (23)
  • enhancement (19)
  • good first issue (17)
  • RFC (15)
  • ray (15)

Detailed Description

VERL is a reinforcement learning training library for large language models initiated by ByteDance's Seed team and maintained by the verl community. The project represents the open-source implementation of the HybridFlow framework, which was published as a research paper at EuroSys. The library is designed to be flexible, efficient, and production-ready for post-training RL workflows on LLMs.

The core architecture centers on a hybrid-controller programming model that enables flexible representation and efficient execution of complex post-training dataflows. This design allows developers to construct RL algorithms such as GRPO and PPO with minimal code, reducing the barrier to entry for implementing diverse RL approaches. The framework decouples computation and data dependencies, which facilitates seamless integration with existing LLM infrastructure including FSDP, Megatron-LM, vLLM, and SGLang through modular APIs. This modularity means practitioners can leverage their existing investments in LLM frameworks rather than requiring wholesale adoption of new systems.

VERL addresses resource utilization through flexible device mapping capabilities that support various placements of models across different GPU sets. This flexibility enables efficient scaling across cluster sizes of different configurations. The library includes ready integration with popular HuggingFace models, lowering adoption friction for users already working within that ecosystem.

Performance optimization is a central design goal. VERL integrates state-of-the-art LLM training and inference engines and achieves state-of-the-art RL throughput. A key technical contribution is the 3D-HybridEngine, which performs efficient actor model resharding and eliminates memory redundancy while significantly reducing communication overhead during transitions between training and generation phases. These optimizations directly address bottlenecks common in RL training workflows.

This broad classification reflects the framework's positioning as a comprehensive solution spanning infrastructure concerns, distributed training coordination, and high-level algorithm implementation. The framework is documented at verl.readthedocs.io and maintains community channels including Slack and WeChat for user support and collaboration.