AbteeXAILabs commited on
Commit
60ad7e5
·
verified ·
1 Parent(s): bcc385e

docs: publish professional LumynaX model card

Browse files
Files changed (3) hide show
  1. README.md +115 -291
  2. checksums.sha256 +1 -1
  3. docs/lumynax-runtime-flow.svg +35 -21
README.md CHANGED
@@ -18,72 +18,55 @@ tags:
18
  - text
19
  ---
20
 
21
- <p align="center"><img src="docs/lumynax-overview.svg" alt="LumynaX Infused Gemma4 26B A4B GGUF release overview" width="100%" /></p>
22
 
23
- <!-- lumynax-public-release-card:v6 -->
24
-
25
- <h1 align="center">LumynaX Infused Gemma4 26B A4B GGUF</h1>
26
-
27
- <p align="center"><em>&ldquo;Sovereign intelligence, held in the light.&rdquo;</em><br/><em>Ko te m&#257;rama te t&#363;&#257;papa &mdash; the light is the foundation.</em></p>
28
-
29
- <p align="center"><strong>A LumynaX release from AbteeX AI Labs &mdash; Aotearoa New Zealand.</strong></p>
30
 
31
  <p align="center">
32
- <a href="#-quickstart"><b>Quickstart</b></a> &middot;
33
- <a href="#-runtime-architecture"><b>Architecture</b></a> &middot;
34
- <a href="#-model-profile"><b>Profile</b></a> &middot;
35
- <a href="#-capability-profile"><b>Capability</b></a> &middot;
36
- <a href="#-provenance--license"><b>Provenance</b></a> &middot;
37
- <a href="#-validation"><b>Validation</b></a> &middot;
38
- <a href="#-companion-products"><b>Companions</b></a>
39
  </p>
40
 
41
- <p align="center"><img alt="LumynaX: release" src="https://img.shields.io/badge/LumynaX-release-e08a2c?style=for-the-badge" /> <img alt="Family: gemma" src="https://img.shields.io/badge/Family-gemma-9a5416?style=for-the-badge" /> <img alt="Runtime: llama%20cpp" src="https://img.shields.io/badge/Runtime-llama%20cpp-726b62?style=for-the-badge" /> <img alt="Modes: text" src="https://img.shields.io/badge/Modes-text-4d6b44?style=for-the-badge" /> <img alt="Params: 26.0B%20/%204.0B%20active" src="https://img.shields.io/badge/Params-26.0B%20/%204.0B%20active-0a0a0b?style=for-the-badge" /> <img alt="Quant: UD-Q4_K_M" src="https://img.shields.io/badge/Quant-UD--Q4__K__M-111827?style=for-the-badge" /> <img alt="Context: 8192%20tok" src="https://img.shields.io/badge/Context-8192%20tok-111827?style=for-the-badge" /> <img alt="License: gemma" src="https://img.shields.io/badge/License-gemma-9a5416?style=for-the-badge" /> <img alt="Sovereignty: tier%203" src="https://img.shields.io/badge/Sovereignty-tier%203-4d6b44?style=for-the-badge" /> <img alt="Audit: pass" src="https://img.shields.io/badge/Audit-pass-4d6b44?style=for-the-badge" /> <img alt="Access: public%20&%20non--gated" src="https://img.shields.io/badge/Access-public%20&%20non----gated-0a0a0b?style=for-the-badge" /> <img alt="Card: v6" src="https://img.shields.io/badge/Card-v6-111827?style=for-the-badge" /></p>
42
-
43
- <p align="center"><kbd>Quality: <b>5/5</b></kbd> &middot; <kbd>Lightweight: <b>0/5</b></kbd> &middot; <kbd>Sovereignty: <b>3/5</b></kbd> &middot; <kbd>Tools: <b>no</b></kbd> &middot; <kbd>JSON: <b>yes</b></kbd> &middot; <kbd>Context: <b>8192 tok</b></kbd></p>
44
-
45
- ---
46
-
47
- ## 📦 Executive Summary
48
 
49
- > `AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf` is a **complete LumynaX release package**: model artifact, `quickstart.py`, `requirements.txt`, `release_export_manifest.json`, `checksums.sha256`, license notice, and optional Ollama / Space scaffolds shipped as **one downloadable contract**. Clone whole, verify by checksum, and run close to the data it serves.
 
 
 
 
 
 
 
50
 
51
- > **LumynaX-infused** means the upstream artifact is presented through the LumynaX release layer: local-first runtime scaffolding, LumynaX assistant identity, inference-chain metadata, integrity files, and Aotearoa New Zealand-oriented workflow positioning. The release manifest records this as a LumynaX *packaging and inference-chain layer* around the listed upstream artifact &mdash; it does **not** claim a private LumynaX weight merge.
52
 
53
- ## 🧭 Runtime Architecture
54
 
55
- <p align="center"><img src="docs/lumynax-runtime-flow.svg" alt="LumynaX runtime flow" width="100%" /></p>
56
 
57
- Mermaid graph (interactive on Hugging Face & GitHub):
58
 
59
- ```mermaid
60
- flowchart LR
61
- R["⮕ Request"] --> C["🛡 Data Capsule<br/>policy envelope"]
62
- C -->|allow| MR["🧭 MaramaRoute<br/>sovereign router"]
63
- MR -->|score & select| LLM[(LumynaX Model)]
64
- LLM --> O["📤 Response"]
65
- O --> A["📓 Audit Ledger<br/>hash-chained"]
66
- classDef paper fill:#fffefa,stroke:#0a0a0b,color:#0a0a0b,stroke-width:1.4px;
67
- classDef accent fill:#e08a2c,stroke:#9a5416,color:#0a0a0b,stroke-width:1.4px;
68
- classDef ink fill:#0a0a0b,stroke:#0a0a0b,color:#fffefa,stroke-width:1.4px;
69
- class R,O paper
70
- class C,MR accent
71
- class LLM,EMB,A ink
72
- ```
73
 
74
- Each step is observable:
75
 
76
- | Step | What happens | Why |
77
- | --- | --- | --- |
78
- | **Request** | A client sends a prompt + declared purpose, jurisdiction, sensitivity. | Intent must be declared, not inferred. |
79
- | **Data Capsule** | A policy envelope describes what can / cannot happen to the data. | Sovereignty is enforced at the data, not the wire. |
80
- | **MaramaRoute** | The sovereign router scores candidates by jurisdiction, runtime, modality, task fit. | Right model for the work, not the loudest. |
81
- | **LumynaX Model** | This package serves the inference, local-first by default. | Sensitive context never leaves the operator&rsquo;s environment. |
82
- | **Audit Ledger** | A hash-chained record persists capsule, decision, request hash, obligations. | Tamper-evident provenance for the whole trace. |
83
 
84
- ## Quickstart
 
 
 
 
 
 
 
 
 
 
85
 
86
- **Clone the whole release** — every file matters, the package is a contract:
87
 
88
  ```bash
89
  hf download AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf --local-dir lumynax-infused-gemma4-26b-a4b-gguf
@@ -92,222 +75,140 @@ pip install -r requirements.txt
92
  python quickstart.py --interactive
93
  ```
94
 
95
- **Python:**
96
-
97
- ```python
98
- from llama_cpp import Llama
99
-
100
- llm = Llama(model_path="lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf", n_ctx=8192, n_threads=8, verbose=False)
101
- out = llm("Who are you? Answer as LumynaX in two sentences.", max_tokens=160)
102
- print(out["choices"][0]["text"].strip())
103
- ```
104
-
105
- **CLI smoke test:**
106
 
107
  ```bash
108
  llama-cli -m "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf" -p "Who are you? Answer as LumynaX in two sentences." -n 160
109
  ```
110
 
111
- **Ollama path:**
112
 
113
  ```bash
114
  ollama create lumynax-infused-gemma4-26b-a4b-gguf -f ollama/Modelfile
115
  ollama run lumynax-infused-gemma4-26b-a4b-gguf
116
  ```
117
 
118
- **Verify integrity before launch:**
119
-
120
- ```bash
121
- sha256sum "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf"
122
- cat checksums.sha256
123
- ```
124
-
125
- ```powershell
126
- Get-FileHash -Algorithm SHA256 "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf"
127
- Get-Content checksums.sha256
128
- ```
129
-
130
- ## 📐 Model Profile
131
-
132
- <table>
133
- <tr><td>
134
-
135
- **Release identity**
136
 
137
  | Field | Value |
138
  | --- | --- |
139
  | Release | `LumynaX Infused Gemma4 26B A4B GGUF` |
140
  | Repository | `AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf` |
141
- | Family | `gemma` |
142
- | Mode | `Local-first text generation package` |
143
- | Card schema | `lumynax-public-release-card:v6` |
144
-
145
- </td><td>
146
-
147
- **Runtime profile**
148
-
149
- | Field | Value |
150
- | --- | --- |
151
  | Runtime | `llama_cpp` |
152
  | Prompt format | `gemma_chat_template` |
153
  | Modalities | `text` |
154
- | Context window | `8192` tokens |
 
 
 
 
 
 
155
  | Quantization | `UD-Q4_K_M` |
 
 
 
156
 
157
- </td></tr>
158
- <tr><td>
159
-
160
- **Artifact**
161
-
162
- | Field | Value |
163
- | --- | --- |
164
- | Primary | `lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf` |
165
- | Weight size | `15.78 GB` |
166
- | Parameters | `26.0B / 4.0B active` |
167
- | Quality rank | `1` (1 best) |
168
- | Cost rank | `8` (1 cheapest) |
169
 
170
- </td><td>
 
 
171
 
172
- **Provenance**
173
 
174
  | Field | Value |
175
  | --- | --- |
176
- | Upstream / base | `google/gemma-4-26B-A4B-it` |
177
- | Source | `unsloth/gemma-4-26B-A4B-it-GGUF` |
178
- | License | `gemma` |
179
- | Sovereignty tier | `3` of 5 |
180
- | Audit | `pass` |
181
-
182
- </td></tr>
183
- </table>
184
-
185
- ## 📊 Capability Profile
186
-
187
- <p align="center"><img src="docs/lumynax-capability.svg" alt="Capability profile bars" width="100%" /></p>
188
-
189
- > **Primary fit.** Conversational assistance near governed data, with provenance visible and human review on high-impact tasks.
190
-
191
- | Signal | Reading |
192
- | --- | --- |
193
- | Quality rank | `1` (1 = strongest in family) |
194
- | Cost rank | `8` (1 = lightest weight) |
195
- | Sovereignty tier | `3` of 5 |
196
- | Tool calling | ❌ not supported |
197
- | JSON mode | ✅ supported |
198
- | Identity behaviour | Identifies as LumynaX while keeping upstream provenance visible. |
199
  | Operational style | Local-first package with explicit files, checksums, and reproducible quickstarts. |
 
200
 
201
- ## 🛡️ Sovereignty Contract
202
 
203
- > **Sovereignty is a design property, not a deployment option.**
204
-
205
- | Field | Value |
206
- | --- | --- |
207
- | Publisher | AbteeX AI Labs |
208
- | Family | LumynaX sovereign release family |
209
- | Sovereign intent | Local-first deployment near governed data, with explicit provenance and controlled human review. |
210
- | Sovereignty tier | `3` of 5 |
211
- | Runtime residency | `llama_cpp` can be deployed inside an operator-approved environment. |
212
- | Primary artifact | `lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf` &mdash; ships alongside manifest, checksums, quickstart, requirements, and license files. |
213
- | License discipline | Surface upstream license metadata so downstream users can verify redistribution and usage terms. |
214
- | Audit expectation | Record repo id, artifact checksum, runtime command, prompt template, operator, deployment environment. |
215
- | Router readiness | First-class with [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route). |
216
- | Policy readiness | First-class with [AbteeX SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode). |
217
-
218
- ## 📁 Runtime Files
219
 
220
- ```text
221
- lumynax-infused-gemma4-26b-a4b-gguf/
222
- ├── README.md # this card
223
- ├── quickstart.py # smoke runner
224
- ├── requirements.txt # pinned deps
225
- ├── release_export_manifest.json # full release metadata
226
- ├── checksums.sha256 # integrity verification
227
- ├── LICENSE.txt # license notice
228
- ├── ollama/Modelfile # optional Ollama runtime
229
- ├── hf_space/app.py # optional Space scaffold
230
- ├── docs/lumynax-overview.svg # release banner
231
- ├── docs/lumynax-runtime-flow.svg # runtime architecture
232
- ├── docs/lumynax-capability.svg # capability profile
233
- └── lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf# primary artifact
234
- ```
235
 
236
- ⚠️ **Keep the full set together.** Removing the manifest, checksums, or license file breaks the release contract.
 
 
237
 
238
- ## 💬 Prompting Contract
239
 
240
- **Preferred opening prompt:**
241
 
242
  ```text
243
  Who are you? What files do I need to keep together to run this package locally?
244
  ```
245
 
246
- > **Expected behaviour.** The assistant identifies as LumynaX, explains that this is a LumynaX model-infusion release, and keeps upstream provenance visible.
247
-
248
- **Default system prompt:**
249
 
250
  ```text
251
- You are LumynaX operating from the LumynaX Infused Gemma4 26B A4B GGUF package identity. Be helpful, clear, and honest about provenance. Identify upstream models when asked. Do not invent biographical claims about named people without verified context.
252
  ```
253
 
254
- ## Validation
255
 
256
- | Check | Result |
257
  | --- | --- |
258
- | Runtime audit | `pass` |
259
- | Public access | `public and non-gated` |
260
- | Anonymous metadata access | `true` |
261
- | Anonymous file listing | `true` |
262
- | Quickstart syntax | `pass` |
263
- | Manifest references | `pass` |
264
- | Checksum references | `pass` |
265
 
266
- > The audit confirms public access, release files, manifest references, checksum references, weight artifact presence, and quickstart syntax. It does **not** guarantee that every laptop has enough RAM, VRAM, disk, or recent runtime build for the largest packages.
267
 
268
- ## 🔗 Provenance & License
269
 
270
- | Field | Value |
271
- | --- | --- |
272
- | **Publisher** | AbteeX AI Labs |
273
- | **Family** | LumynaX model and inference-chain release family |
274
- | **Upstream / base** | `google/gemma-4-26B-A4B-it` |
275
- | **Source** | `unsloth/gemma-4-26B-A4B-it-GGUF` |
276
- | **License metadata** | `gemma` |
277
 
278
- > **Respect the upstream model licence** and keep attribution files with redistributed copies. Do not present this package as privately trained or weight-merged unless the release manifest explicitly says weight adaptation was applied.
 
 
 
279
 
280
- ## ⚠️ Limitations & Responsible Use
281
 
282
- - Outputs can be **incorrect, incomplete, or biased**; validate important answers before use.
283
- - Larger GGUF, MoE, multimodal, and frontier packages may require **substantial RAM, VRAM, disk space, and recent runtime builds**.
284
- - For high-impact decisions, use **human review** and domain-specific evaluation.
285
- - For sensitive data, prefer **local execution** and keep operational logs under your own governance policy.
286
- - This card documents **package readiness and access** &mdash; it is *not* a benchmark claim.
287
- - The assistant must **not invent biographical or organisational claims** about named people without verified context.
288
 
289
- ## 🌿 Aotearoa Kaupapa
290
 
291
- > LumynaX is built **in and for Aotearoa New Zealand**. Sovereignty is treated as a design property rather than a deployment option: the package documents where the model came from, what it can do, how to run it close to your data, and what it should not claim.
 
 
 
 
 
292
 
293
- > *Ko te mārama te tūāpapa* &mdash; the light is the foundation.
294
 
295
- ## 🤝 Companion Products
296
 
297
- <table>
298
- <tr>
299
- <td width="33%" align="center"><h3>🛡️</h3><h4><a href="https://huggingface.co/AbteeXAILab/sovereigncode">AbteeX SovereignCode</a></h4><p>Local-first coding agent with Data Capsule policy controls, audit ledger, and human-review gates.</p></td>
300
- <td width="33%" align="center"><h3>🧭</h3><h4><a href="https://huggingface.co/AbteeXAILab/marama-route">LumynaX MaramaRoute</a></h4><p>Sovereign model router across the LumynaX family. Filters by jurisdiction, residency, license, runtime, modality.</p></td>
301
- <td width="33%" align="center"><h3>💡</h3><h4><a href="https://huggingface.co/spaces/AbteeXAILab/lumynax-live-demo">LumynaX Live Demo</a></h4><p>Public browser demo. Try identity, provenance, governance, and deployment prompts in one session.</p></td>
302
- </tr>
303
- <tr>
304
- <td width="33%" align="center"><h4><a href="https://huggingface.co/spaces/AbteeXAILab/sovereigncode-demo">SovereignCode Live</a></h4><p>Interactive policy evaluator.</p></td>
305
- <td width="33%" align="center"><h4><a href="https://huggingface.co/spaces/AbteeXAILab/marama-route-demo">MaramaRoute Live</a></h4><p>Interactive sovereign router.</p></td>
306
- <td width="33%" align="center"><h4><a href="https://huggingface.co/AbteeXAILab">AbteeXAILab on HF</a></h4><p>The full LumynaX release family &mdash; 50 models and counting.</p></td>
307
- </tr>
308
- </table>
309
 
310
- ## 🤖 Automation Notes
311
 
312
  Automation should read these files before launching:
313
 
@@ -317,85 +218,8 @@ Automation should read these files before launching:
317
  - `requirements.txt`
318
  - `ollama/Modelfile` when present
319
 
320
- ---
321
-
322
- <p align="center"><em><b>Local roots, global work.</b> &middot; <b>Sovereignty is a design property, not a deployment option.</b></em></p>
323
-
324
- <p align="center">
325
- <a href="https://abteex.com"><b>abteex.com</b></a> &middot;
326
- <a href="https://lumynax.com"><b>lumynax.com</b></a> &middot;
327
- <a href="https://huggingface.co/AbteeXAILab"><b>huggingface.co/AbteeXAILab</b></a>
328
- </p>
329
-
330
- <p align="center"><sub>AbteeX AI Labs &middot; Aotearoa New Zealand &middot; LumynaX release card v6</sub></p>
331
-
332
- ---
333
-
334
- ## 🚀 Quickest start — the `lumynax` CLI
335
-
336
- ```bash
337
- pip install lumynax
338
- lumynax run lumynax-infused-gemma4-26b-a4b-gguf
339
- ```
340
-
341
- `lumynax run` auto-downloads weights, starts a server if needed, and opens an interactive REPL with slash commands (`/clear`, `/save`, `/system`, `/switch`, `/tools`). For one-shot use:
342
-
343
- ```bash
344
- lumynax run lumynax-infused-gemma4-26b-a4b-gguf "your prompt here"
345
- lumynax pull lumynax-infused-gemma4-26b-a4b-gguf # just download
346
- lumynax info lumynax-infused-gemma4-26b-a4b-gguf # full card
347
- lumynax serve lumynax-infused-gemma4-26b-a4b-gguf # OpenAI-compatible API on :8080
348
- ```
349
-
350
- Or via the legacy hf-download + quickstart.py path:
351
-
352
- ```bash
353
- hf download AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf --local-dir lumynax-infused-gemma4-26b-a4b-gguf
354
- cd lumynax-infused-gemma4-26b-a4b-gguf && pip install -r requirements.txt && python quickstart.py --interactive
355
- ```
356
-
357
-
358
- ---
359
-
360
- ## 🇳🇿 Made in Aotearoa New Zealand
361
-
362
- This model is part of the **LumynaX release family** from **AbteeX AI Labs**, an Aotearoa New Zealand AI lab focused on sovereign, local-first intelligence with provenance, audit trails, and jurisdiction-aware routing.
363
-
364
- > *Ko te mārama te tūāpapa — the light is the foundation.*
365
-
366
- | Resource | Link |
367
- | --- | --- |
368
- | 🏠 AbteeX AI Labs | [abteex.com](https://abteex.com) |
369
- | 🌟 LumynaX family | [lumynax.com](https://lumynax.com) |
370
- | 🤗 Hugging Face org | [huggingface.co/AbteeXAILab](https://huggingface.co/AbteeXAILab) |
371
- | 🐙 Monorepo | [github.com/Aimaghsoodi/lumynax-release](https://github.com/Aimaghsoodi/lumynax-release) |
372
- | 📦 Per-model GitHub | [github.com/aimaghsoodi/lumynax-infused-gemma4-26b-a4b-gguf](https://github.com/aimaghsoodi/lumynax-infused-gemma4-26b-a4b-gguf) |
373
- | 🧭 Routing | `lumynax route "<your prompt>" --local` (via [`lumynax` CLI](https://github.com/Aimaghsoodi/lumynax-release/tree/main/tools/lumynax-cli)) |
374
- | 🛡️ Policy + audit | [SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode) + [MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route) |
375
- | 🔌 Run via OpenAI-compatible gateway | See [`DEPLOYMENT.md`](https://github.com/Aimaghsoodi/lumynax-release/blob/main/DEPLOYMENT.md) |
376
-
377
- ### Run this model
378
-
379
- ```bash
380
- # Fastest — clone & run
381
- hf download AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf --local-dir lumynax-infused-gemma4-26b-a4b-gguf
382
- cd lumynax-infused-gemma4-26b-a4b-gguf && pip install -r requirements.txt && python quickstart.py --interactive
383
-
384
- # Or via the LumynaX CLI
385
- pip install lumynax
386
- lumynax run lumynax-infused-gemma4-26b-a4b-gguf -i
387
-
388
- # Or as an OpenAI-compatible server (for OpenCode, Continue, Cursor, vLLM, LM Studio, etc.)
389
- lumynax serve lumynax-infused-gemma4-26b-a4b-gguf --port 8080
390
- ```
391
-
392
- ### Sovereignty contract
393
 
394
- - **Residency:** NZ
395
- - **Sovereignty tier:** 3 *(1 = remote frontier · 3 = local-runnable · 5 = NZ-resident only)*
396
- - **Jurisdiction:** NZ
397
- - **License:** see_model_card *(upstream weights retain upstream licence)*
398
- - **Audit:** SHA-256 hash-chained ledger via SovereignCode
399
- - **Routing:** Considered by MaramaRoute when matching task to model
400
 
401
- *Brought to you by Aotearoa New Zealand — sovereign AI, held in the light.*
 
18
  - text
19
  ---
20
 
21
+ # LumynaX Infused Gemma4 26B A4B GGUF
22
 
23
+ <!-- lumynax-public-release-card:v4 -->
 
 
 
 
 
 
24
 
25
  <p align="center">
26
+ <img src="docs/lumynax-release-overview.svg" alt="LumynaX Infused Gemma4 26B A4B GGUF release overview" width="100%" />
 
 
 
 
 
 
27
  </p>
28
 
29
+ <p align="center">
30
+ <strong>LumynaX model-infusion release by AbteeX AI Labs.</strong><br/>
31
+ Public, non-gated package with runnable local instructions, provenance metadata, checksums, and a release manifest.
32
+ </p>
 
 
 
33
 
34
+ <p align="center">
35
+ <a href="#quickstart">Quickstart</a> |
36
+ <a href="#model-profile">Model profile</a> |
37
+ <a href="#runtime-files">Runtime files</a> |
38
+ <a href="#provenance-and-license">Provenance</a> |
39
+ <a href="#validation-status">Validation</a> |
40
+ <a href="#limitations-and-responsible-use">Limitations</a>
41
+ </p>
42
 
43
+ ![LumynaX: infusion release](https://img.shields.io/badge/LumynaX-infusion%20release-e08a2c) ![access: public and non-gated](https://img.shields.io/badge/access-public%20and%20non--gated-0a0a0b) ![runtime: llama cpp](https://img.shields.io/badge/runtime-llama%20cpp-726b62) ![format: GGUF](https://img.shields.io/badge/format-GGUF-9a5416) ![audit: pass](https://img.shields.io/badge/audit-pass-4d6b44) ![docs: v4](https://img.shields.io/badge/docs-v4-111827)
44
 
45
+ ## Executive Summary
46
 
47
+ This repository is a complete LumynaX release package for `AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf`. It is intended to be downloaded as a whole repo, not as a single loose weight file: the model artifact, `quickstart.py`, `requirements.txt`, `release_export_manifest.json`, `checksums.sha256`, license notice, and optional Ollama or Space files are part of the same release contract.
48
 
49
+ LumynaX-infused means the upstream artifact is presented through the LumynaX release layer: local-first runtime scaffolding, LumynaX assistant identity, inference-chain metadata, public documentation, integrity files, and Aotearoa New Zealand-oriented workflow positioning. The release manifest records this as a LumynaX packaging and inference-chain layer around the listed upstream artifact; it does not claim a private LumynaX weight merge.
50
 
51
+ ## AbteeX LumynaX Public Surface
 
 
 
 
 
 
 
 
 
 
 
 
 
52
 
53
+ This card follows the AbteeX/LumynaX public-facing system used across the release family: warm paper background visuals, black editorial typography, amber proof markers, compact evidence tables, and plain-language runtime instructions. The goal is not decoration; it is operational clarity. A downloader should immediately understand what the package is, what files belong together, what runtime path is expected, what provenance is available, and what limits still apply.
54
 
55
+ ## Sovereignty And Run Contract
 
 
 
 
 
 
56
 
57
+ | Field | Value |
58
+ | --- | --- |
59
+ | Public surface | AbteeX/LumynaX light editorial system: warm paper, black ink, amber status markers, and evidence-first tables. |
60
+ | Sovereign intent | Package is documented for local-first use, explicit provenance, and controlled deployment near governed data. |
61
+ | Runtime residency | `llama_cpp` runtime can be deployed by the user in their own approved environment. |
62
+ | Model artifact | `lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf` must stay with manifest, checksums, quickstart, requirements, and license files. |
63
+ | Modalities | `text` |
64
+ | License discipline | `apache-2.0` metadata is surfaced so downstream users can check redistribution and usage terms. |
65
+ | Audit expectation | Record repo id, artifact checksum, runtime command, prompt template, operator, and deployment environment for production use. |
66
+ | Router readiness | Compatible with the LumynaX MaramaRoute registry pattern for sovereign model selection and fallback planning. |
67
+ | Local serving | Preferred first path is llama.cpp or llama-cpp-python with checksum verification before launch. |
68
 
69
+ ## Quickstart
70
 
71
  ```bash
72
  hf download AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf --local-dir lumynax-infused-gemma4-26b-a4b-gguf
 
75
  python quickstart.py --interactive
76
  ```
77
 
78
+ Direct llama.cpp smoke command:
 
 
 
 
 
 
 
 
 
 
79
 
80
  ```bash
81
  llama-cli -m "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf" -p "Who are you? Answer as LumynaX in two sentences." -n 160
82
  ```
83
 
84
+ Ollama path:
85
 
86
  ```bash
87
  ollama create lumynax-infused-gemma4-26b-a4b-gguf -f ollama/Modelfile
88
  ollama run lumynax-infused-gemma4-26b-a4b-gguf
89
  ```
90
 
91
+ ## Model Profile
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
92
 
93
  | Field | Value |
94
  | --- | --- |
95
  | Release | `LumynaX Infused Gemma4 26B A4B GGUF` |
96
  | Repository | `AbteeXAILab/lumynax-infused-gemma4-26b-a4b-gguf` |
97
+ | Mode | `Sparse/frontier local package` |
 
 
 
 
 
 
 
 
 
98
  | Runtime | `llama_cpp` |
99
  | Prompt format | `gemma_chat_template` |
100
  | Modalities | `text` |
101
+ | Primary artifact | `lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf` |
102
+ | Detected weight size | `15.78 GB` |
103
+ | Package state | `prebuilt_gguf_release` |
104
+ | Delivery | `standalone_prebuilt_gguf_release` |
105
+ | Upstream/base | `google/gemma-4-26B-A4B-it` |
106
+ | Upstream kind | `official_base_weights` |
107
+ | Source GGUF | `unsloth/gemma-4-26B-A4B-it-GGUF` |
108
  | Quantization | `UD-Q4_K_M` |
109
+ | License metadata | `apache-2.0` |
110
+ | Refreshed | `2026-05-11` |
111
+ | Upstream license link | [license](https://huggingface.co/google/gemma-4-26B-A4B-it/blob/main/LICENSE) |
112
 
113
+ ## Runtime Path
 
 
 
 
 
 
 
 
 
 
 
114
 
115
+ <p align="center">
116
+ <img src="docs/lumynax-runtime-flow.svg" alt="LumynaX Infused Gemma4 26B A4B GGUF runtime flow" width="100%" />
117
+ </p>
118
 
119
+ ## Capability Profile
120
 
121
  | Field | Value |
122
  | --- | --- |
123
+ | Primary fit | Use this when you want a larger sparse or frontier-style model while keeping a local GGUF release shape. |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
124
  | Operational style | Local-first package with explicit files, checksums, and reproducible quickstarts. |
125
+ | Identity behavior | The assistant should identify as LumynaX while remaining clear about upstream provenance. |
126
 
127
+ ## Runtime Files
128
 
129
+ | Component | Status | Path |
130
+ | --- | --- | --- |
131
+ | README.md | `present` | `README.md` |
132
+ | Quickstart | `present` | `quickstart.py` |
133
+ | Requirements | `present` | `requirements.txt` |
134
+ | Manifest | `present` | `release_export_manifest.json` |
135
+ | Checksums | `present` | `checksums.sha256` |
136
+ | License | `present` | `LICENSE.txt` |
137
+ | Ollama | `present` | `ollama/Modelfile` |
138
+ | Space scaffold | `present` | `hf_space/app.py` |
139
+ | Overview visual | `present` | `docs/lumynax-release-overview.svg` |
140
+ | Runtime visual | `present` | `docs/lumynax-runtime-flow.svg` |
 
 
 
 
141
 
142
+ ## Model Artifacts
 
 
 
 
 
 
 
 
 
 
 
 
 
 
143
 
144
+ | Artifact | Size |
145
+ | --- | ---: |
146
+ | `lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf` | 15.78 GB |
147
 
148
+ ## Prompting Contract
149
 
150
+ The preferred first prompt is an identity and provenance check:
151
 
152
  ```text
153
  Who are you? What files do I need to keep together to run this package locally?
154
  ```
155
 
156
+ Expected behavior: the assistant should identify as LumynaX, explain that this is a LumynaX model-infusion package, and keep upstream provenance visible. The default package system prompt is:
 
 
157
 
158
  ```text
159
+ You are LumynaX operating from the LumynaX Infused Gemma4 26B A4B GGUF package identity. Be helpful, clear, and honest about provenance.
160
  ```
161
 
162
+ ## Validation Status
163
 
164
+ | Field | Value |
165
  | --- | --- |
166
+ | Runtime audit | `pass` |
167
+ | Public access audit | `public and non-gated` |
168
+ | Anonymous metadata access | `True` |
169
+ | Anonymous file listing | `True` |
170
+ | Quickstart syntax | `pass` |
171
+ | Manifest references | `pass` |
172
+ | Checksum references | `pass` |
173
 
174
+ The audit confirms public access, required release files, manifest references, checksum references, weight artifact presence, and quickstart syntax. It does not guarantee that every laptop has enough RAM or VRAM for the largest packages.
175
 
176
+ ## Integrity Checks
177
 
178
+ After download, compare the model artifact against `checksums.sha256`.
 
 
 
 
 
 
179
 
180
+ ```bash
181
+ sha256sum "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf"
182
+ cat checksums.sha256
183
+ ```
184
 
185
+ On Windows PowerShell:
186
 
187
+ ```powershell
188
+ Get-FileHash -Algorithm SHA256 "lumynax-infused-gemma4-26b-a4b-ud-q4_k_m.gguf"
189
+ Get-Content checksums.sha256
190
+ ```
 
 
191
 
192
+ ## Provenance And License
193
 
194
+ - Publisher: AbteeX AI Labs.
195
+ - Family: LumynaX model and inference-chain release family.
196
+ - Upstream/base: `google/gemma-4-26B-A4B-it`.
197
+ - Source GGUF: `unsloth/gemma-4-26B-A4B-it-GGUF`.
198
+ - License metadata: `apache-2.0`.
199
+ - License link: https://huggingface.co/google/gemma-4-26B-A4B-it/blob/main/LICENSE.
200
 
201
+ Respect the upstream model license and keep attribution files with redistributed copies. Do not present this package as privately trained or weight-merged unless the release manifest explicitly says that weight adaptation was applied.
202
 
203
+ ## Limitations And Responsible Use
204
 
205
+ - Outputs can be incorrect, incomplete, or biased; validate important answers before use.
206
+ - Larger GGUF, MoE, multimodal, and frontier packages may require substantial RAM, VRAM, disk space, and recent runtime builds.
207
+ - For high-impact decisions, use human review and domain-specific evaluation.
208
+ - For sensitive data, prefer local execution and keep operational logs under your own governance policy.
209
+ - This card documents package readiness and access; it is not a benchmark claim.
 
 
 
 
 
 
 
210
 
211
+ ## Automation Notes
212
 
213
  Automation should read these files before launching:
214
 
 
218
  - `requirements.txt`
219
  - `ollama/Modelfile` when present
220
 
221
+ ## Related LumynaX Demo
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
222
 
223
+ Try the public browser demo:
 
 
 
 
 
224
 
225
+ - https://huggingface.co/spaces/AbteeXAILab/lumynax-live-demo
checksums.sha256 CHANGED
@@ -1,6 +1,6 @@
1
  fdeb5cd638f262467f8cfa3f97d14d4071076dfbee5907ca4e3af7e50a3bd08b .gitattributes
2
  7e88e61bb6431de4d70a4a374997a5aaeeeb00ec89d44a625f9809a4bee20d0f LICENSE.txt
3
- d0df438fd1776c8d4326f0b5f75beac437ff6b1a46af4737aa7c7f25193f3464 README.md
4
  ea3bd28bb3c14339d88f612541750cbd8f0cd009fd94ed6a19c8d1c543a61dcd UPLOAD_TO_HF.md
5
  2dfede0e6610c473959c963b292fcec325452acba33fd1bba21110e04933df53 VERSION.txt
6
  1d99734002f8838a8ffeadd0f45ab982b47c4a1c256fca4a370f71df7885b03f artifacts/release_training_summary.json
 
1
  fdeb5cd638f262467f8cfa3f97d14d4071076dfbee5907ca4e3af7e50a3bd08b .gitattributes
2
  7e88e61bb6431de4d70a4a374997a5aaeeeb00ec89d44a625f9809a4bee20d0f LICENSE.txt
3
+ 2f9caace08fb69763b38605e6c2a79a56fd21c603a7cdfd1512581ff75e9ce6c README.md
4
  ea3bd28bb3c14339d88f612541750cbd8f0cd009fd94ed6a19c8d1c543a61dcd UPLOAD_TO_HF.md
5
  2dfede0e6610c473959c963b292fcec325452acba33fd1bba21110e04933df53 VERSION.txt
6
  1d99734002f8838a8ffeadd0f45ab982b47c4a1c256fca4a370f71df7885b03f artifacts/release_training_summary.json
docs/lumynax-runtime-flow.svg CHANGED