README.md

metadata

title: BigMac PP Simulator
sdk: docker
app_port: 7860
pinned: false

BigMac PP Simulator

This Hugging Face Space packages the BigMac pipeline-parallel schedule simulator as a standalone Docker app.

The Space contains sibling checkouts:

pp-scheduler/    Schedule generation logic
pp-simulator/    Simulation library and web UI

The web UI serves:

• single-scheduler simulation
• fair scheduler comparison
• SVG timeline visualization
• Chrome Trace and Perfetto trace export
• configuration error feedback through modal dialogs

Local Docker Run

docker build -t bigmac-pp-simulator .
docker run --rm -p 7860:7860 bigmac-pp-simulator

Open:

http://127.0.0.1:7860

Local Python Run

cd pp-simulator
python web/app.py --host 0.0.0.0 --port 7860

Notes

Hugging Face Docker Spaces route traffic to the configured app port. The container therefore starts the existing pp-simulator web server on 0.0.0.0:7860.

The Space sets PP_SIMULATOR_MAX_MICROBATCHES=64 to keep simulations within the available Hugging Face compute budget. Local deployments can raise or unset this environment variable.