IsValorum commited on
Commit
019801d
Β·
verified Β·
1 Parent(s): 65dcb68

Remove exact laptop and RAM-offload throughput figures

Browse files
Files changed (1) hide show
  1. README.md +7 -7
README.md CHANGED
@@ -39,10 +39,10 @@ quantized_by: IsValorum
39
  > This repository hosts the **MiniPlus V1** edition of **Nex-N2.5-mini**. Our releases are precision-engineered for specific hardware budgets and memory topologies. **V1 is NOT obsolete or inferior; it represents our leanest, most agile operating profile:**
40
  >
41
  > - **MiniPlus V1 (Lean & Agile Profile):** Highly compact footprint with uncompressed `F32` router gates, a fully armored `Q6_K` output head, `Q8_0` attention gates, and `IQ3_XXS` core experts. **Both V1 and V2.1 run flawlessly with the vast majority of the model residing in system RAM (DDR4/DDR5)**, thanks to linear CPU-friendly vectorization that avoids lookup stalls. V1 is dramatically superior to generic community APEX-I-Mini releases (which crush core reasoning down to 2-bit `IQ2_S`) and flat 3-bit quants.
42
- > - **MiniPlus V2.1 (System RAM Streaming Specialist with Deep Context):** Specially prepared to run **totally or partially in system RAM (DDR4/DDR5)** across massive multimodal and agentic context windows (up to 256k tokens). Upgrades all 40 shared foundation experts to `Q5_K`, armors attention gates in `Q8_0`, and uses linear CPU-friendly vectorization that eliminates AVX2 lookup stalls (+24 to 28+ tok/s). Depending on your processor and memory bandwidth (DDR4/DDR5), **streaming generation in system RAM can be almost as fast as having everything in VRAM**, while supporting deep context keeping the dedicated `Q8_0` multimodal vision projector (`mmproj`) explicitly loaded in GPU VRAM for instant screen parsing and OCR. All for **only approx. 180 MB more** (approx. 13.74 GiB vs approx. 13.56 GiB)β€”an overhead that is completely negligible in system RAM.
43
  >
44
  > **Which one should you choose? (Official Recommendation: V2.1)**
45
- > - **⭐ PRIMARY RECOMMENDATION β€” [Nex-N2.5-mini APEX-I-MiniPlus V2.1](https://huggingface.co/IsValorum/Nex-N2.5-mini-APEX-I-MiniPlus-V2.1-GGUF):** For virtually all users and deployments, **V2.1 is the strictly recommended release**. V2.1 reports a **Perplexity of 6.4725 Β± 0.1635** (Ξ”PPL β‰ˆ +0.07 from unquantized baseline (approx. 6.40)), matching the token fidelity of **Q5_K / Q6_K** class quantizations while weighing only **approx. 14.7 GB** (same footprint as Q3_K_M). Furthermore, it completely eliminates AVX2 CPU stalls, providing blistering **+24 to 28+ tok/s streaming** under system RAM offload.
46
  > - **MiniPlus V1 Legacy:** Maintained for architectural transparency and users seeking specialized configurations for their workflow.
47
  >
48
  > *Both editions are handcrafted and vastly outperform flat 3-bit quants and generic community APEX-I-Mini releases.*
@@ -62,7 +62,7 @@ quantized_by: IsValorum
62
  - [Comparative Quantization Analysis (vs. Flat Quants & Generic APEX)](#comparative-analysis)
63
  - [Independent Benchmark of the APEX-I-MiniPlus Family (Occamy V2 Reference)](#independent-benchmark)
64
  - [Bundled Q8_0 High-Precision Vision Projector](#vision-projector)
65
- - [Everyday Laptop Benchmarks (DDR4 / DDR5 RAM)](#laptop-benchmarks)
66
  - [The 24GB Miracle: Full 256K Context Runs In VRAM!](#context-scaling)
67
  - [Hardware Throughput & Offload Benchmarks (RTX 30 / 40 / 50)](#throughput-projections)
68
  - [Recommended Generation Parameters (Creator Official)](#generation-parameters)
@@ -108,7 +108,7 @@ The evaluation tested the APEX-I hybrid MoE engine across **348 unseeded trials*
108
  <a id="comparative-analysis"></a>
109
  ## Comparative Quantization Analysis (vs. Flat Quants & Generic APEX)
110
 
111
- Also, don't confuse **APEX-I-MiniPlus (Standard)** with a generic baseline APEX-I-Mini. Traditional APEX-I-Mini drops core experts aggressively to 2-bit `IQ2_S` and leaves `output.weight` at 3-bit `Q3_K_M`, which creates a noticeable perplexity hit on complex reasoning tasks. Standard MiniPlus avoids that degradation floor while keeping boundary layers in linear `Q3_K` for single-cycle vectorized AVX2 CPU dequantization (hitting 23 to 26+ tok/s on DDR4 laptops), while protecting output in `Q6_K` and routers in `F32`.
112
 
113
  To put the numbers in perspective: this cuts nearly **2 GB off a flat 3-bit quant** (approx. 15.6 GB), and weighs only about **approx. 1 GB more than a generic APEX-I-Mini** (approx. 12.5 GB). For that single extra gigabyte of VRAM, you get a massive jump in reasoning and syntactic stability while maximizing CPU/RAM execution throughput.
114
 
@@ -122,7 +122,7 @@ Take a look at the tensor-by-tensor comparison table below to inspect the exact
122
  | **Attention Gates (`attn_gate.weight`)** | Blindly compressed to 3-bit | Compressed to **`Q3_K`** (middle) / **`Q4_K`** (edges) | **`Q4_K`** / **`Q8_0`** (linear high-precision) | **Attention Routing Dynamics:** High-precision linear gating modulating query-key projections without CPU dequantization latency. |
123
  | **Shared Foundation Expert (`ffn_*_shexp`)** | Flat **`IQ3_S` / `Q3_K_S`** (3.44 BPW) | Linear **`Q4_K`** (middle) / **`Q5_K`** (edges) | Linear **`Q4_K`** (middle) / **`Q5_K`** (edges) + `imatrix` | **Foundational Knowledge Stability:** Keeps the universal pathway in high-fidelity linear blocks, eliminating quantization drift while maintaining rapid single-cycle dequantization. |
124
  | **Core MoE Layers (Middle: 10–29)** | Flat **`IQ3_S` / `Q3_K_S`** (uniform bit-rate across all layers) | Aggressive **`IQ2_S` (2.50 BPW)** | **`IQ3_XXS` (3.06 BPW) + calibrated `imatrix`** | **Above the Quality Threshold:** Generic 2-bit `IQ2_S` baselines drop below the critical quality floor for 35B MoEs, resulting in perplexity spikes on reasoning tasks. Our `IQ3_XXS` with imatrix achieves deep compression (272 MiB β†’ 98 MiB per block) without sacrificing logic. |
125
- | **Edge MoE Layers (Layers 0–9 & 30–39)** | Flat **`IQ3_S` / `Q3_K_S`** (no layer-wise gradient) | `Q3_K` (limited to first/last 5 layers only: L0–4, L35–39) | **`Q3_K` (expanded to 10 input & 10 output layers)** | **AVX2 Single-Cycle Speed:** Expanded 10+10 layer protection using linear `Q3_K` blocks enables single-cycle vectorized AVX2 CPU dequantization, unlocking **23 to 26+ tok/s** on budget DDR4 laptops. |
126
  | **Multimodal Vision (`mmproj`)** | Often omitted, or left as uncompressed **`FP16` (approx. 900 MB)** | Often omitted or separate uncompressed `FP16` | **Bundled `Q8_0` (582 MB)** with **27 critical F32/F16 fallbacks** | **Saves approx. 320 MB VRAM with Zero Loss:** Handcrafted quantization preserves normalization and bias tensors in F32/F16, ensuring razor-sharp OCR, DOM viewport reading, and coordinate detection without visual noise. |
127
  | **Normalization & Biases** | Often degraded | Standard | **`F32` uncompressed** | **Numerical Stability:** Prevents cumulative floating-point underflow/overflow across deep 40-layer computation. |
128
 
@@ -138,7 +138,7 @@ Unlike text-only MoEs, Nex-N2.5-mini is designed for computer use, visual ground
138
  ---
139
 
140
  <a id="laptop-benchmarks"></a>
141
- ## Everyday Laptop Benchmarks (23–26+ tok/s on DDR4)
142
  ### *Empirically Verified in Unsloth Studio*
143
 
144
  - **GPU VRAM Offload:** Uses only **3.8 GB VRAM** (fits effortlessly on budget 4GB and 6GB laptop GPUs like the RTX 4050, 3050, or older 1660 Ti/2060).
@@ -168,7 +168,7 @@ Unlike text-only MoEs, Nex-N2.5-mini is designed for computer use, visual ground
168
  | **NVIDIA RTX 5080 / 5090 (Blackwell)** | Full GPU (`-ngl 99`) | **approx. 247 – 251 tok/s** | **2,800 – 3,900+ tok/s** | Empirically verified on RTX 5090 by zephel01 (Occamy V2 Reference) |
169
  | **NVIDIA RTX 4090 (24GB GDDR6X)** | Full GPU (`-ngl 99`) + mmproj | **75 – 100+ tok/s** | **1,700 – 2,500+ tok/s** | Real-time computer-use screen analysis & tool calling |
170
  | **NVIDIA RTX 3090 (24GB GDDR6)** | Full GPU (`-ngl 99`) + mmproj | **62 – 78+ tok/s** | **1,350 – 1,950+ tok/s** | Full 256k multi-modal context in dedicated VRAM |
171
- | **Consumer Laptop (4GB GPU + 32GB RAM)**| Hybrid Offload | **20 – 24+ tok/s** | **300 – 420+ tok/s** | Smooth streaming from system DDR4/DDR5 RAM |
172
 
173
  <a id="generation-parameters"></a>
174
  ### βš™οΈ Recommended Generation Parameters (nex-agi Official)
 
39
  > This repository hosts the **MiniPlus V1** edition of **Nex-N2.5-mini**. Our releases are precision-engineered for specific hardware budgets and memory topologies. **V1 is NOT obsolete or inferior; it represents our leanest, most agile operating profile:**
40
  >
41
  > - **MiniPlus V1 (Lean & Agile Profile):** Highly compact footprint with uncompressed `F32` router gates, a fully armored `Q6_K` output head, `Q8_0` attention gates, and `IQ3_XXS` core experts. **Both V1 and V2.1 run flawlessly with the vast majority of the model residing in system RAM (DDR4/DDR5)**, thanks to linear CPU-friendly vectorization that avoids lookup stalls. V1 is dramatically superior to generic community APEX-I-Mini releases (which crush core reasoning down to 2-bit `IQ2_S`) and flat 3-bit quants.
42
+ > - **MiniPlus V2.1 (System RAM Streaming Specialist with Deep Context):** Specially prepared to run **totally or partially in system RAM (DDR4/DDR5)** across massive multimodal and agentic context windows (up to 256k tokens). Upgrades all 40 shared foundation experts to `Q5_K`, armors attention gates in `Q8_0`, and uses linear CPU-friendly vectorization that eliminates AVX2 lookup stalls. Depending on your processor and memory bandwidth (DDR4/DDR5), **streaming generation in system RAM can be almost as fast as having everything in VRAM**, while supporting deep context keeping the dedicated `Q8_0` multimodal vision projector (`mmproj`) explicitly loaded in GPU VRAM for instant screen parsing and OCR. All for **only approx. 180 MB more** (approx. 13.74 GiB vs approx. 13.56 GiB)β€”an overhead that is completely negligible in system RAM.
43
  >
44
  > **Which one should you choose? (Official Recommendation: V2.1)**
45
+ > - **⭐ PRIMARY RECOMMENDATION β€” [Nex-N2.5-mini APEX-I-MiniPlus V2.1](https://huggingface.co/IsValorum/Nex-N2.5-mini-APEX-I-MiniPlus-V2.1-GGUF):** For virtually all users and deployments, **V2.1 is the strictly recommended release**. V2.1 reports a **Perplexity of 6.4725 Β± 0.1635** (Ξ”PPL β‰ˆ +0.07 from unquantized baseline (approx. 6.40)), matching the token fidelity of **Q5_K / Q6_K** class quantizations while weighing only **approx. 14.7 GB** (same footprint as Q3_K_M). Furthermore, it eliminates AVX2 CPU stalls and is optimized for system RAM offload.
46
  > - **MiniPlus V1 Legacy:** Maintained for architectural transparency and users seeking specialized configurations for their workflow.
47
  >
48
  > *Both editions are handcrafted and vastly outperform flat 3-bit quants and generic community APEX-I-Mini releases.*
 
62
  - [Comparative Quantization Analysis (vs. Flat Quants & Generic APEX)](#comparative-analysis)
63
  - [Independent Benchmark of the APEX-I-MiniPlus Family (Occamy V2 Reference)](#independent-benchmark)
64
  - [Bundled Q8_0 High-Precision Vision Projector](#vision-projector)
65
+ - [Everyday Laptop Guidance (DDR4 / DDR5 RAM)](#laptop-benchmarks)
66
  - [The 24GB Miracle: Full 256K Context Runs In VRAM!](#context-scaling)
67
  - [Hardware Throughput & Offload Benchmarks (RTX 30 / 40 / 50)](#throughput-projections)
68
  - [Recommended Generation Parameters (Creator Official)](#generation-parameters)
 
108
  <a id="comparative-analysis"></a>
109
  ## Comparative Quantization Analysis (vs. Flat Quants & Generic APEX)
110
 
111
+ Also, don't confuse **APEX-I-MiniPlus (Standard)** with a generic baseline APEX-I-Mini. Traditional APEX-I-Mini drops core experts aggressively to 2-bit `IQ2_S` and leaves `output.weight` at 3-bit `Q3_K_M`, which creates a noticeable perplexity hit on complex reasoning tasks. Standard MiniPlus avoids that degradation floor while keeping boundary layers in linear `Q3_K` for single-cycle vectorized AVX2 CPU dequantization (optimized for DDR4/DDR5 laptop streaming), while protecting output in `Q6_K` and routers in `F32`.
112
 
113
  To put the numbers in perspective: this cuts nearly **2 GB off a flat 3-bit quant** (approx. 15.6 GB), and weighs only about **approx. 1 GB more than a generic APEX-I-Mini** (approx. 12.5 GB). For that single extra gigabyte of VRAM, you get a massive jump in reasoning and syntactic stability while maximizing CPU/RAM execution throughput.
114
 
 
122
  | **Attention Gates (`attn_gate.weight`)** | Blindly compressed to 3-bit | Compressed to **`Q3_K`** (middle) / **`Q4_K`** (edges) | **`Q4_K`** / **`Q8_0`** (linear high-precision) | **Attention Routing Dynamics:** High-precision linear gating modulating query-key projections without CPU dequantization latency. |
123
  | **Shared Foundation Expert (`ffn_*_shexp`)** | Flat **`IQ3_S` / `Q3_K_S`** (3.44 BPW) | Linear **`Q4_K`** (middle) / **`Q5_K`** (edges) | Linear **`Q4_K`** (middle) / **`Q5_K`** (edges) + `imatrix` | **Foundational Knowledge Stability:** Keeps the universal pathway in high-fidelity linear blocks, eliminating quantization drift while maintaining rapid single-cycle dequantization. |
124
  | **Core MoE Layers (Middle: 10–29)** | Flat **`IQ3_S` / `Q3_K_S`** (uniform bit-rate across all layers) | Aggressive **`IQ2_S` (2.50 BPW)** | **`IQ3_XXS` (3.06 BPW) + calibrated `imatrix`** | **Above the Quality Threshold:** Generic 2-bit `IQ2_S` baselines drop below the critical quality floor for 35B MoEs, resulting in perplexity spikes on reasoning tasks. Our `IQ3_XXS` with imatrix achieves deep compression (272 MiB β†’ 98 MiB per block) without sacrificing logic. |
125
+ | **Edge MoE Layers (Layers 0–9 & 30–39)** | Flat **`IQ3_S` / `Q3_K_S`** (no layer-wise gradient) | `Q3_K` (limited to first/last 5 layers only: L0–4, L35–39) | **`Q3_K` (expanded to 10 input & 10 output layers)** | **AVX2 Single-Cycle Speed:** Expanded 10+10 layer protection using linear `Q3_K` blocks enables single-cycle vectorized AVX2 CPU dequantization, supporting efficient streaming on budget DDR4/DDR5 laptops. |
126
  | **Multimodal Vision (`mmproj`)** | Often omitted, or left as uncompressed **`FP16` (approx. 900 MB)** | Often omitted or separate uncompressed `FP16` | **Bundled `Q8_0` (582 MB)** with **27 critical F32/F16 fallbacks** | **Saves approx. 320 MB VRAM with Zero Loss:** Handcrafted quantization preserves normalization and bias tensors in F32/F16, ensuring razor-sharp OCR, DOM viewport reading, and coordinate detection without visual noise. |
127
  | **Normalization & Biases** | Often degraded | Standard | **`F32` uncompressed** | **Numerical Stability:** Prevents cumulative floating-point underflow/overflow across deep 40-layer computation. |
128
 
 
138
  ---
139
 
140
  <a id="laptop-benchmarks"></a>
141
+ ## Everyday Laptop Guidance
142
  ### *Empirically Verified in Unsloth Studio*
143
 
144
  - **GPU VRAM Offload:** Uses only **3.8 GB VRAM** (fits effortlessly on budget 4GB and 6GB laptop GPUs like the RTX 4050, 3050, or older 1660 Ti/2060).
 
168
  | **NVIDIA RTX 5080 / 5090 (Blackwell)** | Full GPU (`-ngl 99`) | **approx. 247 – 251 tok/s** | **2,800 – 3,900+ tok/s** | Empirically verified on RTX 5090 by zephel01 (Occamy V2 Reference) |
169
  | **NVIDIA RTX 4090 (24GB GDDR6X)** | Full GPU (`-ngl 99`) + mmproj | **75 – 100+ tok/s** | **1,700 – 2,500+ tok/s** | Real-time computer-use screen analysis & tool calling |
170
  | **NVIDIA RTX 3090 (24GB GDDR6)** | Full GPU (`-ngl 99`) + mmproj | **62 – 78+ tok/s** | **1,350 – 1,950+ tok/s** | Full 256k multi-modal context in dedicated VRAM |
171
+ | **Consumer Laptop (4GB GPU + 32GB RAM)**| Hybrid Offload | Hardware-dependent | Hardware-dependent | Smooth streaming from system DDR4/DDR5 RAM |
172
 
173
  <a id="generation-parameters"></a>
174
  ### βš™οΈ Recommended Generation Parameters (nex-agi Official)