From 5ccf716a591b32b3cba6a2b86484f1978080e11e Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Tue, 16 Jun 2026 21:51:18 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=EF=BC=8C=E7=94=B1ModelHub=20XC=E7=A4=BE=E5=8C=BA=E6=8F=90?= =?UTF-8?q?=E4=BE=9B=E6=A8=A1=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Model: shazzadulimun/gemma3-270m-aurora-ml-v3-gguf Source: Original Platform --- .gitattributes | 36 +++++++++++++ README.md | 114 ++++++++++++++++++++++++++++++++++++++++++ gemma270m_C2-f16.gguf | 3 ++ 3 files changed, 153 insertions(+) create mode 100644 .gitattributes create mode 100644 README.md create mode 100644 gemma270m_C2-f16.gguf diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..6a3072e --- /dev/null +++ b/.gitattributes @@ -0,0 +1,36 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text +*.ftz filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.h5 filter=lfs diff=lfs merge=lfs -text +*.joblib filter=lfs diff=lfs merge=lfs -text +*.lfs.* filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.onnx filter=lfs diff=lfs merge=lfs -text +*.ot filter=lfs diff=lfs merge=lfs -text +*.parquet filter=lfs diff=lfs merge=lfs -text +*.pb filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +saved_model/**/* filter=lfs diff=lfs merge=lfs -text +*.tar.* filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.tflite filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text +gemma270m_C2-f16.gguf filter=lfs diff=lfs merge=lfs -text diff --git a/README.md b/README.md new file mode 100644 index 0000000..7a543b4 --- /dev/null +++ b/README.md @@ -0,0 +1,114 @@ +--- +library_name: gguf +license: apache-2.0 +language: [en] +base_model: unsloth/gemma-3-270m-it +pipeline_tag: text-generation +tags: + - aurora + - alcf + - hpc + - intel-gpu + - oneapi + - sycl +--- + +# Gemma-3-270M-Aurora-ML v3 + +LoRA fine-tune of [`unsloth/gemma-3-270m-it`](https://huggingface.co/unsloth/gemma-3-270m-it) specialized for the +[**ALCF Aurora supercomputer**](https://docs.alcf.anl.gov/aurora/) (Intel Xeon Sapphire +Rapids + Intel GPU Max 1550 / Ponte Vecchio, oneAPI / SYCL, PBS Pro). + +Off-the-shelf code-LLMs hallucinate Aurora specifics — they suggest `nvcc` instead of +`icpx -fsycl`, `srun` / `aprun` instead of `mpiexec`, NERSC's `/global/cfs` instead of +`/lus/flare`, and CUDA device strings instead of `xpu`. This adapter teaches the base +model the actual Aurora toolchain, file system layout, scheduler conventions, and +recommended PyTorch/TensorFlow/SYCL idioms. + +## Model summary + +| | | +|---|---| +| **Base model** | [`unsloth/gemma-3-270m-it`](https://huggingface.co/unsloth/gemma-3-270m-it) | +| **Format** | GGUF, f16 — single file, llama.cpp / Ollama / LM Studio compatible | +| **Fine-tuning** | LoRA (PEFT) — r=32, α=64, dropout 0.0, 2 epochs | +| **Optimizer** | AdamW fused, lr 2e-4 cosine, warmup 3%, batch 1 × grad-accum 8 | +| **Precision / seq-len** | bf16, 1,536 tokens | +| **Training data** | [`aurora-docs-distill-v2-datascience`](https://github.com/SIslamMun/Generator/tree/aurora-datasets-2026-04-30/datasets/aurora/iter2/data/training/C2) — 1,117 ChatML rows | +| **Train loss (final)** | 1.2462 | +| **Hardware** | 1 Aurora PVC tile (1/12 of a node, 64 GB HBM), IPEX + PyTorch 2.10 XPU backend | +| **Eval (53-Q Aurora, 0–5)** | pending | + +## Quick start + +**On Aurora** (PVC GPU, SYCL llama.cpp build) — interactive PBS session: +```bash +# 1. Grab a debug node +qsub -I -A -q debug -l select=1,walltime=01:00:00,filesystems=home:flare + +# 2. Load the toolchain +module load frameworks +source /lus/flare/projects//scripts/env.sh # or your own oneAPI setup +export ONEAPI_DEVICE_SELECTOR=level_zero:gpu + +# 3. Download to flare (NOT $HOME — quota is small) +hf download shazzadulimun/gemma3-270m-aurora-ml-v3-gguf --local-dir /lus/flare/projects//models/aurora-chat-v3 + +# 4. Run on a single PVC tile +/path/to/llama.cpp/build_sycl/bin/llama-cli \ + -m /lus/flare/projects//models/aurora-chat-v3/*.gguf \ + -ngl 999 -sm none --temp 0.0 -cnv \ + -p "How do I launch one MPI rank per GPU tile on Aurora?" +``` + +**Anywhere else** (laptop, workstation, any GPU): +```bash +hf download shazzadulimun/gemma3-270m-aurora-ml-v3-gguf --local-dir ./model +./llama-cli -m ./model/*.gguf -ngl 999 --temp 0.0 -cnv +``` + +Or **Ollama / LM Studio**: `ollama run hf.co/shazzadulimun/gemma3-270m-aurora-ml-v3-gguf` + + +## Training data + +Distilled from `openai/gpt-oss-120b on ALCF Sophia (vLLM)` over 130 cleaned chunks of +[`docs.alcf.anl.gov/aurora`](https://docs.alcf.anl.gov/aurora/). 1,117 +training rows + 139 validation rows in ChatML format with embedded +chain-of-thought (`**Reasoning:**` / `**Answer:**`). + +**Topic specialist — Data Science / AI.** Subset filtered to PyTorch/XPU, TensorFlow, vLLM, DeepSpeed, Megatron, JAX, Jupyter, and ML framework setup on Aurora. Trains a model to know `torch.xpu`, `module load frameworks`, IPEX patterns, etc. + +Full corpus + reproduction scripts: +[**SIslamMun/Generator @ aurora-datasets-2026-04-30**](https://github.com/SIslamMun/Generator/tree/aurora-datasets-2026-04-30/datasets/aurora/iter2/data/training/C2). + + + +## Limitations + +- **Synthetic-data biases.** Teacher (`gpt-oss-120b`) can confabulate plausible-looking + but incorrect commands. Treat outputs as a verifiable first draft, not authoritative. +- **Doc snapshot is fixed at 2026-04-29.** Module versions, queue names, and APIs change + — anything published after that date isn't reflected here. +- **Aurora-only.** Specifics (`/lus/flare`, `xpu`, PBS queues) won't transfer to Frontier, + Polaris, or other systems. +- **Use temperature ≤ 0.1** for technical answers; higher temps invite invented flag names + and paths. + +## Citation + +```bibtex +@misc{aurora-llms-2026, + title = { Gemma-3-270M-Aurora-ML v3 }, + author = { Islam Mun, Shazzadul }, + year = { 2026 }, + url = { https://huggingface.co/shazzadulimun/gemma3-270m-aurora-ml-v3-gguf }, + note = { LoRA fine-tune of gemma-3-270m-it; data distilled from gpt-oss-120b on docs.alcf.anl.gov/aurora } +} +``` + +## License + +Apache-2.0 for the adapter weights and synthetic training data. Source corpus is public +ALCF user documentation. Base model retains its own license — see +[`unsloth/gemma-3-270m-it`](https://huggingface.co/unsloth/gemma-3-270m-it). diff --git a/gemma270m_C2-f16.gguf b/gemma270m_C2-f16.gguf new file mode 100644 index 0000000..1fea3ad --- /dev/null +++ b/gemma270m_C2-f16.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:55d1eb1017ddfeb899619f92ff8346d719b02d4fd4c234897703429277ee3193 +size 542834976