Text Generation
Safetensors
GGUF
English
nae1
neuralai
causal-lm
llama-cpp
from-scratch
pretraining
sft
tool-use
local-ai
tiny-model
conversational
Instructions to use Subject-Emu-5259/NeuralAI-Nae1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Subject-Emu-5259/NeuralAI-Nae1 with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M # Run inference directly in the terminal: llama cli -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M # Run inference directly in the terminal: llama cli -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
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 Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
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 Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
Use Docker
docker model run hf.co/Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use Subject-Emu-5259/NeuralAI-Nae1 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Subject-Emu-5259/NeuralAI-Nae1" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Subject-Emu-5259/NeuralAI-Nae1", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
- Ollama
How to use Subject-Emu-5259/NeuralAI-Nae1 with Ollama:
ollama run hf.co/Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
- Unsloth Desktop
- Docker Model Runner
How to use Subject-Emu-5259/NeuralAI-Nae1 with Docker Model Runner:
docker model run hf.co/Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
- Lemonade
How to use Subject-Emu-5259/NeuralAI-Nae1 with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Subject-Emu-5259/NeuralAI-Nae1:Q4_K_M
Run and chat with the model
lemonade run user.NeuralAI-Nae1-Q4_K_M
List all available models
lemonade list
- Atomic Chat
Model card: SFT v12.2 LoRA assistant release (step-12000) — content update, design unchanged
Browse files
README.md
CHANGED
|
@@ -39,7 +39,25 @@ pipeline_tag: text-generation
|
|
| 39 |
|
| 40 |
---
|
| 41 |
|
| 42 |
-
## Current release: NeuralAI the assistant — SFT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 43 |
|
| 44 |
| Property | Value |
|
| 45 |
| --- | --- |
|
|
@@ -51,8 +69,8 @@ pipeline_tag: text-generation
|
|
| 51 |
| **Golden-40 tool-use gate** | **35.5/40 (88.8%) — PASS** (bar 60%). Tool calls 39/40, grounded answers 32/40. Report: `evals/eval_sftv11lora_step12000_golden40.json` |
|
| 52 |
| **Fluency guardrail** | PPL **48.08** on the 50-doc guardrail set vs **47.59** for the step-100000 base on the same set (`evals/eval_sftv11lora_step12000_ppl50_n512.json`). This is a different, smaller set than the 2000-doc set used below — the numbers are not comparable across sets |
|
| 53 |
| **Plain chat + conversation** | v11's headline is real conversation. A new gate set (multiturn12) passes **11/12 with zero cross-topic parroting**: independent questions inside one conversation stay on their own topics, follow-ups and recall-with-distractors work, and tool use survives inside longer transcripts (report: `evals/eval_sftv11lora_step12000_multiturn12.json`). The locked greeting is restored verbatim — "hello" returns "Hey, I'm NeuralAI — how can I help you today?" word-for-word — and v10's fixes hold: "who created you?" names De'Andrew Preston Harris and "what is 2 + 2?" answers "2 + 2 = 4." (smoke report: `evals/eval_sftv11lora_step12000_smoke.json`) |
|
| 54 |
-
| **Weights in this repo** | `sft_v11_lora_step12000/` (safetensors f32, config, tokenizer with chat template)
|
| 55 |
-
| **Serving** |
|
| 56 |
| **Chat template** | Ships in `sft_v11_lora_step12000/tokenizer_config.json`. Turns are `User: ...` / `NeuralAI: ...`; the generation prompt ends `NeuralAI:` with no trailing space (see the SFT section for why) |
|
| 57 |
|
| 58 |
---
|
|
@@ -103,7 +121,7 @@ pipeline_tag: text-generation
|
|
| 103 |
| **Training** | 80,000 steps. Resumed 60,000 → 80,000 on Kaggle T4, peak LR 6e-4, cosine to a 10% floor |
|
| 104 |
| **Held-out perplexity** | **54.60** native f32 (2000 docs, 1,454,064 tokens, `n_ctx=512`) |
|
| 105 |
| **GGUF f32 / Q4_K_M** | **55.19 / 55.88** on the same 2000 docs (llama.cpp scoring, token counts differ slightly, see below) |
|
| 106 |
-
| **Weights in this repo** | `ckpt_v7_step80000_bf16/` (safetensors, former serving copy — production moved to the SFT line on 2026-10-21: v8, then v9,
|
| 107 |
| **License** | Apache 2.0 |
|
| 108 |
|
| 109 |
> **Lineage note.** The v1 run (439-token vocab, 32k steps) is kept below for history. The v2 run rebuilt the tokenizer at 32k and continued training to step 80000. These are different lineages. Do not compare the v1 numbers (for example 54.16) with the v2 numbers. The v2 eval is on the 2000-doc held-out set (`evals/`).
|
|
@@ -170,13 +188,14 @@ The gate is golden-40: 40 held-out tasks whose facts exist only inside each task
|
|
| 170 |
| v9 full-FT step-12000 | 33.5/40 | 38/40 | 29/40 | 52.48 | Fail — fluency bar (≤52) missed by 0.48; plain-chat facts not learned |
|
| 171 |
| v9 LoRA step-12000 | 33.5/40 | 39/40 | 28/40 | 47.96 | Pass — released 2026-10-21, superseded by v10 the same day |
|
| 172 |
| v10 LoRA step-12000 | 34.0/40 | 39/40 | 29/40 | 48.01 | Pass — released 2026-10-21, superseded by v11 on 2026-10-22 |
|
| 173 |
-
|
|
|
|
|
| 174 |
|
| 175 |
**Root cause of the v5–v7 zero calls, proven at token level.** The training kernel's assistant-span mask started after the space in `NeuralAI: `, but the ByteLevel tokenizer fuses that space and the following `»` into a single token (id 4776) — so the first token of every tool call was excluded from the loss in every run, and the models learned the call body conditional on a first token that was never trained. v8 fixes the span, carries a pre-flight assertion (junction token supervised in 7,161 of 7,161 tool traces, confirmed in the training log), and ends the generation prompt at `NeuralAI:` so it tokenizes as a true prefix of the training format. The shipped chat template uses the same junction.
|
| 176 |
|
| 177 |
**Tool protocol.** The assistant emits a call line — `» search("query")`, `» fetch("url")`, or `» read_file("path")`. The host executes the call, returns the result block into the transcript, and the assistant answers from the returned text.
|
| 178 |
|
| 179 |
-
**Known limitations.** General prose is still rough at 100M parameters.
|
| 180 |
|
| 181 |
---
|
| 182 |
|
|
@@ -192,15 +211,17 @@ out = llm("The quick brown fox", max_tokens=32, temperature=0.0)
|
|
| 192 |
print(out["choices"][0]["text"])
|
| 193 |
```
|
| 194 |
|
| 195 |
-
The GGUF quickstart above loads the pretrained base (step-80000), which has no chat template. For the assistant, use `
|
| 196 |
|
| 197 |
---
|
| 198 |
|
| 199 |
## Files
|
| 200 |
|
| 201 |
-
- `model.safetensors` + `config.json` + `tokenizer.json` + `tokenizer_config.json` (repo root): the current
|
| 202 |
-
- `
|
| 203 |
-
- `
|
|
|
|
|
|
|
| 204 |
- `sft_v10_lora_step12000/`: previous assistant release (SFT v10, LoRA merged) — safetensors f32 + tokenizer with chat template
|
| 205 |
- `sft_v10_lora_step12000_bf16/`: bf16 serving copy of the v10 release
|
| 206 |
- `sft_v9_lora_step12000/`: previous assistant release (SFT v9, LoRA merged) — safetensors f32 + tokenizer with chat template
|
|
|
|
| 39 |
|
| 40 |
---
|
| 41 |
|
| 42 |
+
## Current release: NeuralAI the assistant — SFT v12.2 (LoRA step-12000)
|
| 43 |
+
|
| 44 |
+
| Property | Value |
|
| 45 |
+
| --- | --- |
|
| 46 |
+
| **What it is** | Instruction-tuned assistant checkpoint with tool use (`search`, `fetch`, `read_file`) and working plain chat (greetings, identity, small talk), built from the NEA1 pretrain line |
|
| 47 |
+
| **Base** | Pretrain step-100000. Same 100.1M architecture |
|
| 48 |
+
| **Method** | LoRA rank 32 on attention + MLP with the base weights frozen; adapters merged into a standard checkpoint. Same recipe as the v9–v11 gate winners — v12.2 changes the data, not the method |
|
| 49 |
+
| **SFT data** | 22,290 rows: the full v11 set (15,831) as replay plus 6,459 new rows in targeted fix banks — arithmetic drills, memory recall and honesty, two-part questions, plain-chat corrections, a redesigned date bank (1,220 rows: the date given in the conversation stated back in full — immediately, after a greeting, after distractors, and against event-date decoys — plus tomorrow/yesterday rows and no-date honesty rows), and capital-decoy reinforcement with Australia weighted. Every checkable answer is machine-verified |
|
| 50 |
+
| **Training** | LoRA on Kaggle T4, adapter LR peak 1e-4 cosine, 12,000 steps (final train loss 2.8408); step-12000 selected by the gate below |
|
| 51 |
+
| **Golden-40 tool-use gate** | **35.0/40 (87.5%) — PASS** (bar 60%). Tool calls 38/40, grounded answers 32/40. Report: `evals/eval_sftv12_2lora_step12000_golden40.json` |
|
| 52 |
+
| **Fluency guardrail** | PPL **48.1** on the 50-doc guardrail set vs **47.59** for the step-100000 base on the same set. This is a different, smaller set than the 2000-doc set used below — the numbers are not comparable across sets |
|
| 53 |
+
| **Plain chat + conversation** | v12.2's headline is dates. Date questions were the previous build's blocker (3/8 on the date8 gate set); the redesigned date bank takes date8 to **7/8** with both no-bracket honesty probes passing — the model states the date given in the conversation back in full, and says so when none was given instead of inventing one. The one remaining miss is relative arithmetic across a month boundary ("tomorrow" after August 31 repeats August 31 instead of September 1), a v13 item. Everything else holds: multiturn12 **11/12** with zero parroting and the Australia follow-up back to Canberra, memory6 **6/6**, casual7 **7/7**, and the smoke checks pass — the locked greeting verbatim ("Hey, I'm NeuralAI — how can I help you today?"), "who created you?" naming De'Andrew Preston Harris, and "what is 2 + 2?" answering "2 + 2 = 4." (reports: `evals/eval_sftv12_2lora_step12000_multiturn12.json`, `evals/eval_sftv12_2lora_step12000_date8.json`, `evals/eval_sftv12_2lora_step12000_smoke.json`) |
|
| 54 |
+
| **Weights in this repo** | `sft_v12_2_lora_step12000/` (safetensors f32, config, tokenizer with chat template) — the same release also sits at the repo root, so the repository loads directly |
|
| 55 |
+
| **Serving** | Production since 2026-10-22: served from NeuralAI's own infrastructure; Render `nae1-inference` runs the same bf16 copy (`sft_v12_2_lora_step12000_bf16/`) as the fallback |
|
| 56 |
+
| **Chat template** | Ships in `sft_v12_2_lora_step12000/tokenizer_config.json`. Turns are `User: ...` / `NeuralAI: ...`; the generation prompt ends `NeuralAI:` with no trailing space (see the SFT section for why) |
|
| 57 |
+
|
| 58 |
+
---
|
| 59 |
+
|
| 60 |
+
## Previous release: SFT v11 (LoRA step-12000)
|
| 61 |
|
| 62 |
| Property | Value |
|
| 63 |
| --- | --- |
|
|
|
|
| 69 |
| **Golden-40 tool-use gate** | **35.5/40 (88.8%) — PASS** (bar 60%). Tool calls 39/40, grounded answers 32/40. Report: `evals/eval_sftv11lora_step12000_golden40.json` |
|
| 70 |
| **Fluency guardrail** | PPL **48.08** on the 50-doc guardrail set vs **47.59** for the step-100000 base on the same set (`evals/eval_sftv11lora_step12000_ppl50_n512.json`). This is a different, smaller set than the 2000-doc set used below — the numbers are not comparable across sets |
|
| 71 |
| **Plain chat + conversation** | v11's headline is real conversation. A new gate set (multiturn12) passes **11/12 with zero cross-topic parroting**: independent questions inside one conversation stay on their own topics, follow-ups and recall-with-distractors work, and tool use survives inside longer transcripts (report: `evals/eval_sftv11lora_step12000_multiturn12.json`). The locked greeting is restored verbatim — "hello" returns "Hey, I'm NeuralAI — how can I help you today?" word-for-word — and v10's fixes hold: "who created you?" names De'Andrew Preston Harris and "what is 2 + 2?" answers "2 + 2 = 4." (smoke report: `evals/eval_sftv11lora_step12000_smoke.json`) |
|
| 72 |
+
| **Weights in this repo** | `sft_v11_lora_step12000/` (safetensors f32, config, tokenizer with chat template) |
|
| 73 |
+
| **Serving** | Served in production on 2026-10-22 until the v12.2 swap the same day |
|
| 74 |
| **Chat template** | Ships in `sft_v11_lora_step12000/tokenizer_config.json`. Turns are `User: ...` / `NeuralAI: ...`; the generation prompt ends `NeuralAI:` with no trailing space (see the SFT section for why) |
|
| 75 |
|
| 76 |
---
|
|
|
|
| 121 |
| **Training** | 80,000 steps. Resumed 60,000 → 80,000 on Kaggle T4, peak LR 6e-4, cosine to a 10% floor |
|
| 122 |
| **Held-out perplexity** | **54.60** native f32 (2000 docs, 1,454,064 tokens, `n_ctx=512`) |
|
| 123 |
| **GGUF f32 / Q4_K_M** | **55.19 / 55.88** on the same 2000 docs (llama.cpp scoring, token counts differ slightly, see below) |
|
| 124 |
+
| **Weights in this repo** | `ckpt_v7_step80000_bf16/` (safetensors, former serving copy — production moved to the SFT line on 2026-10-21: v8, then v9, v10, v11, and v12.2) + `tokenizer_v2/`. GGUF Q4_K_M: `nae1-step80000-Q4_K_M.gguf` |
|
| 125 |
| **License** | Apache 2.0 |
|
| 126 |
|
| 127 |
> **Lineage note.** The v1 run (439-token vocab, 32k steps) is kept below for history. The v2 run rebuilt the tokenizer at 32k and continued training to step 80000. These are different lineages. Do not compare the v1 numbers (for example 54.16) with the v2 numbers. The v2 eval is on the 2000-doc held-out set (`evals/`).
|
|
|
|
| 188 |
| v9 full-FT step-12000 | 33.5/40 | 38/40 | 29/40 | 52.48 | Fail — fluency bar (≤52) missed by 0.48; plain-chat facts not learned |
|
| 189 |
| v9 LoRA step-12000 | 33.5/40 | 39/40 | 28/40 | 47.96 | Pass — released 2026-10-21, superseded by v10 the same day |
|
| 190 |
| v10 LoRA step-12000 | 34.0/40 | 39/40 | 29/40 | 48.01 | Pass — released 2026-10-21, superseded by v11 on 2026-10-22 |
|
| 191 |
+
| v11 LoRA step-12000 | 35.5/40 | 39/40 | 32/40 | 48.08 | Pass — released 2026-10-22, superseded by v12.2 the same day (adds multiturn12 11/12) |
|
| 192 |
+
| **v12.2 LoRA step-12000 (released)** | **35.0/40** | **38/40** | **32/40** | **48.1** | **Pass — selected (date8 7/8, memory6 6/6, casual7 7/7)** |
|
| 193 |
|
| 194 |
**Root cause of the v5–v7 zero calls, proven at token level.** The training kernel's assistant-span mask started after the space in `NeuralAI: `, but the ByteLevel tokenizer fuses that space and the following `»` into a single token (id 4776) — so the first token of every tool call was excluded from the loss in every run, and the models learned the call body conditional on a first token that was never trained. v8 fixes the span, carries a pre-flight assertion (junction token supervised in 7,161 of 7,161 tool traces, confirmed in the training log), and ends the generation prompt at `NeuralAI:` so it tokenizes as a true prefix of the training format. The shipped chat template uses the same junction.
|
| 195 |
|
| 196 |
**Tool protocol.** The assistant emits a call line — `» search("query")`, `» fetch("url")`, or `» read_file("path")`. The host executes the call, returns the result block into the transcript, and the assistant answers from the returned text.
|
| 197 |
|
| 198 |
+
**Known limitations.** General prose is still rough at 100M parameters. v12.2 fixed the date handling that blocked the previous build (date8 3/8 → 7/8, both no-bracket honesty probes clean) and restored the Australia-capital follow-up to Canberra, at no fluency cost (48.1 against the base's 47.59 on the guardrail set). What remains: relative date arithmetic across a month boundary ("tomorrow" after August 31 still repeats August 31 instead of September 1), garbled or vacuous phrasing on some definition and follow-up questions, repetition loops on open-ended prompts at greedy decoding, and live-tool search turns that do not always follow the call-then-answer shape — the search behavior is a genuine model gap, targeted in v13.
|
| 199 |
|
| 200 |
---
|
| 201 |
|
|
|
|
| 211 |
print(out["choices"][0]["text"])
|
| 212 |
```
|
| 213 |
|
| 214 |
+
The GGUF quickstart above loads the pretrained base (step-80000), which has no chat template. For the assistant, use `sft_v12_2_lora_step12000/` with the chat template in its `tokenizer_config.json`.
|
| 215 |
|
| 216 |
---
|
| 217 |
|
| 218 |
## Files
|
| 219 |
|
| 220 |
+
- `model.safetensors` + `config.json` + `tokenizer.json` + `tokenizer_config.json` (repo root): the current v12.2 assistant release, identical to `sft_v12_2_lora_step12000/`
|
| 221 |
+
- `sft_v12_2_lora_step12000/`: current assistant release (SFT v12.2, LoRA merged) — safetensors f32 + tokenizer with chat template
|
| 222 |
+
- `sft_v12_2_lora_step12000_bf16/`: bf16 serving copy of the current assistant release (what production runs)
|
| 223 |
+
- `sft_v11_lora_step12000/`: previous assistant release (SFT v11, LoRA merged) — safetensors f32 + tokenizer with chat template
|
| 224 |
+
- `sft_v11_lora_step12000_bf16/`: bf16 serving copy of the v11 release
|
| 225 |
- `sft_v10_lora_step12000/`: previous assistant release (SFT v10, LoRA merged) — safetensors f32 + tokenizer with chat template
|
| 226 |
- `sft_v10_lora_step12000_bf16/`: bf16 serving copy of the v10 release
|
| 227 |
- `sft_v9_lora_step12000/`: previous assistant release (SFT v9, LoRA merged) — safetensors f32 + tokenizer with chat template
|