Instructions to use miceworks/Mark-SLM-V3-150M 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 miceworks/Mark-SLM-V3-150M 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 miceworks/Mark-SLM-V3-150M:IQ4_NL # Run inference directly in the terminal: llama cli -hf miceworks/Mark-SLM-V3-150M:IQ4_NL
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf miceworks/Mark-SLM-V3-150M:IQ4_NL # Run inference directly in the terminal: llama cli -hf miceworks/Mark-SLM-V3-150M:IQ4_NL
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf miceworks/Mark-SLM-V3-150M:IQ4_NL # Run inference directly in the terminal: ./build/bin/llama cli -hf miceworks/Mark-SLM-V3-150M:IQ4_NL
Use Docker
docker model run hf.co/miceworks/Mark-SLM-V3-150M:IQ4_NL
- Llama new
- LM Studio
- Jan
- vLLM
How to use miceworks/Mark-SLM-V3-150M with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "miceworks/Mark-SLM-V3-150M" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "miceworks/Mark-SLM-V3-150M", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/miceworks/Mark-SLM-V3-150M:IQ4_NL
- Ollama
How to use miceworks/Mark-SLM-V3-150M with Ollama:
ollama run hf.co/miceworks/Mark-SLM-V3-150M:IQ4_NL
- Unsloth Desktop
- Docker Model Runner
How to use miceworks/Mark-SLM-V3-150M with Docker Model Runner:
docker model run hf.co/miceworks/Mark-SLM-V3-150M:IQ4_NL
- Lemonade
How to use miceworks/Mark-SLM-V3-150M with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull miceworks/Mark-SLM-V3-150M:IQ4_NL
Run and chat with the model
lemonade run user.Mark-SLM-V3-150M-IQ4_NL
List all available models
lemonade list
- Atomic Chat
Mark-SLM-V3-150M
Overview
Mark-SLM-V3-150M is a 150M-parameter experimental sparse language model trained on 3.47M tokens (miceworks/Mark-Open-SLM-Curriculum), achieving an in-distribution Intelligence Index of 16.36 on the Open SLM Leaderboard (PR #291). It is an architectural research testbed for Multi-Head Latent Attention (MLA) and fine-grained MoE on 8 GB GPUs, NOT a general-purpose conversational or multilingual assistant.
The exported GGUF container (mark_slm_v3_150m_iq4_nl.gguf, 90.37 MiB / 94.76 MB / 94,764,576 bytes) implements 15 physical deepseek2 blocks (layers 0-1 dense, layers 2-14 MoE with 16 routed + 1 shared expert, top-2 active). The architecture comprises 146,899,248 unique parameters (excluding tied output.weight) and 165,349,680 materialized GGUF parameters across 273 tensors (including the materialized output.weight copy).
Specifications
| Field | Value |
|---|---|
| Architecture | deepseek2 |
| Training Status | TRAINED_CHECKPOINT |
| Weight State Label | Trained Checkpoint (Model Soup 50/50) |
| Binary Size | 90.37 MiB (94.76 MB / 94,764,576 bytes) |
| Total Parameters | 146,899,248 unique parameters (165,349,680 materialized GGUF parameters across 273 tensors) |
| Active Parameters | 54,001,968 (54001968 active) |
| Vocabulary Size | 32032 |
| Layers | 15 physical deepseek2 blocks (layers 0-1 dense, layers 2-14 MoE) |
| Hidden Dimension | 576 |
| Attention Heads | 9 |
| MLA Ranks | q_lora_rank=256, kv_lora_rank=128, qk_rope_head_dim=64 |
| MoE Experts | 16 routed, 1 shared (2 active/token) |
| Expert FFN Dim | 256 |
| Context Length | 8192 tokens |
| Quantization Type | IQ4_NL (4-bit non-linear) |
| SHA-256 | 4bbfe2dc3fc7a6ac895d56e30352bda0de1322f9826afa28cafe7d24b0e99632 |
Architecture
Multi-Head Latent Attention (MLA)
The model projects key and value states into a shared low-rank latent representation to decouple memory scaling from context length:
c_KV = h_t * W_DKV (dim: 128)
c_Q = h_t * W_DQ (dim: 256)
q_C = RMSNorm(c_Q * W_UQ)
k_C = RMSNorm(c_KV * W_UK)
Decoupled rotary position embeddings are concatenated along a separate dimension:
k_R = RoPE(h_t * W_KR) (dim: 64)
q_t = [q_C ; q_R]
k_t = [k_C ; k_R]
KV Cache Memory Usage
Physical memory consumption of the KV cache per token in FP16:
KV_bytes_per_token = 15 * (128 + 64) * 2 = 5,760 bytes/token
| Context Window | MLA KV Cache | Standard MHA KV Cache | Memory Savings |
|---|---|---|---|
| 4,096 tokens | 22.50 MiB | 135.00 MiB | 6.0x |
| 8,192 tokens | 45.00 MiB | 270.00 MiB | 6.0x |
| 32,768 tokens | 180.00 MiB | 1080.00 MiB | 6.0x |
Mixture-of-Experts (Aux-Loss-Free Routing)
- Shared Experts (1S): Constantly active path for common representations: $$F_{\text{shared}}(x) = (\text{SiLU}(x W_{\text{gate}}) \odot (x W_{\text{up}})) W_{\text{down}}$$
- Routed Experts (16R, Top-2): Routed using token-to-expert affinities $s_{i,t} = \sigma(u_t^T e_i)$ over biased scores $s_{i,t} + b_i$, where router bias vectors (
blk.{l}.exp_probs_b.bias) are stored in FP32 precision.
Aux-Loss-Free Routing Equation
Router biases update per step to prevent expert collapse without penalizing primary task loss using the exact sign-based rule:
where $\gamma = 0.001$, $f_i$ is empirical expert frequency within the batch, and $\bar{f}$ is target uniform frequency.
Router bias vectors (blk.{l}.exp_probs_b.bias) are stored in FP32 precision. Measured disk telemetry from the IQ4_NL container:
- Bias Parameters: 208 FP32 parameters across 13 MoE layers (layers 2 to 14, 16 routed experts each; layers 0 and 1 are dense SwiGLU blocks)
- Measured Values: min = 0.8677, mean = 1.3500, max = 2.0547
Training Pipeline and Reproducibility
- Training Code: Official pipelines and architecture implementations are maintained in the Mark-AI scripts directory.
- Curricula and Datasets: Trained on open datasets hosted on the Hugging Face Hub, including miceworks/Mark-Open-SLM-Curriculum, miceworks/Mark-Cyber-Curriculum, and miceworks/Mark-Ultra-Curriculum.
- Optimization Settings: AdamW optimizer ($\beta_1 = 0.9, \beta_2 = 0.95$, weight decay $0.1$, gradient clipping $1.0$).
- Training Scope: Trained model checkpoint (TRAINED_CHECKPOINT). The model was trained through 25,000 optimization steps of pre-training followed by 4,000 steps of Phase 2 Cooldown on miceworks/Mark-Open-SLM-Curriculum (3.47M tokens), consolidated via 50/50 Model Soup (Weight Averaging). Disclosure:
miceworks/Mark-Open-SLM-Curriculumcontains training splits from HellaSwag, PIQA, ARC, SciQ, and ArithMark (permitted by Open SLM Leaderboard rules), so the reported scores measure in-distribution curriculum learning rather than general out-of-distribution capability. Evaluated on the official Open SLM Leaderboard benchmark suite, achieving an Intelligence Index of 16.36 in PR #291 (https://huggingface.co/spaces/AxiomicLabs/Open_SLM_Leaderboard/discussions/291).
Evaluation and Benchmark Results
Official Open SLM Leaderboard Scores (PR #291, Rule 01 and Rule 02 compliant):
- PIQA: 62.50% (Norm: 25.00%)
- ARC-Easy: 40.80% (Norm: 21.07%)
- HellaSwag: 37.10% (Norm: 16.13%)
- ArithMark-3.0 Official: 33.90% (Norm: 11.87%)
- ARC-Challenge: 25.50% (Norm: 0.67%)
- ARC-Average (Norm): 10.87%
- AxiomicLabs Intelligence Index: 16.36
Note: Because miceworks/Mark-Open-SLM-Curriculum incorporates official training splits from HellaSwag, PIQA, ARC, SciQ, and procedural ArithMark, these scores reflect in-distribution curriculum learning rather than broad zero-shot out-of-distribution generalization.
Checkpoint Revision Changelog:
- Revision 1 (Step 25,000 Base Checkpoint): Intelligence Index 10.04
- Revision 2 (Step 4,000 Cooldown Checkpoint): Intelligence Index 14.35
- Revision 3 (Model Soup 50/50 Final, 25k Base + 4k Cooldown): Intelligence Index 16.36 (Submitted in PR #291)
Tokenizer and Vocabulary Specification
- Vocabulary Size:
32032active BPE tokens (58,980 merges, 0 padding tokens) - Architecture Backend: Byte-level Byte-Pair Encoding (BPE) with GPT-2 byte fallbacks
- Epistemic Control Tokens: Self-RAG reasoning tags (
<think>,</think>), tool delimiters (<tool_call>,</tool_call>), epistemic reflection tags ([RETRIEVE],[/RETRIEVE],[EVALUATE],[ACCEPT],[REJECT]) - Measured Compression Fertility:
- English technical prose: $\approx 5.85\text{ characters/token}$
- Portuguese technical prose: $\approx 3.17\text{ characters/token}$
- C, Rust, and systems source code: $\approx 2.23\text{ characters/token}$
- Whitespace Round-Trip Fidelity: 100% lossless preservation of leading spaces, indentation tabs, and byte streams.
Limitations and Intended Use
- Architectural Research Scope: This model is an experimental architectural testbed for Multi-Head Latent Attention (MLA) and fine-grained MoE on 8 GB GPUs such as NVIDIA GeForce RTX 2060 Super (8 GB GDDR6, 256-bit, 448 GB/s), NOT a general-purpose conversational or multilingual assistant.
- In-Distribution Curriculum Learning: Benchmark scores on
Mark-SLM-V3-150Mmeasure in-distribution learning onmiceworks/Mark-Open-SLM-Curriculum(which includes official benchmark training splits permitted under Open SLM Leaderboard rules) rather than open-ended out-of-distribution generalization. - Parameter Scale Constraints: Absolute world knowledge and zero-shot reasoning capacity are bounded by compact parameter counts.
Running Benchmarks on TPN Workbench and lm-evaluation-harness
When running automated benchmarks on TPN Workbench, lm-evaluation-harness, LM Studio, or Hugging Face evaluation runners:
- Select Format: gguf (or Backend: llama.cpp).
- Do not evaluate via raw Python
transformerswithsafetensorsortrust_remote_code=True, because the nativedeepseek2MLA and fine-grained 3D MoE graph executes directly inside the C++/CUDA kernels ofllama.cpp.
Usage
Download
# Download GGUF and Modelfile using huggingface-cli
huggingface-cli download miceworks/Mark-SLM-V3-150M mark_slm_v3_150m_iq4_nl.gguf Modelfile --local-dir .
# Or using Python
from huggingface_hub import hf_hub_download
hf_hub_download(repo_id="miceworks/Mark-SLM-V3-150M", filename="mark_slm_v3_150m_iq4_nl.gguf")
Cryptographic Verification
echo "4bbfe2dc3fc7a6ac895d56e30352bda0de1322f9826afa28cafe7d24b0e99632 mark_slm_v3_150m_iq4_nl.gguf" | sha256sum -c -
llama.cpp Execution
# Direct CLI completion
llama-cli -m mark_slm_v3_150m_iq4_nl.gguf \
-p "Question: What is 12 * 12?\nAnswer:" \
-n 64 --temp 0.2
# Local HTTP server
llama-server -m mark_slm_v3_150m_iq4_nl.gguf --port 8080 -c 8192
Local Ollama Registration
# Create local model from downloaded Modelfile
ollama create mark-slm-150m -f Modelfile
ollama run mark-slm-150m "Question: What is 12 * 12? Answer:"
Python Inspection
import gguf
reader = gguf.GGUFReader("mark_slm_v3_150m_iq4_nl.gguf")
print("Architecture:", reader.get_field("general.architecture"))
print("Total Tensors:", len(reader.tensors))
total_params = sum(int(t.shape.prod()) for t in reader.tensors)
print(f"Materialized GGUF Parameters: {total_params:,}")
- Downloads last month
- 7,535
4-bit