Text Generation
Transformers
PyTorch
English
Māori
m2m_100
text2text-generation
abteex-ai-labs
aotearoa
languages
local-first
lumynax
new-zealand
nllb
sovereign-ai
te-reo
translation
vllm
vllm-compatible
vllm-candidate
nvidia-nim
nim-compatible
nim-candidate
nvidia-nemo
nem
nvidia-nemo-compatible
nem-compatible
nemo-candidate
Instructions to use AbteeXAILab/lumynax-translate-nllb-200-3b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use AbteeXAILab/lumynax-translate-nllb-200-3b with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="AbteeXAILab/lumynax-translate-nllb-200-3b")# Load model directly from transformers import AutoTokenizer, AutoModelForMultimodalLM tokenizer = AutoTokenizer.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b") model = AutoModelForMultimodalLM.from_pretrained("AbteeXAILab/lumynax-translate-nllb-200-3b") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use AbteeXAILab/lumynax-translate-nllb-200-3b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "AbteeXAILab/lumynax-translate-nllb-200-3b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "AbteeXAILab/lumynax-translate-nllb-200-3b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/AbteeXAILab/lumynax-translate-nllb-200-3b
- SGLang
How to use AbteeXAILab/lumynax-translate-nllb-200-3b with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "AbteeXAILab/lumynax-translate-nllb-200-3b" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "AbteeXAILab/lumynax-translate-nllb-200-3b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "AbteeXAILab/lumynax-translate-nllb-200-3b" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "AbteeXAILab/lumynax-translate-nllb-200-3b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use AbteeXAILab/lumynax-translate-nllb-200-3b with Docker Model Runner:
docker model run hf.co/AbteeXAILab/lumynax-translate-nllb-200-3b
docs: publish professional LumynaX model card
Browse files- README.md +121 -283
- checksums.sha256 +9 -6
- docs/lumynax-release-overview.svg +51 -0
- docs/lumynax-runtime-flow.svg +35 -21
README.md
CHANGED
|
@@ -18,72 +18,54 @@ tags:
|
|
| 18 |
- translation
|
| 19 |
---
|
| 20 |
|
| 21 |
-
|
| 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>“Sovereign intelligence, held in the light.”</em><br/><em>Ko te mārama te tūāpapa — the light is the foundation.</em></p>
|
| 28 |
|
| 29 |
-
<
|
| 30 |
|
| 31 |
<p align="center">
|
| 32 |
-
<
|
| 33 |
-
<a href="#-runtime-architecture"><b>Architecture</b></a> ·
|
| 34 |
-
<a href="#-model-profile"><b>Profile</b></a> ·
|
| 35 |
-
<a href="#-capability-profile"><b>Capability</b></a> ·
|
| 36 |
-
<a href="#-provenance--license"><b>Provenance</b></a> ·
|
| 37 |
-
<a href="#-validation"><b>Validation</b></a> ·
|
| 38 |
-
<a href="#-companion-products"><b>Companions</b></a>
|
| 39 |
</p>
|
| 40 |
|
| 41 |
-
<p align="center">
|
| 42 |
-
|
| 43 |
-
|
| 44 |
-
|
| 45 |
-
---
|
| 46 |
|
| 47 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 48 |
|
| 49 |
-
|
| 50 |
|
| 51 |
-
|
| 52 |
|
| 53 |
-
|
| 54 |
|
| 55 |
-
|
| 56 |
|
| 57 |
-
|
| 58 |
|
| 59 |
-
|
| 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 |
-
|
| 75 |
|
| 76 |
-
|
|
| 77 |
-
| --- | --- |
|
| 78 |
-
|
|
| 79 |
-
|
|
| 80 |
-
|
|
| 81 |
-
|
|
| 82 |
-
|
|
| 83 |
-
|
| 84 |
-
|
|
|
|
| 85 |
|
| 86 |
-
|
| 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 |
-
|
| 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 |
-
|
| 103 |
-
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
**Verify integrity before launch:**
|
| 107 |
-
|
| 108 |
-
```bash
|
| 109 |
-
sha256sum "model.safetensors"
|
| 110 |
-
cat checksums.sha256
|
| 111 |
```
|
| 112 |
|
| 113 |
-
```
|
| 114 |
-
Get-FileHash -Algorithm SHA256 "model.safetensors"
|
| 115 |
-
Get-Content checksums.sha256
|
| 116 |
-
```
|
| 117 |
|
| 118 |
-
##
|
| 119 |
-
|
| 120 |
-
<table>
|
| 121 |
-
<tr><td>
|
| 122 |
-
|
| 123 |
-
**Release identity**
|
| 124 |
|
| 125 |
| Field | Value |
|
| 126 |
| --- | --- |
|
| 127 |
-
| Release | `
|
| 128 |
| Repository | `AbteeXAILab/lumynax-translate-nllb-200-3b` |
|
| 129 |
-
| Family | `nllb` |
|
| 130 |
| Mode | `Local-first text generation package` |
|
| 131 |
-
|
|
| 132 |
-
|
| 133 |
-
</td><td>
|
| 134 |
-
|
| 135 |
-
**Runtime profile**
|
| 136 |
-
|
| 137 |
-
| Field | Value |
|
| 138 |
-
| --- | --- |
|
| 139 |
-
| Runtime | `transformers` |
|
| 140 |
-
| Prompt format | `nllb` |
|
| 141 |
| Modalities | `text` |
|
| 142 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 143 |
| Quantization | `fp32 safetensors` |
|
|
|
|
|
|
|
| 144 |
|
| 145 |
-
|
| 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 |
-
<
|
|
|
|
|
|
|
| 159 |
|
| 160 |
-
|
| 161 |
|
| 162 |
| Field | Value |
|
| 163 |
| --- | --- |
|
| 164 |
-
|
|
| 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 |
-
##
|
| 190 |
-
|
| 191 |
-
> **Sovereignty is a design property, not a deployment option.**
|
| 192 |
|
| 193 |
-
|
|
| 194 |
-
| --- | --- |
|
| 195 |
-
|
|
| 196 |
-
|
|
| 197 |
-
|
|
| 198 |
-
|
|
| 199 |
-
|
|
| 200 |
-
|
|
| 201 |
-
|
|
| 202 |
-
|
|
| 203 |
-
|
|
| 204 |
-
|
|
| 205 |
-
|
| 206 |
-
## 📁 Runtime Files
|
| 207 |
|
| 208 |
-
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 225 |
|
| 226 |
-
##
|
| 227 |
|
| 228 |
-
|
| 229 |
|
| 230 |
```text
|
| 231 |
Who are you? What files do I need to keep together to run this package locally?
|
| 232 |
```
|
| 233 |
|
| 234 |
-
|
| 235 |
-
|
| 236 |
-
**Default system prompt:**
|
| 237 |
|
| 238 |
```text
|
| 239 |
-
|
| 240 |
```
|
| 241 |
|
| 242 |
-
##
|
| 243 |
|
| 244 |
-
|
|
| 245 |
| --- | --- |
|
| 246 |
-
| Runtime audit |
|
| 247 |
-
| Public access |
|
| 248 |
-
| Anonymous metadata access |
|
| 249 |
-
| Anonymous file listing |
|
| 250 |
-
| Quickstart syntax |
|
| 251 |
-
| Manifest references |
|
| 252 |
-
| Checksum references |
|
| 253 |
|
| 254 |
-
|
| 255 |
|
| 256 |
-
##
|
| 257 |
|
| 258 |
-
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
| 267 |
|
| 268 |
-
|
| 269 |
|
| 270 |
-
|
| 271 |
-
-
|
| 272 |
-
-
|
| 273 |
-
|
| 274 |
-
- This card documents **package readiness and access** — it is *not* a benchmark claim.
|
| 275 |
-
- The assistant must **not invent biographical or organisational claims** about named people without verified context.
|
| 276 |
|
| 277 |
-
##
|
| 278 |
|
| 279 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 280 |
|
| 281 |
-
|
| 282 |
|
| 283 |
-
##
|
| 284 |
|
| 285 |
-
|
| 286 |
-
|
| 287 |
-
|
| 288 |
-
|
| 289 |
-
|
| 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 — 50 models and counting.</p></td>
|
| 295 |
-
</tr>
|
| 296 |
-
</table>
|
| 297 |
|
| 298 |
-
##
|
| 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> · <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> ·
|
| 314 |
-
<a href="https://lumynax.com"><b>lumynax.com</b></a> ·
|
| 315 |
-
<a href="https://huggingface.co/AbteeXAILab"><b>huggingface.co/AbteeXAILab</b></a>
|
| 316 |
-
</p>
|
| 317 |
-
|
| 318 |
-
<p align="center"><sub>AbteeX AI Labs · Aotearoa New Zealand · 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 |
-
|
| 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 |
-
|
|
|
|
| 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 & 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 |
+
     
|
| 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 & 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
|
|
|
|