Instructions to use miceworks/Mark-Engineer-V2-8B 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-Engineer-V2-8B 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-Engineer-V2-8B:IQ4_NL # Run inference directly in the terminal: llama cli -hf miceworks/Mark-Engineer-V2-8B: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-Engineer-V2-8B:IQ4_NL # Run inference directly in the terminal: llama cli -hf miceworks/Mark-Engineer-V2-8B: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-Engineer-V2-8B:IQ4_NL # Run inference directly in the terminal: ./build/bin/llama cli -hf miceworks/Mark-Engineer-V2-8B:IQ4_NL
Use Docker
docker model run hf.co/miceworks/Mark-Engineer-V2-8B:IQ4_NL
- Llama new
- LM Studio
- Jan
- vLLM
How to use miceworks/Mark-Engineer-V2-8B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "miceworks/Mark-Engineer-V2-8B" # 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-Engineer-V2-8B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/miceworks/Mark-Engineer-V2-8B:IQ4_NL
- Ollama
How to use miceworks/Mark-Engineer-V2-8B with Ollama:
ollama run hf.co/miceworks/Mark-Engineer-V2-8B:IQ4_NL
- Unsloth Desktop
- Docker Model Runner
How to use miceworks/Mark-Engineer-V2-8B with Docker Model Runner:
docker model run hf.co/miceworks/Mark-Engineer-V2-8B:IQ4_NL
- Lemonade
How to use miceworks/Mark-Engineer-V2-8B with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull miceworks/Mark-Engineer-V2-8B:IQ4_NL
Run and chat with the model
lemonade run user.Mark-Engineer-V2-8B-IQ4_NL
List all available models
lemonade list
- Atomic Chat
Mark-Engineer-V2-8B
Overview
Mark-Engineer-V2-8B is an 8B-class sparse Transformer featuring 32 layers, 24 routed experts, and 1 shared expert with a 49,152 token vocabulary. It has 8,258,809,040 total parameters and activates 1,770,745,040 parameters per token (21.44% active).
In native IQ4_NL quantization, the container occupies 4431.26 MiB (4646.52 MB / 4,646,516,576 bytes), fitting inside a single 8 GB consumer GPU with over 3.3 GB of VRAM remaining for KV cache and scratch space.
Specifications
| Field | Value |
|---|---|
| Architecture | deepseek2 |
| Weight State | UN-TRAINED_ARCHITECTURAL_BASE |
| Binary Size | 4431.26 MiB (4646.52 MB / 4,646,516,576 bytes) |
| Total Parameters | 8,258,809,040 (8258809040 physical) |
| Active Parameters | 1,770,745,040 (1770745040 active) |
| Vocabulary Size | 49152 |
| Layers | 32 |
| Hidden Dimension | 2560 |
| Attention Heads | 32 |
| MLA Ranks | q_lora_rank=1024, kv_lora_rank=512, qk_rope_head_dim=32 |
| MoE Experts | 24 routed, 1 shared (2 active/token) |
| Expert FFN Dim | 1280 |
| Context Length | 8192 tokens |
| Tensor Count | 569 |
| Quantization Types | {'IQ4_NL': 410, 'F32': 159} |
| SHA-256 | 28c014b5b903f7e21ee9777ef743030c7a068111c923baeb33d5f05685e05400 |
Architecture
Multi-Head Latent Attention (MLA)
The model projects key and value states into a shared low-rank latent representation to reduce KV cache memory:
c_KV = h_t * W_DKV (dim: 512)
c_Q = h_t * W_DQ (dim: 1024)
q_C = RMSNorm(c_Q * W_UQ)
k_C = RMSNorm(c_KV * W_UK)
Decoupled rotary position embeddings are concatenated along a separate dimension to track token positions:
k_R = RoPE(h_t * W_KR) (dim: 32)
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:
KV_bytes_per_token = 32 * (512 + 32) * 2 = 34,816 bytes/token
| Context Window | MLA KV Cache | Standard MHA KV Cache | Memory Savings |
|---|---|---|---|
| 4,096 tokens | 136.00 MiB | 1280.00 MiB | 9.4x |
| 8,192 tokens | 272.00 MiB | 2560.00 MiB | 9.4x |
| 32,768 tokens | 1088.00 MiB | 10240.00 MiB | 9.4x |
Mixture-of-Experts (MoE)
- Shared Experts (1S): Constantly active path for common features:
F_shared(x) = (SiLU(x * W_gate) * (x * W_up)) * W_down - Routed Experts (24R, Top-2): Routed using learned bias offsets without auxiliary load balancing loss:
s_{t,e} = Softmax(x_t * W_router + b_e)y = x + F_shared(x) + sum_{i in TopK} g_i * F_routed_i(x)
Quantization
The model is quantized to GGML_TYPE_IQ4_NL (4-bit non-linear) within the native deepseek2 GGUF container:
- Linear weights are structured in 18-byte blocks for each group of 32 weights:
- 2 bytes: Half-precision (
FP16) scale factord. - 16 bytes: 32 four-bit nibbles referencing the non-linear lookup table
kvalues_iq4nl:[-127, -104, -83, -65, -49, -35, -22, -10, 1, 13, 25, 38, 53, 69, 89, 113]
- 2 bytes: Half-precision (
- 1D normalization weights (
*_norm.weight) and router bias vectors (exp_probs_b.bias) remain in full precisionFP32to preserve numerical accuracy at layer boundaries. - Routed MoE weights are serialized as contiguous 3D tensors (
blk.{i}.ffn_gate_exps.weight,blk.{i}.ffn_up_exps.weight,blk.{i}.ffn_down_exps.weight), avoiding tensor splitting and kernel overhead.
Training Status
Untrained architectural base (UN-TRAINED_ARCHITECTURAL_BASE). The GGUF file contains initialized weights for testing binary graph compatibility with llama.cpp, measuring memory usage on target hardware, and serving as a base for downstream pre-training and fine-tuning.
All reported metrics represent physical parameter counts and deterministic SHA-256 checksums from the GGUF binary.
Usage
Download
# Using huggingface-cli
huggingface-cli download miceworks/Mark-Engineer-V2-8B mark_engineer_v2_8b_iq4_nl.gguf --local-dir .
# Using Python
from huggingface_hub import hf_hub_download
hf_hub_download(repo_id="miceworks/Mark-Engineer-V2-8B", filename="mark_engineer_v2_8b_iq4_nl.gguf")
Cryptographic Verification
echo "28c014b5b903f7e21ee9777ef743030c7a068111c923baeb33d5f05685e05400 mark_engineer_v2_8b_iq4_nl.gguf" | sha256sum -c -
Ollama
# Modelfile
FROM ./mark_engineer_v2_8b_iq4_nl.gguf
TEMPLATE """{{ if .System }}<|bos|>System: {{ .System }}<|eos|>
{{ end }}{{ if .Prompt }}<|bos|>User: {{ .Prompt }}<|eos|>
{{ end }}<|bos|>Assistant:
<think>
"""
PARAMETER stop "<|eos|>"
PARAMETER temperature 0.3
PARAMETER top_p 0.95
PARAMETER repeat_penalty 1.1
SYSTEM """You are Mark-Engineer-V2-8B, a systems-focused neural model."""
ollama create mark-engineer-v2-8b -f Modelfile
ollama run mark-engineer-v2-8b
llama.cpp
# CLI generation
llama-cli -m mark_engineer_v2_8b_iq4_nl.gguf \
-p "<|bos|>System: Systems mode active.<|eos|>\n<|bos|>User: Explain Linux memory barriers.<|eos|>\n<|bos|>Assistant:\n<think>\n" \
-n 512 --temp 0.2
# HTTP server
llama-server -m mark_engineer_v2_8b_iq4_nl.gguf --port 8080 -c 8192
Python Inspection
import gguf
reader = gguf.GGUFReader("mark_engineer_v2_8b_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"Total Parameters: {total_params:,}")
- Downloads last month
- 941
4-bit