Instructions to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with llama-cpp-python:

# !pip install llama-cpp-python

from llama_cpp import Llama

llm = Llama.from_pretrained(
	repo_id="AbteeXAILab/lumynax-infused-smollm2-360m-gguf",
	filename="smollm2-360m-instruct-q8_0.gguf",
)

llm.create_chat_completion(
	messages = [
		{
			"role": "user",
			"content": "What is the capital of France?"
		}
	]
)

Notebooks
Google Colab
Kaggle
Local Apps Settings

llama.cpp

How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with llama.cpp:

Install from brew

brew install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
# Run inference directly in the terminal:
llama-cli -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
# Run inference directly in the terminal:
llama-cli -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Use pre-built binary

# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases
# Start a local OpenAI-compatible server with a web UI:
./llama-server -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
# Run inference directly in the terminal:
./llama-cli -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Build from source code

git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
# Run inference directly in the terminal:
./build/bin/llama-cli -hf AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Use Docker

docker model run hf.co/AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

LM Studio
Jan

vLLM

How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "AbteeXAILab/lumynax-infused-smollm2-360m-gguf"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "AbteeXAILab/lumynax-infused-smollm2-360m-gguf",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Ollama
How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with Ollama:
```
ollama run hf.co/AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
```

Unsloth Studio

How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with Unsloth Studio:

Install Unsloth Studio (macOS, Linux, WSL)

curl -fsSL https://unsloth.ai/install.sh | sh
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for AbteeXAILab/lumynax-infused-smollm2-360m-gguf to start chatting

Install Unsloth Studio (Windows)

irm https://unsloth.ai/install.ps1 | iex
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for AbteeXAILab/lumynax-infused-smollm2-360m-gguf to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for AbteeXAILab/lumynax-infused-smollm2-360m-gguf to start chatting

Atomic Chat new
Docker Model Runner
How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with Docker Model Runner:
```
docker model run hf.co/AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0
```

Lemonade

How to use AbteeXAILab/lumynax-infused-smollm2-360m-gguf with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull AbteeXAILab/lumynax-infused-smollm2-360m-gguf:Q8_0

Run and chat with the model

lemonade run user.lumynax-infused-smollm2-360m-gguf-Q8_0

List all available models

lemonade list

AbteeXAILabs commited on 25 days ago

Commit

0672ee4

verified ·

1 Parent(s): 4422f97

docs: add NZ/AbteeX/LumynaX branding block

Browse files

Files changed (1) hide show

README.md +375 -330

README.md CHANGED Viewed

@@ -1,330 +1,375 @@
----
-license: apache-2.0
-library_name: llama.cpp
-pipeline_tag: text-generation
-language:
-- en
-- mi
-tags:
-- abteex-ai-labs
-- aotearoa
-- general
-- gguf
-- local-first
-- lumynax
-- new-zealand
-- smollm
-- sovereign-ai
-- text
----
-<p align="center"><img src="docs/lumynax-overview.svg" alt="LumynaX Infused SmolLM2 360M Instruct GGUF release overview" width="100%" /></p>
-<!-- lumynax-public-release-card:v6 -->
-<h1 align="center">LumynaX Infused SmolLM2 360M Instruct GGUF</h1>
-<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>
-<p align="center"><strong>A LumynaX release from AbteeX AI Labs &mdash; Aotearoa New Zealand.</strong></p>
-<p align="center">
-  <a href="#-quickstart"><b>Quickstart</b></a> &middot;
-  <a href="#-runtime-architecture"><b>Architecture</b></a> &middot;
-  <a href="#-model-profile"><b>Profile</b></a> &middot;
-  <a href="#-capability-profile"><b>Capability</b></a> &middot;
-  <a href="#-provenance--license"><b>Provenance</b></a> &middot;
-  <a href="#-validation"><b>Validation</b></a> &middot;
-  <a href="#-companion-products"><b>Companions</b></a>
-</p>
-<p align="center"><img alt="LumynaX: release" src="https://img.shields.io/badge/LumynaX-release-e08a2c?style=for-the-badge" />  <img alt="Family: smollm" src="https://img.shields.io/badge/Family-smollm-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: see%20manifest" src="https://img.shields.io/badge/Params-see%20manifest-0a0a0b?style=for-the-badge" />  <img alt="Quant: Q8_0" src="https://img.shields.io/badge/Quant-Q8__0-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: apache-2.0" src="https://img.shields.io/badge/License-apache--2.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>
-<p align="center"><kbd>Quality: <b>1/5</b></kbd> &middot; <kbd>Lightweight: <b>4/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>
----
-## 📦 Executive Summary
-> `AbteeXAILab/lumynax-infused-smollm2-360m-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.
-> **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.
-## 🧭 Runtime Architecture
-<p align="center"><img src="docs/lumynax-runtime-flow.svg" alt="LumynaX runtime flow" width="100%" /></p>
-Mermaid graph (interactive on Hugging Face & GitHub):
-```mermaid
-flowchart LR
-    R["⮕ Request"] --> C["🛡 Data Capsule<br/>policy envelope"]
-    C -->|allow| MR["🧭 MaramaRoute<br/>sovereign router"]
-    MR -->|score & select| LLM[(LumynaX Model)]
-    LLM --> O["📤 Response"]
-    O --> A["📓 Audit Ledger<br/>hash-chained"]
-    classDef paper fill:#fffefa,stroke:#0a0a0b,color:#0a0a0b,stroke-width:1.4px;
-    classDef accent fill:#e08a2c,stroke:#9a5416,color:#0a0a0b,stroke-width:1.4px;
-    classDef ink fill:#0a0a0b,stroke:#0a0a0b,color:#fffefa,stroke-width:1.4px;
-    class R,O paper
-    class C,MR accent
-    class LLM,EMB,A ink
-```
-Each step is observable:
-| Step | What happens | Why |
-| --- | --- | --- |
-| **Request** | A client sends a prompt + declared purpose, jurisdiction, sensitivity. | Intent must be declared, not inferred. |
-| **Data Capsule** | A policy envelope describes what can / cannot happen to the data. | Sovereignty is enforced at the data, not the wire. |
-| **MaramaRoute** | The sovereign router scores candidates by jurisdiction, runtime, modality, task fit. | Right model for the work, not the loudest. |
-| **LumynaX Model** | This package serves the inference, local-first by default. | Sensitive context never leaves the operator&rsquo;s environment. |
-| **Audit Ledger** | A hash-chained record persists capsule, decision, request hash, obligations. | Tamper-evident provenance for the whole trace. |
-## ⚡ Quickstart
-**Clone the whole release** — every file matters, the package is a contract:
-```bash
-hf download AbteeXAILab/lumynax-infused-smollm2-360m-gguf --local-dir lumynax-infused-smollm2-360m-gguf
-cd lumynax-infused-smollm2-360m-gguf
-pip install -r requirements.txt
-python quickstart.py --interactive
-```
-**Python:**
-```python
-from llama_cpp import Llama
-llm = Llama(model_path="smollm2-360m-instruct-q8_0.gguf", n_ctx=8192, n_threads=8, verbose=False)
-out = llm("Who are you? Answer as LumynaX in two sentences.", max_tokens=160)
-print(out["choices"][0]["text"].strip())
-```
-**CLI smoke test:**
-```bash
-llama-cli -m "smollm2-360m-instruct-q8_0.gguf" -p "Who are you? Answer as LumynaX in two sentences." -n 160
-```
-**Ollama path:**
-```bash
-ollama create lumynax-infused-smollm2-360m-gguf -f ollama/Modelfile
-ollama run lumynax-infused-smollm2-360m-gguf
-```
-**Verify integrity before launch:**
-```bash
-sha256sum "smollm2-360m-instruct-q8_0.gguf"
-cat checksums.sha256
-```
-```powershell
-Get-FileHash -Algorithm SHA256 "smollm2-360m-instruct-q8_0.gguf"
-Get-Content checksums.sha256
-```
-## 📐 Model Profile
-<table>
-<tr><td>
-**Release identity**
-| Field | Value |
-| --- | --- |
-| Release | `LumynaX Infused SmolLM2 360M Instruct GGUF` |
-| Repository | `AbteeXAILab/lumynax-infused-smollm2-360m-gguf` |
-| Family | `smollm` |
-| Mode | `Local-first text generation package` |
-| Card schema | `lumynax-public-release-card:v6` |
-</td><td>
-**Runtime profile**
-| Field | Value |
-| --- | --- |
-| Runtime | `llama_cpp` |
-| Prompt format | `chatml` |
-| Modalities | `text` |
-| Context window | `8192` tokens |
-| Quantization | `Q8_0` |
-</td></tr>
-<tr><td>
-**Artifact**
-| Field | Value |
-| --- | --- |
-| Primary | `smollm2-360m-instruct-q8_0.gguf` |
-| Weight size | `368.50 MB` |
-| Parameters | `see manifest` |
-| Quality rank | `5` (1 best) |
-| Cost rank | `2` (1 cheapest) |
-</td><td>
-**Provenance**
-| Field | Value |
-| --- | --- |
-| Upstream / base | `HuggingFaceTB/SmolLM2-360M-Instruct` |
-| Source | `HuggingFaceTB/SmolLM2-360M-Instruct-GGUF` |
-| License | `apache-2.0` |
-| Sovereignty tier | `3` of 5 |
-| Audit | `pass` |
-</td></tr>
-</table>
-## 📊 Capability Profile
-<p align="center"><img src="docs/lumynax-capability.svg" alt="Capability profile bars" width="100%" /></p>
-> **Primary fit.** Conversational assistance near governed data, with provenance visible and human review on high-impact tasks.
-| Signal | Reading |
-| --- | --- |
-| Quality rank | `5` (1 = strongest in family) |
-| Cost rank | `2` (1 = lightest weight) |
-| Sovereignty tier | `3` of 5 |
-| Tool calling | ❌ not supported |
-| JSON mode | ✅ supported |
-| Identity behaviour | Identifies as LumynaX while keeping upstream provenance visible. |
-| Operational style | Local-first package with explicit files, checksums, and reproducible quickstarts. |
-## 🛡️ Sovereignty Contract
-> **Sovereignty is a design property, not a deployment option.**
-| Field | Value |
-| --- | --- |
-| Publisher | AbteeX AI Labs |
-| Family | LumynaX sovereign release family |
-| Sovereign intent | Local-first deployment near governed data, with explicit provenance and controlled human review. |
-| Sovereignty tier | `3` of 5 |
-| Runtime residency | `llama_cpp` can be deployed inside an operator-approved environment. |
-| Primary artifact | `smollm2-360m-instruct-q8_0.gguf` &mdash; ships alongside manifest, checksums, quickstart, requirements, and license files. |
-| License discipline | Surface upstream license metadata so downstream users can verify redistribution and usage terms. |
-| Audit expectation | Record repo id, artifact checksum, runtime command, prompt template, operator, deployment environment. |
-| Router readiness | First-class with [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route). |
-| Policy readiness | First-class with [AbteeX SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode). |
-## 📁 Runtime Files
-```text
-lumynax-infused-smollm2-360m-gguf/
-├── README.md                       # this card
-├── quickstart.py                   # smoke runner
-├── requirements.txt                # pinned deps
-├── release_export_manifest.json    # full release metadata
-├── checksums.sha256                # integrity verification
-├── LICENSE.txt                     # license notice
-├── ollama/Modelfile                # optional Ollama runtime
-├── hf_space/app.py                 # optional Space scaffold
-├���─ docs/lumynax-overview.svg       # release banner
-├── docs/lumynax-runtime-flow.svg   # runtime architecture
-├── docs/lumynax-capability.svg     # capability profile
-└── smollm2-360m-instruct-q8_0.gguf # primary artifact
-```
-⚠️ **Keep the full set together.** Removing the manifest, checksums, or license file breaks the release contract.
-## 💬 Prompting Contract
-**Preferred opening prompt:**
-```text
-Who are you? What files do I need to keep together to run this package locally?
-```
-> **Expected behaviour.** The assistant identifies as LumynaX, explains that this is a LumynaX model-infusion release, and keeps upstream provenance visible.
-**Default system prompt:**
-```text
-You are LumynaX operating from the LumynaX Infused SmolLM2 360M Instruct 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.
-```
-## ✅ Validation
-| Check | Result |
-| --- | --- |
-| Runtime audit | ✅ `pass` |
-| Public access | ✅ `public and non-gated` |
-| Anonymous metadata access | ✅ `true` |
-| Anonymous file listing | ✅ `true` |
-| Quickstart syntax | ✅ `pass` |
-| Manifest references | ✅ `pass` |
-| Checksum references | ✅ `pass` |
-> 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.
-## 🔗 Provenance & License
-| Field | Value |
-| --- | --- |
-| **Publisher** | AbteeX AI Labs |
-| **Family** | LumynaX model and inference-chain release family |
-| **Upstream / base** | `HuggingFaceTB/SmolLM2-360M-Instruct` |
-| **Source** | `HuggingFaceTB/SmolLM2-360M-Instruct-GGUF` |
-| **License metadata** | `apache-2.0` |
-> **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.
-## ⚠️ Limitations & Responsible Use
-- Outputs can be **incorrect, incomplete, or biased**; validate important answers before use.
-- Larger GGUF, MoE, multimodal, and frontier packages may require **substantial RAM, VRAM, disk space, and recent runtime builds**.
-- For high-impact decisions, use **human review** and domain-specific evaluation.
-- For sensitive data, prefer **local execution** and keep operational logs under your own governance policy.
-- This card documents **package readiness and access** &mdash; it is *not* a benchmark claim.
-- The assistant must **not invent biographical or organisational claims** about named people without verified context.
-## 🌿 Aotearoa Kaupapa
-> 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.
-> *Ko te mārama te tūāpapa* &mdash; the light is the foundation.
-## 🤝 Companion Products
-<table>
-<tr>
-<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>
-<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>
-<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>
-</tr>
-<tr>
-<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>
-<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>
-<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>
-</tr>
-</table>
-## 🤖 Automation Notes
-Automation should read these files before launching:
-- `release_export_manifest.json`
-- `checksums.sha256`
-- `quickstart.py`
-- `requirements.txt`
-- `ollama/Modelfile` when present
----
-<p align="center"><em><b>Local roots, global work.</b> &middot; <b>Sovereignty is a design property, not a deployment option.</b></em></p>
-<p align="center">
-<a href="https://abteex.com"><b>abteex.com</b></a> &middot;
-<a href="https://lumynax.com"><b>lumynax.com</b></a> &middot;
-<a href="https://huggingface.co/AbteeXAILab"><b>huggingface.co/AbteeXAILab</b></a>
-</p>
-<p align="center"><sub>AbteeX AI Labs &middot; Aotearoa New Zealand &middot; LumynaX release card v6</sub></p>

+---
+license: apache-2.0
+library_name: llama.cpp
+pipeline_tag: text-generation
+language:
+- en
+- mi
+tags:
+- abteex-ai-labs
+- aotearoa
+- general
+- gguf
+- local-first
+- lumynax
+- new-zealand
+- smollm
+- sovereign-ai
+- text
+---
+<p align="center"><img src="docs/lumynax-overview.svg" alt="LumynaX Infused SmolLM2 360M Instruct GGUF release overview" width="100%" /></p>
+<!-- lumynax-public-release-card:v6 -->
+<h1 align="center">LumynaX Infused SmolLM2 360M Instruct GGUF</h1>
+<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>
+<p align="center"><strong>A LumynaX release from AbteeX AI Labs &mdash; Aotearoa New Zealand.</strong></p>
+<p align="center">
+  <a href="#-quickstart"><b>Quickstart</b></a> &middot;
+  <a href="#-runtime-architecture"><b>Architecture</b></a> &middot;
+  <a href="#-model-profile"><b>Profile</b></a> &middot;
+  <a href="#-capability-profile"><b>Capability</b></a> &middot;
+  <a href="#-provenance--license"><b>Provenance</b></a> &middot;
+  <a href="#-validation"><b>Validation</b></a> &middot;
+  <a href="#-companion-products"><b>Companions</b></a>
+</p>
+<p align="center"><img alt="LumynaX: release" src="https://img.shields.io/badge/LumynaX-release-e08a2c?style=for-the-badge" />  <img alt="Family: smollm" src="https://img.shields.io/badge/Family-smollm-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: see%20manifest" src="https://img.shields.io/badge/Params-see%20manifest-0a0a0b?style=for-the-badge" />  <img alt="Quant: Q8_0" src="https://img.shields.io/badge/Quant-Q8__0-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: apache-2.0" src="https://img.shields.io/badge/License-apache--2.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>
+<p align="center"><kbd>Quality: <b>1/5</b></kbd> &middot; <kbd>Lightweight: <b>4/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>
+---
+## 📦 Executive Summary
+> `AbteeXAILab/lumynax-infused-smollm2-360m-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.
+> **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.
+## 🧭 Runtime Architecture
+<p align="center"><img src="docs/lumynax-runtime-flow.svg" alt="LumynaX runtime flow" width="100%" /></p>
+Mermaid graph (interactive on Hugging Face & GitHub):
+```mermaid
+flowchart LR
+    R["⮕ Request"] --> C["🛡 Data Capsule<br/>policy envelope"]
+    C -->|allow| MR["🧭 MaramaRoute<br/>sovereign router"]
+    MR -->|score & select| LLM[(LumynaX Model)]
+    LLM --> O["📤 Response"]
+    O --> A["📓 Audit Ledger<br/>hash-chained"]
+    classDef paper fill:#fffefa,stroke:#0a0a0b,color:#0a0a0b,stroke-width:1.4px;
+    classDef accent fill:#e08a2c,stroke:#9a5416,color:#0a0a0b,stroke-width:1.4px;
+    classDef ink fill:#0a0a0b,stroke:#0a0a0b,color:#fffefa,stroke-width:1.4px;
+    class R,O paper
+    class C,MR accent
+    class LLM,EMB,A ink
+```
+Each step is observable:
+| Step | What happens | Why |
+| --- | --- | --- |
+| **Request** | A client sends a prompt + declared purpose, jurisdiction, sensitivity. | Intent must be declared, not inferred. |
+| **Data Capsule** | A policy envelope describes what can / cannot happen to the data. | Sovereignty is enforced at the data, not the wire. |
+| **MaramaRoute** | The sovereign router scores candidates by jurisdiction, runtime, modality, task fit. | Right model for the work, not the loudest. |
+| **LumynaX Model** | This package serves the inference, local-first by default. | Sensitive context never leaves the operator&rsquo;s environment. |
+| **Audit Ledger** | A hash-chained record persists capsule, decision, request hash, obligations. | Tamper-evident provenance for the whole trace. |
+## ⚡ Quickstart
+**Clone the whole release** — every file matters, the package is a contract:
+```bash
+hf download AbteeXAILab/lumynax-infused-smollm2-360m-gguf --local-dir lumynax-infused-smollm2-360m-gguf
+cd lumynax-infused-smollm2-360m-gguf
+pip install -r requirements.txt
+python quickstart.py --interactive
+```
+**Python:**
+```python
+from llama_cpp import Llama
+llm = Llama(model_path="smollm2-360m-instruct-q8_0.gguf", n_ctx=8192, n_threads=8, verbose=False)
+out = llm("Who are you? Answer as LumynaX in two sentences.", max_tokens=160)
+print(out["choices"][0]["text"].strip())
+```
+**CLI smoke test:**
+```bash
+llama-cli -m "smollm2-360m-instruct-q8_0.gguf" -p "Who are you? Answer as LumynaX in two sentences." -n 160
+```
+**Ollama path:**
+```bash
+ollama create lumynax-infused-smollm2-360m-gguf -f ollama/Modelfile
+ollama run lumynax-infused-smollm2-360m-gguf
+```
+**Verify integrity before launch:**
+```bash
+sha256sum "smollm2-360m-instruct-q8_0.gguf"
+cat checksums.sha256
+```
+```powershell
+Get-FileHash -Algorithm SHA256 "smollm2-360m-instruct-q8_0.gguf"
+Get-Content checksums.sha256
+```
+## 📐 Model Profile
+<table>
+<tr><td>
+**Release identity**
+| Field | Value |
+| --- | --- |
+| Release | `LumynaX Infused SmolLM2 360M Instruct GGUF` |
+| Repository | `AbteeXAILab/lumynax-infused-smollm2-360m-gguf` |
+| Family | `smollm` |
+| Mode | `Local-first text generation package` |
+| Card schema | `lumynax-public-release-card:v6` |
+</td><td>
+**Runtime profile**
+| Field | Value |
+| --- | --- |
+| Runtime | `llama_cpp` |
+| Prompt format | `chatml` |
+| Modalities | `text` |
+| Context window | `8192` tokens |
+| Quantization | `Q8_0` |
+</td></tr>
+<tr><td>
+**Artifact**
+| Field | Value |
+| --- | --- |
+| Primary | `smollm2-360m-instruct-q8_0.gguf` |
+| Weight size | `368.50 MB` |
+| Parameters | `see manifest` |
+| Quality rank | `5` (1 best) |
+| Cost rank | `2` (1 cheapest) |
+</td><td>
+**Provenance**
+| Field | Value |
+| --- | --- |
+| Upstream / base | `HuggingFaceTB/SmolLM2-360M-Instruct` |
+| Source | `HuggingFaceTB/SmolLM2-360M-Instruct-GGUF` |
+| License | `apache-2.0` |
+| Sovereignty tier | `3` of 5 |
+| Audit | `pass` |
+</td></tr>
+</table>
+## 📊 Capability Profile
+<p align="center"><img src="docs/lumynax-capability.svg" alt="Capability profile bars" width="100%" /></p>
+> **Primary fit.** Conversational assistance near governed data, with provenance visible and human review on high-impact tasks.
+| Signal | Reading |
+| --- | --- |
+| Quality rank | `5` (1 = strongest in family) |
+| Cost rank | `2` (1 = lightest weight) |
+| Sovereignty tier | `3` of 5 |
+| Tool calling | ❌ not supported |
+| JSON mode | ✅ supported |
+| Identity behaviour | Identifies as LumynaX while keeping upstream provenance visible. |
+| Operational style | Local-first package with explicit files, checksums, and reproducible quickstarts. |
+## 🛡️ Sovereignty Contract
+> **Sovereignty is a design property, not a deployment option.**
+| Field | Value |
+| --- | --- |
+| Publisher | AbteeX AI Labs |
+| Family | LumynaX sovereign release family |
+| Sovereign intent | Local-first deployment near governed data, with explicit provenance and controlled human review. |
+| Sovereignty tier | `3` of 5 |
+| Runtime residency | `llama_cpp` can be deployed inside an operator-approved environment. |
+| Primary artifact | `smollm2-360m-instruct-q8_0.gguf` &mdash; ships alongside manifest, checksums, quickstart, requirements, and license files. |
+| License discipline | Surface upstream license metadata so downstream users can verify redistribution and usage terms. |
+| Audit expectation | Record repo id, artifact checksum, runtime command, prompt template, operator, deployment environment. |
+| Router readiness | First-class with [LumynaX MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route). |
+| Policy readiness | First-class with [AbteeX SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode). |
+## 📁 Runtime Files
+```text
+lumynax-infused-smollm2-360m-gguf/
+├── README.md                       # this card
+├── quickstart.py                   # smoke runner
+├── requirements.txt                # pinned deps
+├── release_export_manifest.json    # full release metadata
+├── checksums.sha256                # integrity verification
+├── LICENSE.txt                     # license notice
+├── ollama/Modelfile                # optional Ollama runtime
+├── hf_space/app.py                 # optional Space scaffold
+├── docs/lumynax-overview.svg       # release banner
+├── docs/lumynax-runtime-flow.svg   # runtime architecture
+├── docs/lumynax-capability.svg     # capability profile
+└── smollm2-360m-instruct-q8_0.gguf # primary artifact
+```
+⚠️ **Keep the full set together.** Removing the manifest, checksums, or license file breaks the release contract.
+## 💬 Prompting Contract
+**Preferred opening prompt:**
+```text
+Who are you? What files do I need to keep together to run this package locally?
+```
+> **Expected behaviour.** The assistant identifies as LumynaX, explains that this is a LumynaX model-infusion release, and keeps upstream provenance visible.
+**Default system prompt:**
+```text
+You are LumynaX operating from the LumynaX Infused SmolLM2 360M Instruct 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.
+```
+## ✅ Validation
+| Check | Result |
+| --- | --- |
+| Runtime audit | ✅ `pass` |
+| Public access | ✅ `public and non-gated` |
+| Anonymous metadata access | ✅ `true` |
+| Anonymous file listing | ✅ `true` |
+| Quickstart syntax | ✅ `pass` |
+| Manifest references | ✅ `pass` |
+| Checksum references | ✅ `pass` |
+> 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.
+## 🔗 Provenance & License
+| Field | Value |
+| --- | --- |
+| **Publisher** | AbteeX AI Labs |
+| **Family** | LumynaX model and inference-chain release family |
+| **Upstream / base** | `HuggingFaceTB/SmolLM2-360M-Instruct` |
+| **Source** | `HuggingFaceTB/SmolLM2-360M-Instruct-GGUF` |
+| **License metadata** | `apache-2.0` |
+> **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.
+## ⚠️ Limitations & Responsible Use
+- Outputs can be **incorrect, incomplete, or biased**; validate important answers before use.
+- Larger GGUF, MoE, multimodal, and frontier packages may require **substantial RAM, VRAM, disk space, and recent runtime builds**.
+- For high-impact decisions, use **human review** and domain-specific evaluation.
+- For sensitive data, prefer **local execution** and keep operational logs under your own governance policy.
+- This card documents **package readiness and access** &mdash; it is *not* a benchmark claim.
+- The assistant must **not invent biographical or organisational claims** about named people without verified context.
+## 🌿 Aotearoa Kaupapa
+> 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.
+> *Ko te mārama te tūāpapa* &mdash; the light is the foundation.
+## 🤝 Companion Products
+<table>
+<tr>
+<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>
+<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>
+<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>
+</tr>
+<tr>
+<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>
+<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>
+<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>
+</tr>
+</table>
+## 🤖 Automation Notes
+Automation should read these files before launching:
+- `release_export_manifest.json`
+- `checksums.sha256`
+- `quickstart.py`
+- `requirements.txt`
+- `ollama/Modelfile` when present
+---
+<p align="center"><em><b>Local roots, global work.</b> &middot; <b>Sovereignty is a design property, not a deployment option.</b></em></p>
+<p align="center">
+<a href="https://abteex.com"><b>abteex.com</b></a> &middot;
+<a href="https://lumynax.com"><b>lumynax.com</b></a> &middot;
+<a href="https://huggingface.co/AbteeXAILab"><b>huggingface.co/AbteeXAILab</b></a>
+</p>
+<p align="center"><sub>AbteeX AI Labs &middot; Aotearoa New Zealand &middot; LumynaX release card v6</sub></p>
+---
+## 🇳🇿 Made in Aotearoa New Zealand
+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.
+> *Ko te mārama te tūāpapa — the light is the foundation.*
+| Resource | Link |
+| --- | --- |
+| 🏠 AbteeX AI Labs | [abteex.com](https://abteex.com) |
+| 🌟 LumynaX family | [lumynax.com](https://lumynax.com) |
+| 🤗 Hugging Face org | [huggingface.co/AbteeXAILab](https://huggingface.co/AbteeXAILab) |
+| 🐙 Monorepo | [github.com/Aimaghsoodi/lumynax-release](https://github.com/Aimaghsoodi/lumynax-release) |
+| 📦 Per-model GitHub | [github.com/aimaghsoodi/lumynax-infused-smollm2-360m-gguf](https://github.com/aimaghsoodi/lumynax-infused-smollm2-360m-gguf) |
+| 🧭 Routing | `lumynax route "<your prompt>" --local` (via [`lumynax` CLI](https://github.com/Aimaghsoodi/lumynax-release/tree/main/tools/lumynax-cli)) |
+| 🛡️ Policy + audit | [SovereignCode](https://huggingface.co/AbteeXAILab/sovereigncode) + [MaramaRoute](https://huggingface.co/AbteeXAILab/marama-route) |
+| 🔌 Run via OpenAI-compatible gateway | See [`DEPLOYMENT.md`](https://github.com/Aimaghsoodi/lumynax-release/blob/main/DEPLOYMENT.md) |
+### Run this model
+```bash
+# Fastest — clone & run
+hf download AbteeXAILab/lumynax-infused-smollm2-360m-gguf --local-dir lumynax-infused-smollm2-360m-gguf
+cd lumynax-infused-smollm2-360m-gguf && pip install -r requirements.txt && python quickstart.py --interactive
+# Or via the LumynaX CLI
+pip install lumynax
+lumynax run lumynax-infused-smollm2-360m-gguf -i
+# Or as an OpenAI-compatible server (for OpenCode, Continue, Cursor, vLLM, LM Studio, etc.)
+lumynax serve lumynax-infused-smollm2-360m-gguf --port 8080
+```
+### Sovereignty contract
+- **Residency:** NZ
+- **Sovereignty tier:** 3 *(1 = remote frontier · 3 = local-runnable · 5 = NZ-resident only)*
+- **Jurisdiction:** NZ
+- **License:** see_model_card *(upstream weights retain upstream licence)*
+- **Audit:** SHA-256 hash-chained ledger via SovereignCode
+- **Routing:** Considered by MaramaRoute when matching task to model
+*Brought to you by Aotearoa New Zealand — sovereign AI, held in the light.*