Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CollectiveLab

CollectiveLab is an event-driven benchmark harness for studying how ring and tree allreduce behave under topology, message size, and congestion constraints.

Gap

Distributed training discussions often compare collective algorithms in the abstract, but infra teams need reproducible crossover points under specific topology and oversubscription assumptions.

Gap statement:

Existing distributed training benchmarks compare collectives at coarse aggregate throughput, but fail to expose when ring or tree collapses under topology asymmetry, oversubscription, and straggler-heavy traffic.

Target Alignment

  • xAI: collective efficiency under Ethernet/RDMA scaling pressure
  • NVIDIA: communication substrate benchmarking and topology sensitivity
  • Apple: rigorous performance modeling under tightly bounded systems assumptions

Quickstart

make setup
make bench
make test

Example

.venv/bin/collectivelab benchmark --topology traces/sample_topology.json --format json

Success Metrics

  • Finds ring vs tree crossover points by message size
  • Quantifies topology penalty under oversubscription
  • Emits deterministic JSON for repeatable comparison runs

About

Event-driven benchmark harness for ring and tree allreduce under topology, message size, and congestion constraints.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages