AbteeXAILabs commited on
Commit
10be1ab
·
verified ·
1 Parent(s): 41ae388

docs: publish professional LumynaX model card

Browse files
README.md CHANGED
@@ -18,72 +18,54 @@ tags:
18
  - translation
19
  ---
20
 
21
- <p align="center"><img src="docs/lumynax-overview.svg" alt="LumynaX Translate NLLB-200 3.3B release overview" width="100%" /></p>
22
-
23
- <!-- lumynax-public-release-card:v6 -->
24
-
25
- <h1 align="center">LumynaX Translate NLLB-200 3.3B</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: nllb" src="https://img.shields.io/badge/Family-nllb-9a5416?style=for-the-badge" /> <img alt="Runtime: transformers" src="https://img.shields.io/badge/Runtime-transformers-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: 3.3B" src="https://img.shields.io/badge/Params-3.3B-0a0a0b?style=for-the-badge" /> <img alt="Quant: fp32 safetensors" src="https://img.shields.io/badge/Quant-fp32%20safetensors-111827?style=for-the-badge" /> <img alt="Context: 1024%20tok" src="https://img.shields.io/badge/Context-1024%20tok-111827?style=for-the-badge" /> <img alt="License: cc-by-nc-4.0" src="https://img.shields.io/badge/License-cc--by--nc--4.0-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>4/5</b></kbd> &middot; <kbd>Lightweight: <b>3/5</b></kbd> &middot; <kbd>Sovereignty: <b>3/5</b></kbd> &middot; <kbd>Tools: <b>no</b></kbd> &middot; <kbd>JSON: <b>no</b></kbd> &middot; <kbd>Context: <b>1024 tok</b></kbd></p>
44
-
45
- ---
46
 
47
- ## 📦 Executive Summary
 
 
 
 
 
 
 
48
 
49
- > `AbteeXAILab/lumynax-translate-nllb-200-3b` 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-translate-nllb-200-3b --local-dir lumynax-translate-nllb-200-3b
@@ -92,210 +74,143 @@ pip install -r requirements.txt
92
  python quickstart.py --interactive
93
  ```
94
 
95
- **Python:**
96
 
97
  ```python
98
  from transformers import AutoTokenizer, AutoModelForCausalLM
99
 
100
  tokenizer = AutoTokenizer.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b", trust_remote_code=True)
101
  model = AutoModelForCausalLM.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b", device_map="auto", trust_remote_code=True)
102
- inputs = tokenizer("Who are you? Answer as LumynaX in two sentences.", return_tensors="pt").to(model.device)
103
- print(tokenizer.decode(model.generate(**inputs, max_new_tokens=160)[0], skip_special_tokens=True))
104
- ```
105
-
106
- **Verify integrity before launch:**
107
-
108
- ```bash
109
- sha256sum "model.safetensors"
110
- cat checksums.sha256
111
  ```
112
 
113
- ```powershell
114
- Get-FileHash -Algorithm SHA256 "model.safetensors"
115
- Get-Content checksums.sha256
116
- ```
117
 
118
- ## 📐 Model Profile
119
-
120
- <table>
121
- <tr><td>
122
-
123
- **Release identity**
124
 
125
  | Field | Value |
126
  | --- | --- |
127
- | Release | `LumynaX Translate NLLB-200 3.3B` |
128
  | Repository | `AbteeXAILab/lumynax-translate-nllb-200-3b` |
129
- | Family | `nllb` |
130
  | Mode | `Local-first text generation package` |
131
- | Card schema | `lumynax-public-release-card:v6` |
132
-
133
- </td><td>
134
-
135
- **Runtime profile**
136
-
137
- | Field | Value |
138
- | --- | --- |
139
- | Runtime | `transformers` |
140
- | Prompt format | `nllb` |
141
  | Modalities | `text` |
142
- | Context window | `1024` tokens |
 
 
 
 
 
 
143
  | Quantization | `fp32 safetensors` |
 
 
144
 
145
- </td></tr>
146
- <tr><td>
147
-
148
- **Artifact**
149
-
150
- | Field | Value |
151
- | --- | --- |
152
- | Primary | `model.safetensors` |
153
- | Weight size | `—` |
154
- | Parameters | `3.3B` |
155
- | Quality rank | `2` (1 best) |
156
- | Cost rank | `3` (1 cheapest) |
157
 
158
- </td><td>
 
 
159
 
160
- **Provenance**
161
 
162
  | Field | Value |
163
  | --- | --- |
164
- | Upstream / base | `facebook/nllb-200-3.3B` |
165
- | Source | `Meta NLLB-200` |
166
- | License | `cc-by-nc-4.0` |
167
- | Sovereignty tier | `3` of 5 |
168
- | Audit | `pass` |
169
-
170
- </td></tr>
171
- </table>
172
-
173
- ## 📊 Capability Profile
174
-
175
- <p align="center"><img src="docs/lumynax-capability.svg" alt="Capability profile bars" width="100%" /></p>
176
-
177
- > **Primary fit.** Conversational assistance near governed data, with provenance visible and human review on high-impact tasks.
178
-
179
- | Signal | Reading |
180
- | --- | --- |
181
- | Quality rank | `2` (1 = strongest in family) |
182
- | Cost rank | `3` (1 = lightest weight) |
183
- | Sovereignty tier | `3` of 5 |
184
- | Tool calling | ❌ not supported |
185
- | JSON mode | ❌ not supported |
186
- | Identity behaviour | Identifies as LumynaX while keeping upstream provenance visible. |
187
  | Operational style | Local-first package with explicit files, checksums, and reproducible quickstarts. |
 
188
 
189
- ## 🛡️ Sovereignty Contract
190
-
191
- > **Sovereignty is a design property, not a deployment option.**
192
 
193
- | Field | Value |
194
- | --- | --- |
195
- | Publisher | AbteeX AI Labs |
196
- | Family | LumynaX sovereign release family |
197
- | Sovereign intent | Local-first deployment near governed data, with explicit provenance and controlled human review. |
198
- | Sovereignty tier | `3` of 5 |
199
- | Runtime residency | `transformers` can be deployed inside an operator-approved environment. |
200
- | Primary artifact | `model.safetensors` &mdash; ships alongside manifest, checksums, quickstart, requirements, and license files. |
201
- | License discipline | Surface upstream license metadata so downstream users can verify redistribution and usage terms. |
202
- | Audit expectation | Record repo id, artifact checksum, runtime command, prompt template, operator, deployment environment. |
203
- | Router readiness | First-class with [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route). |
204
- | Policy readiness | First-class with [AbteeX SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode). |
205
-
206
- ## 📁 Runtime Files
207
 
208
- ```text
209
- lumynax-translate-nllb-200-3b/
210
- ├── README.md # this card
211
- ├── quickstart.py # smoke runner
212
- ├── requirements.txt # pinned deps
213
- ├── release_export_manifest.json # full release metadata
214
- ├── checksums.sha256 # integrity verification
215
- ├── LICENSE.txt # license notice
216
- ├── ollama/Modelfile # optional Ollama runtime
217
- ├── hf_space/app.py # optional Space scaffold
218
- ├── docs/lumynax-overview.svg # release banner
219
- ├── docs/lumynax-runtime-flow.svg # runtime architecture
220
- ├── docs/lumynax-capability.svg # capability profile
221
- └── model.safetensors # primary artifact
222
- ```
223
 
224
- ⚠️ **Keep the full set together.** Removing the manifest, checksums, or license file breaks the release contract.
 
 
 
 
225
 
226
- ## 💬 Prompting Contract
227
 
228
- **Preferred opening prompt:**
229
 
230
  ```text
231
  Who are you? What files do I need to keep together to run this package locally?
232
  ```
233
 
234
- > **Expected behaviour.** The assistant identifies as LumynaX, explains that this is a LumynaX model-infusion release, and keeps upstream provenance visible.
235
-
236
- **Default system prompt:**
237
 
238
  ```text
239
- You are LumynaX operating from the LumynaX Translate NLLB-200 3.3B 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.
240
  ```
241
 
242
- ## Validation
243
 
244
- | Check | Result |
245
  | --- | --- |
246
- | Runtime audit | `pass` |
247
- | Public access | `public and non-gated` |
248
- | Anonymous metadata access | `true` |
249
- | Anonymous file listing | `true` |
250
- | Quickstart syntax | `pass` |
251
- | Manifest references | `pass` |
252
- | Checksum references | `pass` |
253
 
254
- > 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.
255
 
256
- ## 🔗 Provenance & License
257
 
258
- | Field | Value |
259
- | --- | --- |
260
- | **Publisher** | AbteeX AI Labs |
261
- | **Family** | LumynaX model and inference-chain release family |
262
- | **Upstream / base** | `facebook/nllb-200-3.3B` |
263
- | **Source** | `Meta NLLB-200` |
264
- | **License metadata** | `cc-by-nc-4.0` |
265
 
266
- > **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.
 
 
 
267
 
268
- ## ⚠️ Limitations & Responsible Use
269
 
270
- - Outputs can be **incorrect, incomplete, or biased**; validate important answers before use.
271
- - Larger GGUF, MoE, multimodal, and frontier packages may require **substantial RAM, VRAM, disk space, and recent runtime builds**.
272
- - For high-impact decisions, use **human review** and domain-specific evaluation.
273
- - For sensitive data, prefer **local execution** and keep operational logs under your own governance policy.
274
- - This card documents **package readiness and access** &mdash; it is *not* a benchmark claim.
275
- - The assistant must **not invent biographical or organisational claims** about named people without verified context.
276
 
277
- ## 🌿 Aotearoa Kaupapa
278
 
279
- > 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.
 
 
 
 
 
280
 
281
- > *Ko te mārama te tūāpapa* &mdash; the light is the foundation.
282
 
283
- ## 🤝 Companion Products
284
 
285
- <table>
286
- <tr>
287
- <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>
288
- <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>
289
- <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>
290
- </tr>
291
- <tr>
292
- <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>
293
- <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>
294
- <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>
295
- </tr>
296
- </table>
297
 
298
- ## 🤖 Automation Notes
299
 
300
  Automation should read these files before launching:
301
 
@@ -305,85 +220,8 @@ Automation should read these files before launching:
305
  - `requirements.txt`
306
  - `ollama/Modelfile` when present
307
 
308
- ---
309
-
310
- <p align="center"><em><b>Local roots, global work.</b> &middot; <b>Sovereignty is a design property, not a deployment option.</b></em></p>
311
-
312
- <p align="center">
313
- <a href="https://abteex.com"><b>abteex.com</b></a> &middot;
314
- <a href="https://lumynax.com"><b>lumynax.com</b></a> &middot;
315
- <a href="https://huggingface.co/AbteeXAILab"><b>huggingface.co/AbteeXAILab</b></a>
316
- </p>
317
-
318
- <p align="center"><sub>AbteeX AI Labs &middot; Aotearoa New Zealand &middot; LumynaX release card v6</sub></p>
319
-
320
- ---
321
-
322
- ## 🚀 Quickest start — the `lumynax` CLI
323
-
324
- ```bash
325
- pip install lumynax
326
- lumynax run nllb
327
- ```
328
-
329
- `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:
330
-
331
- ```bash
332
- lumynax run nllb "your prompt here"
333
- lumynax pull nllb # just download
334
- lumynax info nllb # full card
335
- lumynax serve nllb # OpenAI-compatible API on :8080
336
- ```
337
-
338
- Or via the legacy hf-download + quickstart.py path:
339
-
340
- ```bash
341
- hf download AbteeXAILab/lumynax-translate-nllb-200-3b --local-dir lumynax-translate-nllb-200-3b
342
- cd lumynax-translate-nllb-200-3b && pip install -r requirements.txt && python quickstart.py --interactive
343
- ```
344
-
345
-
346
- ---
347
-
348
- ## 🇳🇿 Made in Aotearoa New Zealand
349
-
350
- 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.
351
-
352
- > *Ko te mārama te tūāpapa — the light is the foundation.*
353
-
354
- | Resource | Link |
355
- | --- | --- |
356
- | 🏠 AbteeX AI Labs | [abteex.com](https://abteex.com) |
357
- | 🌟 LumynaX family | [lumynax.com](https://lumynax.com) |
358
- | 🤗 Hugging Face org | [huggingface.co/AbteeXAILab](https://huggingface.co/AbteeXAILab) |
359
- | 🐙 Monorepo | [github.com/Aimaghsoodi/lumynax-release](https://github.com/Aimaghsoodi/lumynax-release) |
360
- | 📦 Per-model GitHub | [github.com/aimaghsoodi/lumynax-translate-nllb-200-3b](https://github.com/aimaghsoodi/lumynax-translate-nllb-200-3b) |
361
- | 🧭 Routing | `lumynax route "<your prompt>" --local` (via [`lumynax` CLI](https://github.com/Aimaghsoodi/lumynax-release/tree/main/tools/lumynax-cli)) |
362
- | 🛡️ Policy + audit | [SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode) + [MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route) |
363
- | 🔌 Run via OpenAI-compatible gateway | See [`DEPLOYMENT.md`](https://github.com/Aimaghsoodi/lumynax-release/blob/main/DEPLOYMENT.md) |
364
-
365
- ### Run this model
366
-
367
- ```bash
368
- # Fastest — clone & run
369
- hf download AbteeXAILab/lumynax-translate-nllb-200-3b --local-dir lumynax-translate-nllb-200-3b
370
- cd lumynax-translate-nllb-200-3b && pip install -r requirements.txt && python quickstart.py --interactive
371
-
372
- # Or via the LumynaX CLI
373
- pip install lumynax
374
- lumynax run lumynax-translate-nllb-200-3b -i
375
-
376
- # Or as an OpenAI-compatible server (for OpenCode, Continue, Cursor, vLLM, LM Studio, etc.)
377
- lumynax serve lumynax-translate-nllb-200-3b --port 8080
378
- ```
379
-
380
- ### Sovereignty contract
381
 
382
- - **Residency:** NZ, AU, global
383
- - **Sovereignty tier:** 3 *(1 = remote frontier · 3 = local-runnable · 5 = NZ-resident only)*
384
- - **Jurisdiction:** NZ
385
- - **License:** cc-by-nc-4.0 *(upstream weights retain upstream licence)*
386
- - **Audit:** SHA-256 hash-chained ledger via SovereignCode
387
- - **Routing:** Considered by MaramaRoute when matching task to model
388
 
389
- *Brought to you by Aotearoa New Zealand — sovereign AI, held in the light.*
 
18
  - translation
19
  ---
20
 
21
+ # Fastest clone & run
 
 
 
 
 
 
22
 
23
+ <!-- lumynax-public-release-card:v4 -->
24
 
25
  <p align="center">
26
+ <img src="docs/lumynax-release-overview.svg" alt="Fastest — clone &amp; run 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: not recorded](https://img.shields.io/badge/access-not%20recorded-0a0a0b) ![runtime: see quickstart.py](https://img.shields.io/badge/runtime-see%20quickstart.py-726b62) ![format: HF weights](https://img.shields.io/badge/format-HF%20weights-9a5416) ![audit: not recorded](https://img.shields.io/badge/audit-not%20recorded-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-translate-nllb-200-3b`. 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 is the source of truth for whether this package is upstream-weight packaging, a dense LumynaX release, or another release mode.
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 | `see quickstart.py` runtime can be deployed by the user in their own approved environment. |
62
+ | Model artifact | `pytorch_model-00002-of-00003.bin` must stay with manifest, checksums, quickstart, requirements, and license files. |
63
+ | Modalities | `text` |
64
+ | License discipline | `cc-by-nc-4.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
 
68
+ ## Quickstart
69
 
70
  ```bash
71
  hf download AbteeXAILab/lumynax-translate-nllb-200-3b --local-dir lumynax-translate-nllb-200-3b
 
74
  python quickstart.py --interactive
75
  ```
76
 
77
+ Transformers first-load pattern:
78
 
79
  ```python
80
  from transformers import AutoTokenizer, AutoModelForCausalLM
81
 
82
  tokenizer = AutoTokenizer.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b", trust_remote_code=True)
83
  model = AutoModelForCausalLM.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b", device_map="auto", trust_remote_code=True)
84
+ prompt = "Who are you? Answer as LumynaX in two sentences."
85
+ inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
86
+ output = model.generate(**inputs, max_new_tokens=160)
87
+ print(tokenizer.decode(output[0], skip_special_tokens=True))
 
 
 
 
 
88
  ```
89
 
90
+ For multimodal Transformers packages, use the package `quickstart.py` or upstream processor class when `AutoModelForCausalLM` is not the correct loader.
 
 
 
91
 
92
+ ## Model Profile
 
 
 
 
 
93
 
94
  | Field | Value |
95
  | --- | --- |
96
+ | Release | `Fastest clone & run` |
97
  | Repository | `AbteeXAILab/lumynax-translate-nllb-200-3b` |
 
98
  | Mode | `Local-first text generation package` |
99
+ | Runtime | `see quickstart.py` |
100
+ | Prompt format | `See quickstart.py` |
 
 
 
 
 
 
 
 
101
  | Modalities | `text` |
102
+ | Primary artifact | `pytorch_model-00002-of-00003.bin` |
103
+ | Detected weight size | `16.37 GB` |
104
+ | Package state | `weights_mirrored` |
105
+ | Delivery | `published_model_repo` |
106
+ | Upstream/base | `See release_export_manifest.json` |
107
+ | Upstream kind | `See manifest` |
108
+ | Source GGUF | `not applicable` |
109
  | Quantization | `fp32 safetensors` |
110
+ | License metadata | `cc-by-nc-4.0` |
111
+ | Refreshed | `2026-05-11` |
112
 
113
+ ## Runtime Path
 
 
 
 
 
 
 
 
 
 
 
114
 
115
+ <p align="center">
116
+ <img src="docs/lumynax-runtime-flow.svg" alt="Fastest — clone &amp; run runtime flow" width="100%" />
117
+ </p>
118
 
119
+ ## Capability Profile
120
 
121
  | Field | Value |
122
  | --- | --- |
123
+ | Primary fit | Use this for local chat, drafting, summarization, governance notes, and repeatable offline-friendly inference. |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
+ | `pytorch_model-00002-of-00003.bin` | 7.96 GB |
147
+ | `pytorch_model-00001-of-00003.bin` | 6.46 GB |
148
+ | `pytorch_model-00003-of-00003.bin` | 1.95 GB |
149
 
150
+ ## Prompting Contract
151
 
152
+ The preferred first prompt is an identity and provenance check:
153
 
154
  ```text
155
  Who are you? What files do I need to keep together to run this package locally?
156
  ```
157
 
158
+ 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:
 
 
159
 
160
  ```text
161
+ See quickstart.py
162
  ```
163
 
164
+ ## Validation Status
165
 
166
+ | Field | Value |
167
  | --- | --- |
168
+ | Runtime audit | `not recorded` |
169
+ | Public access audit | `not recorded` |
170
+ | Anonymous metadata access | `False` |
171
+ | Anonymous file listing | `False` |
172
+ | Quickstart syntax | `not recorded` |
173
+ | Manifest references | `pass` |
174
+ | Checksum references | `pass` |
175
 
176
+ 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.
177
 
178
+ ## Integrity Checks
179
 
180
+ After download, compare the model artifact against `checksums.sha256`.
 
 
 
 
 
 
181
 
182
+ ```bash
183
+ sha256sum "pytorch_model-00002-of-00003.bin"
184
+ cat checksums.sha256
185
+ ```
186
 
187
+ On Windows PowerShell:
188
 
189
+ ```powershell
190
+ Get-FileHash -Algorithm SHA256 "pytorch_model-00002-of-00003.bin"
191
+ Get-Content checksums.sha256
192
+ ```
 
 
193
 
194
+ ## Provenance And License
195
 
196
+ - Publisher: AbteeX AI Labs.
197
+ - Family: LumynaX model and inference-chain release family.
198
+ - Upstream/base: `See release_export_manifest.json`.
199
+ - Source GGUF: `not applicable`.
200
+ - License metadata: `cc-by-nc-4.0`.
201
+ - License link: `LICENSE.txt` and upstream model card.
202
 
203
+ 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.
204
 
205
+ ## Limitations And Responsible Use
206
 
207
+ - Outputs can be incorrect, incomplete, or biased; validate important answers before use.
208
+ - Larger GGUF, MoE, multimodal, and frontier packages may require substantial RAM, VRAM, disk space, and recent runtime builds.
209
+ - For high-impact decisions, use human review and domain-specific evaluation.
210
+ - For sensitive data, prefer local execution and keep operational logs under your own governance policy.
211
+ - This card documents package readiness and access; it is not a benchmark claim.
 
 
 
 
 
 
 
212
 
213
+ ## Automation Notes
214
 
215
  Automation should read these files before launching:
216
 
 
220
  - `requirements.txt`
221
  - `ollama/Modelfile` when present
222
 
223
+ ## Related LumynaX Demo
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
224
 
225
+ Try the public browser demo:
 
 
 
 
 
226
 
227
+ - https://huggingface.co/spaces/AbteeXAILab/lumynax-live-demo
checksums.sha256 CHANGED
@@ -1,6 +1,9 @@
1
- 601956b52f7e59484c150ec4b1e9b1186adc331bf92c4a7127834ba2ff70a968 LICENSE.txt
2
- d0b4f9120ba026c00fa23cb84b4e1620a2e6436592e58155a5151653179572c0 VERSION.txt
3
- 617636e393c88b6aaf6869276149e1f917a376bb4480e87d88351b2e93537c31 ollama/Modelfile
4
- b78bf971207a51c9d6cbeeddd5dec67f3e64007b5561bea060fa1ba7747c0c66 quickstart.py
5
- a35821bafbf1296fcbafd281abec6780b493d9957525ec81e877c1f9f87f1502 release_export_manifest.json
6
- dd873da1e34bee536b535b05ffe41bbeeacaa9d106db9463ae0f4abe2f07dff8 requirements.txt
 
 
 
 
1
+ 601956b52f7e59484c150ec4b1e9b1186adc331bf92c4a7127834ba2ff70a968 LICENSE.txt
2
+ d0b4f9120ba026c00fa23cb84b4e1620a2e6436592e58155a5151653179572c0 VERSION.txt
3
+ 617636e393c88b6aaf6869276149e1f917a376bb4480e87d88351b2e93537c31 ollama/Modelfile
4
+ b78bf971207a51c9d6cbeeddd5dec67f3e64007b5561bea060fa1ba7747c0c66 quickstart.py
5
+ a35821bafbf1296fcbafd281abec6780b493d9957525ec81e877c1f9f87f1502 release_export_manifest.json
6
+ dd873da1e34bee536b535b05ffe41bbeeacaa9d106db9463ae0f4abe2f07dff8 requirements.txt
7
+ fdf9be58dfce40c930e7a5e5f5f79c15d2431e66129748cdee049845e456fec4 README.md
8
+ 89026f17ada41f0bd89a55a3a4db378ce2d79d3e2432b7a744fb074c10f8a3e8 docs/lumynax-release-overview.svg
9
+ 9c85c83b36f22c6e2bd9939d6e09db1834babf069153fd881af7be9f24c2636b docs/lumynax-runtime-flow.svg
docs/lumynax-release-overview.svg ADDED
docs/lumynax-runtime-flow.svg CHANGED