06. Infra & Local Ops¶

Setup¶

make setup          # uv sync
make help
make en-indic       # export → tokenizers → validate
make browser-lab    # http://127.0.0.1:8010

Needs ~8 GB disk for scratch; GPU recommended.

Typical Make families¶

Family	Examples
Export/validate	`en-indic`, `indic-en`, `indic-indic`, `*-1b`
Precision	`quantize-`, `convert-fp16-`, `quantize-q4f16-*`
Bench/report	`benchmark-*`, `reports`, `reports-1b`, `live-report`
Upload	`upload-*-{fp32,fp16,int8,q4f16}`, `upload-all`, `upload-1b-all`

Bulk helpers: scripts/upload_all_with_delete.sh, delete_stale_hf_sidecars.sh (cleanup after shared-sidecar migration).

CI¶

GitHub Actions deploys dashboard only. No automated export/parity CI.

Topology¶

graph TD
  classDef default fill:#1e293b,stroke:#38bdf8,stroke-width:2px,color:#f8fafc
  classDef highlight fill:#065f46,stroke:#34d399,stroke-width:2px,color:#f0fdf4

  Dev["Dev machine Make/uv"]:::highlight
  Scratch["scratch/"]
  HF["HF Hub"]
  Pages["Pages dashboard"]
  Lab["browser-lab"]

  Dev --> Scratch
  Dev --> HF
  Scratch --> Lab
  Pages --> Dev

  linkStyle default stroke:#64748b,stroke-width:2px