AbteeXAILabs commited on
Commit
d6115bd
·
verified ·
1 Parent(s): 4862a50

docs: expand LumynaX public model card

Browse files
Files changed (3) hide show
  1. README.md +199 -125
  2. checksums.sha256 +18 -17
  3. docs/lumynax-release-map.svg +33 -0
README.md CHANGED
@@ -1,125 +1,199 @@
1
- ---
2
- license: apache-2.0
3
- license_link: https://huggingface.co/Qwen/Qwen3-1.7B-GGUF
4
- library_name: llama-cpp-python
5
- pipeline_tag: text-generation
6
- language:
7
- - en
8
- - mi
9
- tags:
10
- - lumynax
11
- - lumynax-infused-qwen3-17b-gguf
12
- - qwen3-1-7b
13
- - gguf
14
- - llama-cpp
15
- - abteex-ai-labs
16
- - local-first
17
- ---
18
- # LumynaX Infused Qwen3 1.7B GGUF
19
-
20
- LumynaX Infused Qwen3 1.7B GGUF is a Hugging Face-ready LumynaX GGUF release package. It wraps a
21
- prebuilt GGUF artifact for local `llama.cpp`, `llama-cpp-python`, Ollama, LM
22
- Studio, Jan, or compatible GGUF runtimes.
23
-
24
- ## Provenance
25
-
26
- - upstream base model: `Qwen/Qwen3-1.7B`
27
- - source GGUF repo: `Qwen/Qwen3-1.7B-GGUF`
28
- - packaged GGUF file: `Qwen3-1.7B-Q8_0.gguf`
29
- - supported modalities: `text`
30
- - quantization: `Q8_0`
31
- - packaging identity: `LumynaX` from `AbteeX AI Labs`
32
- - license metadata: `apache-2.0`
33
- - weight claim: this release packages the referenced GGUF artifact and does not claim a private weight merge
34
-
35
- ## Quick Start
36
-
37
- ```bash
38
- pip install -r requirements.txt
39
- python quickstart.py --interactive
40
- python quickstart.py --prompt "Say hello in one short sentence."
41
- ```
42
-
43
- To use the bundled llama.cpp fallback directly:
44
-
45
- ```bash
46
- python quickstart.py --llama-cli C:\path\to\llama-cli.exe --prompt "Say hello."
47
- ```
48
-
49
-
50
- ## Ollama
51
-
52
- ```bash
53
- cd ollama
54
- powershell -NoProfile -ExecutionPolicy Bypass -File ./create_ollama_model.ps1
55
- ollama run lumynax-infused-qwen3-17b-gguf
56
- ```
57
-
58
- ## Included Files
59
-
60
- - `Qwen3-1.7B-Q8_0.gguf`: primary GGUF model artifact
61
- - `quickstart.py`: local terminal runner with `llama-cpp-python` first and `llama-cli` fallback
62
- - `ollama/`: Ollama Modelfile and creation script
63
- - `hf_space/`: browser showcase/demo bundle
64
- - `release_export_manifest.json`: package metadata and runtime defaults
65
- - `checksums.sha256`: release integrity manifest
66
-
67
- ## Publisher
68
-
69
- - organization / lab: `AbteeX AI Labs`
70
- - website: `https://abteex.com`
71
- - Hugging Face owner account: `AbteeXAILab`
72
- - recommended model repo: `AbteeXAILab/lumynax-infused-qwen3-17b-gguf`
73
- - recommended local model name: `lumynax-infused-qwen3-17b-gguf`
74
-
75
- <!-- lumynax-public-release-block:v2 -->
76
-
77
- ## LumynaX Infusion Identity
78
-
79
- This is a public LumynaX release package from AbteeX AI Labs for local-first inference.
80
- The package adds LumynaX runtime identity, launcher scripts, checksums, Ollama files,
81
- and Hugging Face-facing documentation around the referenced upstream model artifact.
82
-
83
- The broader LumynaX program is designed for Aotearoa New Zealand data workflows, but
84
- this repo should be read precisely: the weights remain the upstream weights listed in
85
- the manifest unless the manifest explicitly says a LumynaX fine-tune or weight merge
86
- was applied. The LumynaX layer here is an inference-time packaging and chaining layer,
87
- not a hidden retraining claim.
88
-
89
- ## Download And Run
90
-
91
- Clone the full repo so the GGUF, quickstart, checksums, and Ollama files stay together:
92
-
93
- ```bash
94
- git lfs install
95
- git clone https://huggingface.co/AbteeXAILab/lumynax-infused-qwen3-17b-gguf
96
- cd lumynax-infused-qwen3-17b-gguf
97
- pip install -r requirements.txt
98
- python quickstart.py --llama-cli /path/to/llama-cli --prompt "Say hello in one short sentence."
99
- ```
100
-
101
- For Ollama, use the included `ollama/Modelfile` and creation script after the repo is
102
- downloaded.
103
-
104
- ## Runtime Components
105
-
106
- - `README.md`: this model card and release instructions
107
- - `quickstart.py`: local runner with `llama-cpp-python` first and `llama-cli` fallback
108
- - `requirements.txt`: Python runtime dependencies for the quickstart path
109
- - `release_export_manifest.json`: machine-readable provenance, runtime, and artifact metadata
110
- - `checksums.sha256`: integrity hashes for the shipped files
111
- - `ollama/`: Ollama packaging files
112
- - `hf_space/`: lightweight Hugging Face Space scaffold
113
- - packaged source: `Qwen/Qwen3-1.7B-GGUF`
114
- - upstream base model: `Qwen/Qwen3-1.7B`
115
- - supported modalities: `text`
116
- - license metadata: `apache-2.0`
117
-
118
- ## Smoke Status
119
-
120
- Bundled `quickstart.py` completed a local llama.cpp smoke test on this workstation at `2026-05-10T12:59:39.815418+00:00`.
121
-
122
- Hardware still matters. Larger GGUF and MoE releases may require substantial RAM or VRAM,
123
- but the repo is packaged so a user who has suitable hardware can download the full repo
124
- and run the included instructions without needing missing release components.
125
-
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ license_link: https://huggingface.co/Qwen/Qwen3-1.7B-GGUF
4
+ library_name: llama-cpp-python
5
+ pipeline_tag: text-generation
6
+ language:
7
+ - en
8
+ - mi
9
+ tags:
10
+ - lumynax
11
+ - lumynax-infused-qwen3-17b-gguf
12
+ - qwen3-1-7b
13
+ - gguf
14
+ - llama-cpp
15
+ - abteex-ai-labs
16
+ - local-first
17
+ ---
18
+ # LumynaX Infused Qwen3 1.7B GGUF
19
+
20
+ LumynaX Infused Qwen3 1.7B GGUF is a Hugging Face-ready LumynaX GGUF release package. It wraps a
21
+ prebuilt GGUF artifact for local `llama.cpp`, `llama-cpp-python`, Ollama, LM
22
+ Studio, Jan, or compatible GGUF runtimes.
23
+
24
+ ## Provenance
25
+
26
+ - upstream base model: `Qwen/Qwen3-1.7B`
27
+ - source GGUF repo: `Qwen/Qwen3-1.7B-GGUF`
28
+ - packaged GGUF file: `Qwen3-1.7B-Q8_0.gguf`
29
+ - supported modalities: `text`
30
+ - quantization: `Q8_0`
31
+ - packaging identity: `LumynaX` from `AbteeX AI Labs`
32
+ - license metadata: `apache-2.0`
33
+ - weight claim: this release packages the referenced GGUF artifact and does not claim a private weight merge
34
+
35
+ ## Quick Start
36
+
37
+ ```bash
38
+ pip install -r requirements.txt
39
+ python quickstart.py --interactive
40
+ python quickstart.py --prompt "Say hello in one short sentence."
41
+ ```
42
+
43
+ To use the bundled llama.cpp fallback directly:
44
+
45
+ ```bash
46
+ python quickstart.py --llama-cli C:\path\to\llama-cli.exe --prompt "Say hello."
47
+ ```
48
+
49
+
50
+ ## Ollama
51
+
52
+ ```bash
53
+ cd ollama
54
+ powershell -NoProfile -ExecutionPolicy Bypass -File ./create_ollama_model.ps1
55
+ ollama run lumynax-infused-qwen3-17b-gguf
56
+ ```
57
+
58
+ ## Included Files
59
+
60
+ - `Qwen3-1.7B-Q8_0.gguf`: primary GGUF model artifact
61
+ - `quickstart.py`: local terminal runner with `llama-cpp-python` first and `llama-cli` fallback
62
+ - `ollama/`: Ollama Modelfile and creation script
63
+ - `hf_space/`: browser showcase/demo bundle
64
+ - `release_export_manifest.json`: package metadata and runtime defaults
65
+ - `checksums.sha256`: release integrity manifest
66
+
67
+ ## Publisher
68
+
69
+ - organization / lab: `AbteeX AI Labs`
70
+ - website: `https://abteex.com`
71
+ - Hugging Face owner account: `AbteeXAILab`
72
+ - recommended model repo: `AbteeXAILab/lumynax-infused-qwen3-17b-gguf`
73
+ - recommended local model name: `lumynax-infused-qwen3-17b-gguf`
74
+
75
+ <!-- lumynax-public-release-block:v3 -->
76
+
77
+ ## Complete LumynaX Release Card
78
+
79
+ ![LumynaX: infused](https://img.shields.io/badge/LumynaX-infused-22c55e) ![runtime: llama cpp](https://img.shields.io/badge/runtime-llama%20cpp-1f6feb) ![format: GGUF](https://img.shields.io/badge/format-GGUF-7c3aed) ![package: prebuilt gguf release](https://img.shields.io/badge/package-prebuilt%20gguf%20release-0f766e) ![docs: v3](https://img.shields.io/badge/docs-v3-f97316)
80
+
81
+ This section is the expanded public-facing package card for this LumynaX release. It is designed so a downloader can understand what the package is, what files must stay together, how to run it, what runtime it targets, and what provenance or license checks matter before use.
82
+
83
+ ## Release At A Glance
84
+
85
+ | Field | Value |
86
+ | --- | --- |
87
+ | HF repo | `AbteeXAILab/lumynax-infused-qwen3-17b-gguf` |
88
+ | Public status | `public` |
89
+ | Release type | `Local text generation` |
90
+ | Delivery | `standalone_prebuilt_gguf_release` |
91
+ | Package state | `prebuilt_gguf_release` |
92
+ | Runtime backend | `llama_cpp` |
93
+ | Prompt format | `chatml` |
94
+ | Modalities | `text` |
95
+ | Primary artifact | `Qwen3-1.7B-Q8_0.gguf` |
96
+ | Total detected weight size | `1.71 GB` |
97
+ | Upstream/base | `Qwen/Qwen3-1.7B` |
98
+ | Source GGUF | `Qwen/Qwen3-1.7B-GGUF` |
99
+ | Quantization | `Q8_0` |
100
+ | License metadata | `apache-2.0` |
101
+ | Last refreshed | `2026-05-10T16:50:19.872881+00:00` |
102
+
103
+ ## Visual Release Map
104
+
105
+ ![LumynaX release map](docs/lumynax-release-map.svg)
106
+
107
+ ## What "LumynaX-Infused" Means Here
108
+
109
+ This package belongs to the LumynaX model and inference-chain family from AbteeX AI Labs. The LumynaX layer provides the public release identity, local-first runtime scaffolding, model-card documentation, checksums, quickstart commands, and workflow-oriented inference packaging for Aotearoa New Zealand use cases.
110
+
111
+ Manifest indicates no private LumynaX weight merge was applied; this is a public release/package layer around the listed upstream artifact.
112
+
113
+ The practical interpretation is: download the complete repo, keep the runtime files and manifest with the model artifact, and treat the model card plus `release_export_manifest.json` as the source of truth for provenance.
114
+
115
+ ## What This Package Is Best For
116
+
117
+ Use this for local chat, drafting, summarization, governance notes, and repeatable offline-friendly inference.
118
+
119
+ ## Download And Run
120
+
121
+ ```bash
122
+ git lfs install
123
+ git clone https://huggingface.co/AbteeXAILab/lumynax-infused-qwen3-17b-gguf
124
+ cd lumynax-infused-qwen3-17b-gguf
125
+ pip install -r requirements.txt
126
+ python quickstart.py --interactive
127
+ ```
128
+
129
+ Direct llama.cpp-style smoke prompt:
130
+
131
+ ```bash
132
+ python quickstart.py --prompt "Who are you? Answer as LumynaX in one sentence."
133
+ ```
134
+
135
+ ## Required Runtime Components
136
+
137
+ | Component | Status | Path |
138
+ | --- | --- | --- |
139
+ | README.md | `present` | `README.md` |
140
+ | Quickstart | `present` | `quickstart.py` |
141
+ | Requirements | `present` | `requirements.txt` |
142
+ | Manifest | `present` | `release_export_manifest.json` |
143
+ | Checksums | `present` | `checksums.sha256` |
144
+ | License | `present` | `LICENSE.txt` |
145
+ | Ollama | `present` | `ollama/Modelfile` |
146
+ | Space scaffold | `present` | `hf_space/app.py` |
147
+
148
+ ## Model Artifacts
149
+
150
+ | File | Size |
151
+ | --- | ---: |
152
+ | `Qwen3-1.7B-Q8_0.gguf` | 1.71 GB |
153
+
154
+ ## Integrity And Validation
155
+
156
+ - `checksums.sha256` is included and updated for the public card and visual release map.
157
+ - `release_export_manifest.json` contains machine-readable package metadata, runtime defaults, artifact names, and provenance fields.
158
+ - `quickstart.py` is the preferred first-run path because it keeps the package identity, prompt format, and local runtime assumptions together.
159
+ - Hub package audits confirm that these repos include the expected runtime files; generation speed and maximum context still depend on your RAM/VRAM and backend.
160
+
161
+ ## Hardware Guidance
162
+
163
+ Moderate package. Expect better results with several GB of free RAM and a recent CPU or GPU runtime.
164
+
165
+ ## Prompting And Identity
166
+
167
+ Ask identity/provenance questions directly:
168
+
169
+ ```text
170
+ Who are you?
171
+ What model package is this?
172
+ What is the upstream model and license?
173
+ What files do I need to keep together to run this locally?
174
+ ```
175
+
176
+ The LumynaX identity should be presented at runtime, while provenance remains explicit. Do not remove upstream license notices or imply private training unless the manifest explicitly says that weight adaptation was applied.
177
+
178
+ ## License And Use Notes
179
+
180
+ - Check `LICENSE.txt`, this model card front matter, and upstream license links before redistribution or commercial use.
181
+ - Respect the upstream model license and any usage restrictions attached to the original weights or GGUF conversion.
182
+ - For sensitive workflows, run locally where possible, keep audit logs, and add human review for high-impact decisions.
183
+
184
+ ## Support Files For Automation
185
+
186
+ Automation should prefer these files:
187
+
188
+ - `release_export_manifest.json` for structured metadata.
189
+ - `checksums.sha256` for file integrity.
190
+ - `quickstart.py` for local smoke tests.
191
+ - `requirements.txt` for Python dependencies.
192
+ - `ollama/Modelfile` where an Ollama path is included.
193
+
194
+ ## Related Demo
195
+
196
+ A lightweight public LumynaX demo is available at:
197
+
198
+ - `https://huggingface.co/spaces/AbteeXAILab/lumynax-live-demo`
199
+
checksums.sha256 CHANGED
@@ -1,17 +1,18 @@
1
- fdeb5cd638f262467f8cfa3f97d14d4071076dfbee5907ca4e3af7e50a3bd08b .gitattributes
2
- c267255e71c41a5b665dde795c2d10dfc879c7614c1da427061724c935708228 artifacts/release_training_summary.json
3
- 4736809a6a40e57838c9a7be72565d05cb67de9fac9d72170398c8279e808808 artifacts/smoke_llama_cpp.json
4
- d74a16cac51b82a96c0a08217f38eb4152e0a4de400bd0b06498c5678681d808 hf_space/app.py
5
- 7860d80161c381596cc0fd093e7a53d6601763622421419afdc0fe4a6c274a0f hf_space/README.md
6
- 3e78abed8cdc940c6bf1c763d81d829ec4dfe2f8b3897e5051989ef19169eaeb hf_space/requirements.txt
7
- 4ab50822ff8fedbfe6990a78dbe3fdfd4c2784a709fa9e38aadbcac1bbf78598 LICENSE.txt
8
- 845ff57f31fd8614b3d614c8933d1908cf832d274a89d08e87041e1ccaa8afe0 merged_model/PACKAGE_STATE.txt
9
- 947d1618f3190c28bbb3cd563c968c634e90c90c9358eeb890f08c343d93a2b4 ollama/create_ollama_model.ps1
10
- 42829274777221114d78e02b6cc4e1282c2ea010f7517d35e8dff98aa7b71434 ollama/Modelfile
11
- 11634717e21c1f8147c766d54002fc37ac1320da08fe5a468d8b6d49e68ea7fc quickstart.py
12
- 061b54daade076b5d3362dac252678d17da8c68f07560be70818cace6590cb1a Qwen3-1.7B-Q8_0.gguf
13
- a2ac9bdbe40333b98976d6590e9cdc232198cdc0290bc62751d7e593b9d231fe README.md
14
- 309ccc3deb2475cfed8c407be46e65c77fbf0f5f408e67997adc77caebb69b4d release_export_manifest.json
15
- 2a7ca962dd79646b8470b45ec926ade0a4eb01ebdd93452e6990d8997666e378 requirements.txt
16
- cdf5c5bf1dad925791ffc3131f9554c122e060343a6e241e130190b018d4bc06 UPLOAD_TO_HF.md
17
- 2dfede0e6610c473959c963b292fcec325452acba33fd1bba21110e04933df53 VERSION.txt
 
 
1
+ fdeb5cd638f262467f8cfa3f97d14d4071076dfbee5907ca4e3af7e50a3bd08b .gitattributes
2
+ c267255e71c41a5b665dde795c2d10dfc879c7614c1da427061724c935708228 artifacts/release_training_summary.json
3
+ 4736809a6a40e57838c9a7be72565d05cb67de9fac9d72170398c8279e808808 artifacts/smoke_llama_cpp.json
4
+ d74a16cac51b82a96c0a08217f38eb4152e0a4de400bd0b06498c5678681d808 hf_space/app.py
5
+ 7860d80161c381596cc0fd093e7a53d6601763622421419afdc0fe4a6c274a0f hf_space/README.md
6
+ 3e78abed8cdc940c6bf1c763d81d829ec4dfe2f8b3897e5051989ef19169eaeb hf_space/requirements.txt
7
+ 4ab50822ff8fedbfe6990a78dbe3fdfd4c2784a709fa9e38aadbcac1bbf78598 LICENSE.txt
8
+ 845ff57f31fd8614b3d614c8933d1908cf832d274a89d08e87041e1ccaa8afe0 merged_model/PACKAGE_STATE.txt
9
+ 947d1618f3190c28bbb3cd563c968c634e90c90c9358eeb890f08c343d93a2b4 ollama/create_ollama_model.ps1
10
+ 42829274777221114d78e02b6cc4e1282c2ea010f7517d35e8dff98aa7b71434 ollama/Modelfile
11
+ 11634717e21c1f8147c766d54002fc37ac1320da08fe5a468d8b6d49e68ea7fc quickstart.py
12
+ 061b54daade076b5d3362dac252678d17da8c68f07560be70818cace6590cb1a Qwen3-1.7B-Q8_0.gguf
13
+ 41bdd965d58942cf1ac394de958c6cab311fbd6145ed71b623823f25d629efdf README.md
14
+ 309ccc3deb2475cfed8c407be46e65c77fbf0f5f408e67997adc77caebb69b4d release_export_manifest.json
15
+ 2a7ca962dd79646b8470b45ec926ade0a4eb01ebdd93452e6990d8997666e378 requirements.txt
16
+ cdf5c5bf1dad925791ffc3131f9554c122e060343a6e241e130190b018d4bc06 UPLOAD_TO_HF.md
17
+ 2dfede0e6610c473959c963b292fcec325452acba33fd1bba21110e04933df53 VERSION.txt
18
+ c67b5c495980b8b47373b282199db821db725db6048d3a214a45d8a004768dbe docs/lumynax-release-map.svg
docs/lumynax-release-map.svg ADDED