AbteeXAILabs commited on
Commit
cc82b99
·
verified ·
1 Parent(s): de8f5e0

feat: initial LumynaX scaffold (card v6 + quickstart + manifest + Modelfile + Space scaffold)

Browse files
LICENSE.txt ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ LumynaX release package — distribution scaffold
2
+
3
+ This Hugging Face repository contains the LumynaX release scaffold for the
4
+ upstream model identified in `release_export_manifest.json`. The model weights
5
+ themselves remain governed by the upstream licence at `metadata.upstream_repo`
6
+ and are fetched by the runtime via Hugging Face Hub when you execute
7
+ `quickstart.py`.
8
+
9
+ The scaffold (configs, manifest, quickstart, ollama Modelfile, Space app) is
10
+ released under the MIT licence by AbteeX AI Labs (Aotearoa New Zealand). Your
11
+ use of the *upstream weights* is governed by the *upstream licence*; this file
12
+ does not relicense them.
13
+
14
+ Provenance, residency and audit obligations are defined in
15
+ `release_export_manifest.json` and the model card.
README.md ADDED
@@ -0,0 +1,318 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: cc-by-nc-4.0
3
+ library_name: transformers
4
+ pipeline_tag: text-generation
5
+ language:
6
+ - en
7
+ - mi
8
+ tags:
9
+ - abteex-ai-labs
10
+ - aotearoa
11
+ - languages
12
+ - local-first
13
+ - lumynax
14
+ - new-zealand
15
+ - nllb
16
+ - sovereign-ai
17
+ - te-reo
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
90
+ cd lumynax-translate-nllb-200-3b
91
+ 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
+
302
+ - `release_export_manifest.json`
303
+ - `checksums.sha256`
304
+ - `quickstart.py`
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>
UPLOAD_TO_HF.md ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Upload checklist (AbteeX AI Labs)
2
+
3
+ This scaffold was generated and pushed by `S:\hf-publish\add_8_more_models.py`.
4
+ The repo is structured to be cloned whole and verified locally before running.
5
+
6
+ ```bash
7
+ hf download AbteeXAILab/lumynax-translate-nllb-200-3b --local-dir lumynax-translate-nllb-200-3b
8
+ cd lumynax-translate-nllb-200-3b
9
+ pip install -r requirements.txt
10
+ python quickstart.py --interactive
11
+ ```
12
+
13
+ To regenerate or refresh, re-run the script — `huggingface_hub.HfApi.upload_folder`
14
+ is idempotent.
VERSION.txt ADDED
@@ -0,0 +1 @@
 
 
1
+ v0.1.0
checksums.sha256 ADDED
@@ -0,0 +1,6 @@
 
 
 
 
 
 
 
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
docs/lumynax-capability.svg ADDED
docs/lumynax-overview.svg ADDED
docs/lumynax-runtime-flow.svg ADDED
hf_space/README.md ADDED
@@ -0,0 +1,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: LumynaX Translate NLLB-200 3.3B
3
+ colorFrom: yellow
4
+ colorTo: gray
5
+ sdk: gradio
6
+ sdk_version: 5.50.0
7
+ python_version: 3.11
8
+ app_file: app.py
9
+ pinned: false
10
+ license: apache-2.0
11
+ short_description: Scaffold Space for the lumynax-translate-nllb-200-3b LumynaX release.
12
+ tags:
13
+ - abteex-ai-labs
14
+ - lumynax
15
+ - sovereign-ai
16
+ - new-zealand
17
+ ---
18
+
19
+ # LumynaX Translate NLLB-200 3.3B
20
+
21
+ Scaffold Space for `AbteeXAILab/lumynax-translate-nllb-200-3b`. The actual model weights are too large to host on a free Space.
22
+ Clone the package repo and run `quickstart.py` locally for the real inference path.
hf_space/app.py ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import os
2
+ import gradio as gr
3
+
4
+ REPO_ID = "AbteeXAILab/lumynax-translate-nllb-200-3b"
5
+ UPSTREAM = "facebook/nllb-200-3.3B"
6
+ TITLE = "LumynaX Translate NLLB-200 3.3B"
7
+
8
+ THEME_CSS = """
9
+ :root { --lx-paper:#fffefa; --lx-ink:#0a0a0b; --lx-amber:#e08a2c; }
10
+ body, .gradio-container { background: var(--lx-paper) !important; color: var(--lx-ink) !important; }
11
+ h1, h2, h3 { font-family: 'Cormorant Garamond', 'EB Garamond', Georgia, serif; }
12
+ """
13
+
14
+ def chat_stub(message, history):
15
+ return (
16
+ f"This Space is a scaffold for **{TITLE}**. The upstream model is `{UPSTREAM}` "
17
+ f"and the LumynaX package repo is `{REPO_ID}`. Cloud inference for >100B MoE models "
18
+ f"is not run inside this free Space — clone the repo and run `quickstart.py` on a "
19
+ f"capable host. You asked: {message!r}."
20
+ )
21
+
22
+ with gr.Blocks(css=THEME_CSS, title=TITLE) as demo:
23
+ gr.Markdown(f"# {TITLE}\n*Sovereign intelligence, held in the light.*\n\nLumynaX release scaffold — clone `{REPO_ID}` for the full package.")
24
+ gr.ChatInterface(chat_stub, examples=["Explain LumynaX in 2 bullets.", "Why local-first AI for Aotearoa?"])
25
+
26
+ if __name__ == "__main__":
27
+ demo.launch()
hf_space/requirements.txt ADDED
@@ -0,0 +1 @@
 
 
1
+ gradio==5.50.0
ollama/Modelfile ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ # Upstream HF repo: facebook/nllb-200-3.3B
2
+ # Use 'ollama pull' on a converted GGUF mirror, or run via transformers (see quickstart.py).
3
+ FROM hf.co/facebook/nllb-200-3.3B
4
+
5
+ PARAMETER temperature 0.4
6
+ PARAMETER top_p 0.9
7
+ PARAMETER num_ctx 1024
8
+
9
+ SYSTEM """You are LumynaX, the AbteeX AI Labs assistant from Aotearoa New Zealand. Ko te marama te tuapapa. Answer with care; cite uncertainty; refuse unsafe asks."""
quickstart.py ADDED
@@ -0,0 +1,95 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ LumynaX Translate NLLB-200 3.3B — LumynaX quickstart.
3
+
4
+ This script fetches the upstream model from Hugging Face and runs a short
5
+ LumynaX-flavoured prompt. Run it on a host that satisfies the resource budget
6
+ documented in the README (LumynaX Translate NLLB-200 3.3B).
7
+
8
+ Usage:
9
+ python quickstart.py # one-shot demo prompt
10
+ python quickstart.py --interactive # REPL
11
+ python quickstart.py --gguf # use the GGUF mirror via llama-cpp
12
+
13
+ LumynaX package repo: https://huggingface.co/AbteeXAILab/lumynax-translate-nllb-200-3b
14
+ Upstream weights: https://huggingface.co/facebook/nllb-200-3.3B
15
+ """
16
+ from __future__ import annotations
17
+ import argparse, os, sys
18
+
19
+ LUMYNAX_SYSTEM = (
20
+ "You are LumynaX, the AbteeX AI Labs assistant from Aotearoa New Zealand. "
21
+ "Ko te marama te tuapapa - the light is the foundation. "
22
+ "Answer with care, cite uncertainty, and prefer local-first reasoning. "
23
+ "Refuse unsafe, unlawful, or sovereignty-violating requests."
24
+ )
25
+ DEMO_PROMPT = "Explain in 3 bullets why local-first AI matters for Aotearoa New Zealand."
26
+
27
+ def _run_hf(prompt: str, interactive: bool):
28
+ import torch
29
+ from transformers import AutoModelForCausalLM, AutoTokenizer
30
+ print("[lumynax] Loading facebook/nllb-200-3.3B. This is a >100B MoE — multi-GPU or accelerate offload recommended.")
31
+ tok = AutoTokenizer.from_pretrained("facebook/nllb-200-3.3B", trust_remote_code=True)
32
+ model = AutoModelForCausalLM.from_pretrained(
33
+ "facebook/nllb-200-3.3B", device_map="auto", torch_dtype="auto", trust_remote_code=True
34
+ )
35
+ def chat(user):
36
+ messages = [
37
+ {"role": "system", "content": LUMYNAX_SYSTEM},
38
+ {"role": "user", "content": user},
39
+ ]
40
+ text = tok.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
41
+ inputs = tok(text, return_tensors="pt").to(model.device)
42
+ out = model.generate(**inputs, max_new_tokens=512, do_sample=True, temperature=0.4)
43
+ return tok.decode(out[0, inputs["input_ids"].shape[-1]:], skip_special_tokens=True)
44
+ if interactive:
45
+ print("[lumynax] interactive mode — empty line exits.")
46
+ while True:
47
+ try: q = input("you> ").strip()
48
+ except EOFError: break
49
+ if not q: break
50
+ print("lumynax> " + chat(q))
51
+ else:
52
+ print(chat(prompt))
53
+
54
+
55
+ def _run_gguf(prompt: str, interactive: bool):
56
+ from llama_cpp import Llama
57
+ mirror = ""
58
+ if not mirror:
59
+ print("[lumynax] No community GGUF mirror registered for this build."); sys.exit(2)
60
+ print(f"[lumynax] Loading GGUF from {mirror}...")
61
+ llm = Llama.from_pretrained(
62
+ repo_id=mirror, filename="*Q4_K_M*.gguf",
63
+ n_ctx=1024,
64
+ n_gpu_layers=int(os.environ.get("N_GPU_LAYERS", "-1")), verbose=False,
65
+ )
66
+ def chat(user):
67
+ out = llm.create_chat_completion(messages=[
68
+ {"role": "system", "content": LUMYNAX_SYSTEM},
69
+ {"role": "user", "content": user},
70
+ ], max_tokens=512, temperature=0.4)
71
+ return out["choices"][0]["message"]["content"]
72
+ if interactive:
73
+ while True:
74
+ try: q = input("you> ").strip()
75
+ except EOFError: break
76
+ if not q: break
77
+ print("lumynax> " + chat(q))
78
+ else:
79
+ print(chat(prompt))
80
+
81
+
82
+ def main():
83
+ p = argparse.ArgumentParser()
84
+ p.add_argument("--interactive", action="store_true")
85
+ p.add_argument("--prompt", default=DEMO_PROMPT)
86
+ p.add_argument("--gguf", action="store_true")
87
+ args = p.parse_args()
88
+ if args.gguf:
89
+ _run_gguf(args.prompt, args.interactive)
90
+ else:
91
+ _run_hf(args.prompt, args.interactive)
92
+
93
+
94
+ if __name__ == "__main__":
95
+ main()
release_export_manifest.json ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "release_id": "lumynax-translate-nllb-200-3b",
3
+ "title": "LumynaX Translate NLLB-200 3.3B",
4
+ "repo_id": "AbteeXAILab/lumynax-translate-nllb-200-3b",
5
+ "version": "v0.1.0",
6
+ "publisher": "AbteeX AI Labs",
7
+ "publisher_org": "AbteeXAILab",
8
+ "jurisdiction": "NZ",
9
+ "residency": [
10
+ "NZ",
11
+ "AU",
12
+ "global"
13
+ ],
14
+ "upstream": {
15
+ "repo_id": "facebook/nllb-200-3.3B",
16
+ "license": "cc-by-nc-4.0",
17
+ "prompt_format": "nllb",
18
+ "source_note": "Meta NLLB-200"
19
+ },
20
+ "gguf_mirror": null,
21
+ "runtime": "transformers",
22
+ "modalities": [
23
+ "text"
24
+ ],
25
+ "context_tokens": 1024,
26
+ "total_params_b": 3.3,
27
+ "active_params_b": null,
28
+ "quantization": "fp32 safetensors",
29
+ "primary_artifact": "model.safetensors",
30
+ "package_state": "weights_mirrored",
31
+ "validation_status": "scaffold_verified",
32
+ "sovereignty_tier": 3,
33
+ "supports_tools": false,
34
+ "supports_json": false,
35
+ "audit_hash_chain": "SHA-256 over canonical request + response JSON",
36
+ "build_date_utc": "2026-05-17T01:21:42Z"
37
+ }
requirements.txt ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
 
1
+ huggingface_hub>=0.27
2
+ numpy
3
+ torch>=2.4
4
+ transformers>=4.50
5
+ accelerate>=1.0
6
+ safetensors
7
+ sentencepiece
8
+ einops