Upload folder using huggingface_hub

README.md

@@ -0,0 +1,117 @@
+---
+library_name: transformers.js
+tags:
+- router
+- orchestrator
+- slm
+- edge-computing
+- mixture-of-experts
+- text-generation
+pipeline_tag: text-generation
+model_type: llama
+datasets:
+- SupraLabs/Prompt-Routing-Dataset
+language:
+- en
+base_model:
+- SupraLabs/Supra-Router-51M
+---
+
+
+
+# Supra-Router-51M (ONNX)
+
+
+This is an ONNX version of [SupraLabs/Supra-Router-51M](https://huggingface.co/SupraLabs/Supra-Router-51M). It was automatically converted and uploaded using [this Hugging Face Space](https://huggingface.co/spaces/onnx-community/convert-to-onnx).
+
+
+## Usage with Transformers.js
+
+
+See the pipeline documentation for `text-generation`: https://huggingface.co/docs/transformers.js/api/pipelines#module_pipelines.TextGenerationPipeline
+
+
+---
+
+
+<h1 align="center">Supra-Router-51M · Multi-Task Infrastructure Routing Model</h1>
+
+![logo](https://cdn-uploads.huggingface.co/production/uploads/697f2832c2c5e4daa93cece7/lClDSdp9BkKyv_VGWSQbt.png)
+
+<h2 align="center">About the Model</h2>
+
+GGUF model [here](https://huggingface.co/SupraLabs/Supra-Router-51M-gguf)
+
+**Supra-Router-51M** is an ultra-lightweight, high-speed infrastructure traffic controller optimized for localized edge orchestration. With only **51.7 million parameters**, this micro-LLM acts as a defensive gateway for multi-model ecosystems, accurately determining when user requests can be processed locally by an Edge SLM or when they must be triaged to a cloud-hosted frontier intelligence layer.
+
+The model was built by fine-tuning a pre-trained 51M base on the `SupraLabs/Prompt-Routing-Dataset` (992 rows). Rather than acting as a naive binary classifier, the model uses **Multi-Task Sequence Generation** to map out the underlying properties of a prompt before predicting the final routing token, anchoring its attention heads to robust language and structural logic features.
+
+---
+
+## Multi-Task Decision Sequence
+
+To run inference, wrap your user query inside the structural framing tokens used during training (`Task: [Prompt]\nAnalysis: `). The model will output a deterministic, pipe-separated string containing the full telemetry of the prompt's cognitive requirements:
+
+### Expected Output Target Schema:
+```text
+Domain: [Semantic Field] | Complexity: [1-5] | Math: [True/False] | Code: [True/False] | Route: [small model/big model] | Justification: [Rule-driven infrastructure reasoning]
+```
+
+## Why this works:
+
+By forcing a sub-100M parameter model to calculate the semantic domain, structural complexity, and technical flags before it emits the final Route token, the network effectively runs an internal feature-activation map. This multi-task sequence prevents localized weight collapse and guarantees stable routing boundaries.
+
+## Training Telemetry & Optimization
+
+- Dataset Source: SupraLabs/Prompt-Routing-Dataset (992 samples)
+- Training Duration: 5 Epochs
+- Checkpoint Selection: Peak generalization was reached during Epoch 3 (eval_loss: 0.1342). To eliminate late-stage micro-model memorization and validation drift, the training state was automatically rewound and saved at this numerical peak.
+- Precision: bfloat16
+- Hardware Footprint: Optimized sequence processing length of 3840 tokens, ensuring rapid inference execution with negligible CPU/GPU overhead (sub-millisecond generation speeds).
+
+## Inference & Gateway Implementation
+
+Use this direct script to test or wrap the model inside a live production orchestrator or FastAPI gateway. It enforces greedy decoding (do_sample=False) for maximum decision stability.
+
+```python
+import torch
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+MODEL_ID = "SupraLabs/Supra-Router-51M"
+
+print("[*] Initializing local infrastructure router...")
+tokenizer = AutoTokenizer.from_pretrained(MODEL_ID)
+model = AutoModelForCausalLM.from_pretrained(
+    MODEL_ID,
+    dtype=torch.bfloat16,
+    device_map="auto"
+)
+model.eval()
+
+# Example prompt showcasing keyword-trap evasion
+user_prompt = "Write a movie script about a chef who gets lost at sea."
+
+# Format to match internal SFT attention alignment
+formatted_input = f"Task: {user_prompt}\nAnalysis: "
+inputs = tokenizer(formatted_input, return_tensors="pt").to(model.device)
+
+with torch.no_grad():
+    outputs = model.generate(
+        **inputs,
+        max_new_tokens=128,
+        do_sample=False, 
+        pad_token_id=tokenizer.pad_token_id,
+        eos_token_id=tokenizer.eos_token_id
+    )
+
+generated_ids = outputs[0][inputs["input_ids"].shape[1]:]
+print(tokenizer.decode(generated_ids, skip_special_tokens=True).strip())
+```
+
+## Proven Benchmarks & Defensive Boundaries
+
+During edge validation testing, Supra-Router-51M demonstrated robust resilience against adversarial prompt strings:
+
+- Keyword Trap Evasion: Successfully identifies semantic context rather than matching tokens. Prompts containing words like "script" or "calculus" are correctly parsed as creative writing (not programming/math code) and routed locally to the small model when complexity is low.
+- Complexity-Driven Safety Net: In instances where programming syntax or technical boundaries are ambiguous (e.g., complex regex or architectural database frames), the model naturally scales its evaluation metrics to Complexity: 3, automatically triggering a big model route override.
+- Deterministic Offloading: Safely captures multi-step logic paths, calculus concepts, and code generation scripts, instantly assigning them to cloud-scale frontier endpoints.

config.json

@@ -0,0 +1,36 @@
+{
+  "architectures": [
+    "LlamaForCausalLM"
+  ],
+  "attention_bias": false,
+  "attention_dropout": 0.0,
+  "bos_token_id": 0,
+  "dtype": "float32",
+  "eos_token_id": 2,
+  "head_dim": 64,
+  "hidden_act": "silu",
+  "hidden_size": 512,
+  "initializer_range": 0.02,
+  "intermediate_size": 1408,
+  "max_position_embeddings": 5120,
+  "mlp_bias": false,
+  "model_type": "llama",
+  "num_attention_heads": 8,
+  "num_hidden_layers": 12,
+  "num_key_value_heads": 4,
+  "pad_token_id": 1,
+  "pretraining_tp": 1,
+  "rms_norm_eps": 1e-06,
+  "rope_parameters": {
+    "factor": 1.0,
+    "rope_theta": 10000.0,
+    "rope_type": "linear",
+    "type": "linear"
+  },
+  "rope_scaling": null,
+  "rope_theta": 10000.0,
+  "tie_word_embeddings": true,
+  "transformers_version": "4.57.6",
+  "use_cache": true,
+  "vocab_size": 32000
+}

generation_config.json

@@ -0,0 +1,7 @@
+{
+  "_from_model_config": true,
+  "bos_token_id": 0,
+  "eos_token_id": 2,
+  "pad_token_id": 1,
+  "transformers_version": "4.57.6"
+}

onnx/model.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0bfdc54738a098d0cb96efcb16053ca82077d0cb505cde14b303b60d80af51db
+size 273175838

onnx/model_bnb4.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09e59d7ec80266c2996e3b285c5eb29662056bbd2cbaa66675ff25b2ba9b4d1e
+size 98453262

onnx/model_fp16.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c3dd6d22c1b5ad92e01f2369ca10ddec95fec6590f20a09cd25691e41727a9e1
+size 137057529

onnx/model_int8.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f1b4685aaa5f7849da809507f07a85764be8b1d7335a5926177c01adde8338c1
+size 69001679

onnx/model_q4.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09e59d7ec80266c2996e3b285c5eb29662056bbd2cbaa66675ff25b2ba9b4d1e
+size 98453262

onnx/model_q4f16.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a8face6fcbe0e8389f3ed17274fae57f5197b67757869dcf25cee8007aa63089
+size 62597905

onnx/model_quantized.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f1b4685aaa5f7849da809507f07a85764be8b1d7335a5926177c01adde8338c1
+size 69001679

onnx/model_uint8.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e1126a497e691428bb9547e80614886e282d0304657ab6c2ed0f7acfe6894f55
+size 69001726