README.md

---
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:

```text
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

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

Open:

```text
http://127.0.0.1:7860
```

## Local Python Run

```bash
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.