Repository navigation
HPC-DS1 v1.0.0
HPC-DS1 is a confidence-aware decision model that tunes compute jobs (ranks, threads, CPU or GPU, fp32 or bf16) on the machine it runs on, trained only on real measurements.
Models
- System 2, the step model: picks the next change for a measured job, one move at a time, with calibrated confidence (0.59M parameters, size chosen on validation; corrected from "2.85M"). On held-out problem sizes: a best move 94.1% of the time (rules of thumb 70.3%), 96.3% of the best configuration's speed in 2.9 real runs, 0% moves that made a job slower or crashed, calibration error 0.106.
- System 1, instant configuration: an 8-network ensemble performance model that picks the whole configuration from the job description alone, in about 10 ms. 83% of picks within 5% of the best, 96.9% of best speed, no crashing picks (cross-validated over 72 problems).
- Dual process: System 1 picks, the job runs once, and System 2 checks only when needed; 98.7% of best speed in 1.0 real run on held-out sizes (System 2 alone: 99.1% in 5.1 runs).
- Familiarity guard: escalates jobs, sizes and machines unlike the training data; on never-seen workloads 240 confidently wrong automatic moves became 0, with no familiar decisions flagged.
- Question encoder: a fine-tuned ModernBERT-base answers free-text questions about a job, Jev-style (yes/no/unclear or a choice), reading System 1's estimates; 87% on unseen wording and problem sizes. Weights are a release asset.
Data
- 3,168 real timed runs over 72 problems: 8 workloads (6 HPC kernels, a neural-network training step, a backend request batch) × 9 sizes × 44 configurations, on one laptop (Intel i5, RTX 4050 Laptop GPU). Every result is checked against an fp32 reference.
Tools
hpc-ds1CLI:setup,serve,predict,plan,decide,tune,learn,agent,submit,tasks,info.- Facility console: playground (typed and free-text questions), tuning sessions, approval queue, audit log, fleet, machine, evaluation, and a layer explorer.
- Fleet: machines join over HTTP (agents poll, no inbound ports); each task goes to the machine with the earliest expected finish, and that machine's own model tunes it.
- Bring your own task:
@registera workload in~/.hpc_ds1/plugins/; level 5 logs every live run andhpc-ds1 learnretrains System 1 on them.
Known limitations
- Trained on one laptop; on other hardware run
hpc-ds1 setupfirst (not yet tested end to end on other hardware). - No HTTPS or console login: use a trusted network or an overlay such as Tailscale.
- The fleet runs whole tasks per machine; it does not split one job across machines (no MPI yet).
- System 1's confidence barely separates good picks from bad (AUROC about 0.55); System 2's check covers it.
- The question encoder can be confidently wrong on "will this one change make it faster?".
Install
git clone https://github.com/Tarunkumar060106/hpc-ds1.git
cd hpc-ds1
pip install -e ".[test,encoder]"
hpc-ds1 serve # console at http://127.0.0.1:8765For free-text questions, download hpc-ds1-encoder-v1.0.0.zip below and unzip it in the repository folder (it creates models/encoder/).
The encoder weights are fine-tuned from answerdotai/ModernBERT-base (Apache-2.0). HPC-DS1 itself is MIT-licensed.