Text Generation
GGUF
Safetensors
English
deepseek2
llama.cpp
mixture-of-experts
multi-head-latent-attention
iq4_nl
mark-ai
systems-engineering
custom_code
conversational
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
Download modeling_mark_v3.py from miceworks/Mark-SLM-V3-150M: direct link, hf CLI and curl.
- Browser
- Download file 13.1 kB
-
https://huggingface.co/miceworks/Mark-SLM-V3-150M/resolve/main/modeling_mark_v3.py
- Command line
-
hf download hf://miceworks/Mark-SLM-V3-150M/modeling_mark_v3.py
-
curl -L -o modeling_mark_v3.py https://huggingface.co/miceworks/Mark-SLM-V3-150M/resolve/main/modeling_mark_v3.py
13.1 kB
| """ | |
| Hugging Face Transformers Compatible Modeling Implementation for Mark-SLM-V3-150M | |
| Sparse Mixture-of-Experts (MoE) Architecture with Multi-Head Latent Attention (MLA). | |
| Total parameters: 146,899,248 (< 150M). | |
| """ | |
| import math | |
| from typing import Dict, Optional, Tuple, Union | |
| import torch | |
| import torch.nn as nn | |
| import torch.nn.functional as F | |
| from transformers.modeling_outputs import CausalLMOutputWithPast | |
| from transformers.modeling_utils import PreTrainedModel | |
| try: | |
| from .configuration_mark_v3 import MarkV3Config | |
| except (ImportError, ValueError): | |
| from configuration_mark_v3 import MarkV3Config | |
| class RMSNorm(nn.Module): | |
| def __init__(self, dim: int, eps: float = 1e-6): | |
| super().__init__() | |
| self.eps = eps | |
| self.weight = nn.Parameter(torch.ones(dim)) | |
| def forward(self, x: torch.Tensor) -> torch.Tensor: | |
| orig_dtype = x.dtype | |
| x_f = x.float() | |
| var = torch.mean(x_f.pow(2), dim=-1, keepdim=True) | |
| return (x_f * torch.rsqrt(var + self.eps) * self.weight.float()).to(orig_dtype) | |
| class MarkV3YaRNRotaryEmbedding(nn.Module): | |
| def __init__(self, config: MarkV3Config): | |
| super().__init__() | |
| self.dim = config.qk_rope_head_dim | |
| self.max_seq_len = config.max_position_embeddings | |
| self.base = config.rope_theta | |
| self.scale = config.rope_scaling_factor | |
| inv_freq = 1.0 / (self.base ** (torch.arange(0, self.dim, 2).float() / self.dim)) | |
| inv_freq = inv_freq / self.scale | |
| self.register_buffer("inv_freq", inv_freq, persistent=False) | |
| def forward(self, seq_len: int, device: torch.device) -> Tuple[torch.Tensor, torch.Tensor]: | |
| t = torch.arange(seq_len, device=device, dtype=torch.float32) | |
| inv_freq = self.inv_freq.to(device) | |
| freqs = torch.outer(t, inv_freq) | |
| emb = torch.cat((freqs, freqs), dim=-1) | |
| return emb.cos(), emb.sin() | |
| def rotate_half(x: torch.Tensor) -> torch.Tensor: | |
| x1 = x[..., : x.shape[-1] // 2] | |
| x2 = x[..., x.shape[-1] // 2 :] | |
| return torch.cat((-x2, x1), dim=-1) | |
| def apply_rotary_pos_emb(x: torch.Tensor, cos: torch.Tensor, sin: torch.Tensor) -> torch.Tensor: | |
| # x: (bsz, n_heads, seqlen, head_dim) | |
| seqlen = x.shape[2] | |
| cos = cos[:seqlen].unsqueeze(0).unsqueeze(1) # (1, 1, seqlen, dim) | |
| sin = sin[:seqlen].unsqueeze(0).unsqueeze(1) | |
| return (x * cos) + (rotate_half(x) * sin) | |
| class MarkV3MLA(nn.Module): | |
| def __init__(self, config: MarkV3Config, layer_idx: int): | |
| super().__init__() | |
| self.layer_idx = layer_idx | |
| self.hidden_size = config.hidden_size | |
| self.n_heads = config.num_attention_heads | |
| self.q_lora_rank = config.q_lora_rank | |
| self.kv_lora_rank = config.kv_lora_rank | |
| self.qk_nope_head_dim = config.qk_nope_head_dim | |
| self.qk_rope_head_dim = config.qk_rope_head_dim | |
| self.v_head_dim = config.v_head_dim | |
| self.qk_head_dim = self.qk_nope_head_dim + self.qk_rope_head_dim | |
| # Q LoRA projection | |
| self.wq_a = nn.Linear(self.hidden_size, self.q_lora_rank, bias=False) | |
| self.q_norm = RMSNorm(self.q_lora_rank, eps=config.rms_norm_eps) | |
| self.wq_b = nn.Linear(self.q_lora_rank, self.n_heads * self.qk_head_dim, bias=False) | |
| # KV LoRA projection | |
| self.wkv_a = nn.Linear(self.hidden_size, self.kv_lora_rank + self.qk_rope_head_dim, bias=False) | |
| self.kv_norm = RMSNorm(self.kv_lora_rank, eps=config.rms_norm_eps) | |
| self.wk_b = nn.Linear(self.kv_lora_rank, self.n_heads * self.qk_nope_head_dim, bias=False) | |
| self.wv_b = nn.Linear(self.kv_lora_rank, self.n_heads * self.v_head_dim, bias=False) | |
| self.wo = nn.Linear(self.n_heads * self.v_head_dim, self.hidden_size, bias=False) | |
| self.softmax_scale = 1.0 / math.sqrt(self.qk_head_dim) | |
| def forward( | |
| self, | |
| x: torch.Tensor, | |
| cos: torch.Tensor, | |
| sin: torch.Tensor, | |
| attention_mask: Optional[torch.Tensor] = None, | |
| ) -> torch.Tensor: | |
| bsz, seqlen, _ = x.shape | |
| # Query computation | |
| q_comp = self.wq_a(x) | |
| q_normed = self.q_norm(q_comp) | |
| q = self.wq_b(q_normed).view(bsz, seqlen, self.n_heads, self.qk_head_dim).transpose(1, 2) | |
| q_nope = q[..., : self.qk_nope_head_dim] | |
| q_rope = q[..., self.qk_nope_head_dim :] | |
| q_rope = apply_rotary_pos_emb(q_rope, cos, sin) | |
| q = torch.cat([q_nope, q_rope], dim=-1) | |
| # Key-Value computation | |
| kv_comp = self.wkv_a(x) | |
| c_kv = kv_comp[..., : self.kv_lora_rank] | |
| k_rope = kv_comp[..., self.kv_lora_rank :] | |
| c_kv_normed = self.kv_norm(c_kv) | |
| k_nope = self.wk_b(c_kv_normed).view(bsz, seqlen, self.n_heads, self.qk_nope_head_dim).transpose(1, 2) | |
| v = self.wv_b(c_kv_normed).view(bsz, seqlen, self.n_heads, self.v_head_dim).transpose(1, 2) | |
| k_rope = k_rope.view(bsz, seqlen, 1, self.qk_rope_head_dim).transpose(1, 2) | |
| k_rope = apply_rotary_pos_emb(k_rope, cos, sin) | |
| k_rope = k_rope.expand(-1, self.n_heads, -1, -1) | |
| k = torch.cat([k_nope, k_rope], dim=-1) | |
| # Attention masking | |
| if attention_mask is not None: | |
| if attention_mask.dim() == 2: | |
| causal = torch.triu( | |
| torch.full((seqlen, seqlen), float("-inf"), device=x.device, dtype=q.dtype), | |
| diagonal=1, | |
| ) | |
| pad_4d = (1.0 - attention_mask[:, None, None, :].to(dtype=q.dtype, device=x.device)) * -1e9 | |
| attn_mask = causal + pad_4d | |
| is_causal = False | |
| elif attention_mask.dim() == 4: | |
| attn_mask = attention_mask.to(dtype=q.dtype, device=x.device) | |
| is_causal = False | |
| else: | |
| attn_mask = attention_mask.to(device=x.device) | |
| is_causal = False | |
| else: | |
| attn_mask = None | |
| is_causal = seqlen > 1 | |
| out = F.scaled_dot_product_attention( | |
| q, k, v, | |
| attn_mask=attn_mask, | |
| dropout_p=0.0, | |
| is_causal=is_causal, | |
| scale=self.softmax_scale, | |
| ) | |
| out = out.transpose(1, 2).contiguous().view(bsz, seqlen, self.n_heads * self.v_head_dim) | |
| return self.wo(out) | |
| class MarkV3SwiGLU(nn.Module): | |
| def __init__(self, hidden_size: int, intermediate_size: int): | |
| super().__init__() | |
| self.w_gate = nn.Linear(hidden_size, intermediate_size, bias=False) | |
| self.w_up = nn.Linear(hidden_size, intermediate_size, bias=False) | |
| self.w_down = nn.Linear(intermediate_size, hidden_size, bias=False) | |
| def forward(self, x: torch.Tensor) -> torch.Tensor: | |
| return self.w_down(F.silu(self.w_gate(x)) * self.w_up(x)) | |
| class MarkV3MoE(nn.Module): | |
| def __init__(self, config: MarkV3Config): | |
| super().__init__() | |
| self.hidden_size = config.hidden_size | |
| self.n_routed_experts = config.n_routed_experts | |
| self.n_shared_experts = config.n_shared_experts | |
| self.top_k = config.num_experts_per_tok | |
| self.moe_intermediate_size = config.moe_intermediate_size | |
| self.shared_experts = MarkV3SwiGLU(self.hidden_size, self.moe_intermediate_size * self.n_shared_experts) | |
| self.routed_experts = nn.ModuleList([ | |
| MarkV3SwiGLU(self.hidden_size, self.moe_intermediate_size) | |
| for _ in range(self.n_routed_experts) | |
| ]) | |
| self.router = nn.Linear(self.hidden_size, self.n_routed_experts, bias=False) | |
| self.exp_probs_b = nn.Parameter(torch.zeros(self.n_routed_experts)) | |
| def forward(self, x: torch.Tensor) -> torch.Tensor: | |
| bsz, seqlen, dim = x.shape | |
| x_flat = x.view(-1, dim) | |
| shared_out = self.shared_experts(x_flat) | |
| router_logits = self.router(x_flat) | |
| p = torch.sigmoid(router_logits.float()) | |
| s = p + self.exp_probs_b.unsqueeze(0) | |
| _, topk_idx = torch.topk(s, k=self.top_k, dim=-1, sorted=False) | |
| topk_weights = torch.gather(p, dim=-1, index=topk_idx) | |
| topk_weights = (topk_weights / topk_weights.sum(dim=-1, keepdim=True).clamp(min=1e-6)).to(x.dtype) | |
| routed_out = torch.zeros_like(x_flat) | |
| for e_idx in range(self.n_routed_experts): | |
| token_idx, k_idx = torch.where(topk_idx == e_idx) | |
| if token_idx.numel() > 0: | |
| selected = x_flat[token_idx] | |
| w = topk_weights[token_idx, k_idx].unsqueeze(-1) | |
| exp_out = (w * self.routed_experts[e_idx](selected)).to(routed_out.dtype) | |
| routed_out.index_add_(0, token_idx, exp_out) | |
| return (shared_out + routed_out).view(bsz, seqlen, dim) | |
| class MarkV3Block(nn.Module): | |
| def __init__(self, config: MarkV3Config, layer_idx: int): | |
| super().__init__() | |
| self.attn_norm = RMSNorm(config.hidden_size, eps=config.rms_norm_eps) | |
| self.attn = MarkV3MLA(config, layer_idx=layer_idx) | |
| self.ffn_norm = RMSNorm(config.hidden_size, eps=config.rms_norm_eps) | |
| self.ffn = MarkV3MoE(config) | |
| def forward( | |
| self, | |
| x: torch.Tensor, | |
| cos: torch.Tensor, | |
| sin: torch.Tensor, | |
| attention_mask: Optional[torch.Tensor] = None, | |
| ) -> torch.Tensor: | |
| h = x + self.attn(self.attn_norm(x), cos, sin, attention_mask=attention_mask) | |
| out = h + self.ffn(self.ffn_norm(h)) | |
| return out | |
| class MarkV3PreTrainedModel(PreTrainedModel): | |
| config_class = MarkV3Config | |
| base_model_prefix = "model" | |
| supports_gradient_checkpointing = True | |
| def _init_weights(self, module): | |
| std = 0.02 | |
| if isinstance(module, nn.Linear): | |
| nn.init.normal_(module.weight, mean=0.0, std=std) | |
| if module.bias is not None: | |
| nn.init.zeros_(module.bias) | |
| elif isinstance(module, nn.Embedding): | |
| nn.init.normal_(module.weight, mean=0.0, std=std) | |
| if module.padding_idx is not None: | |
| module.weight.data[module.padding_idx].zero_() | |
| class MarkV3Model(MarkV3PreTrainedModel): | |
| def __init__(self, config: MarkV3Config): | |
| super().__init__(config) | |
| self.config = config | |
| self.embed_tokens = nn.Embedding(config.vocab_size, config.hidden_size, padding_idx=config.pad_token_id) | |
| self.layers = nn.ModuleList([MarkV3Block(config, i) for i in range(config.num_hidden_layers)]) | |
| self.norm = RMSNorm(config.hidden_size, eps=config.rms_norm_eps) | |
| self.rotary_emb = MarkV3YaRNRotaryEmbedding(config) | |
| self.post_init() | |
| def forward( | |
| self, | |
| input_ids: torch.Tensor, | |
| attention_mask: Optional[torch.Tensor] = None, | |
| ) -> torch.Tensor: | |
| bsz, seqlen = input_ids.shape | |
| x = self.embed_tokens(input_ids) | |
| cos, sin = self.rotary_emb(seqlen, device=input_ids.device) | |
| for layer in self.layers: | |
| x = layer(x, cos, sin, attention_mask=attention_mask) | |
| return self.norm(x) | |
| class MarkV3ForCausalLM(MarkV3PreTrainedModel): | |
| _tied_weights_keys = {"lm_head.weight": "model.embed_tokens.weight"} | |
| def __init__(self, config: MarkV3Config): | |
| super().__init__(config) | |
| self.model = MarkV3Model(config) | |
| self.lm_head = nn.Linear(config.hidden_size, config.vocab_size, bias=False) | |
| if config.tie_word_embeddings: | |
| self.lm_head.weight = self.model.embed_tokens.weight | |
| try: | |
| self.post_init() | |
| except (AttributeError, TypeError, Exception): | |
| self.apply(self._init_weights) | |
| self.tie_weights() | |
| def tie_weights(self, *args, **kwargs): | |
| if getattr(self.config, "tie_word_embeddings", True) and hasattr(self, "model") and hasattr(self.model, "embed_tokens"): | |
| self.lm_head.weight = self.model.embed_tokens.weight | |
| def get_input_embeddings(self): | |
| return self.model.embed_tokens | |
| def set_input_embeddings(self, value): | |
| self.model.embed_tokens = value | |
| def get_output_embeddings(self): | |
| return self.lm_head | |
| def set_output_embeddings(self, new_embeddings): | |
| self.lm_head = new_embeddings | |
| def forward( | |
| self, | |
| input_ids: torch.Tensor, | |
| attention_mask: Optional[torch.Tensor] = None, | |
| labels: Optional[torch.Tensor] = None, | |
| return_dict: Optional[bool] = True, | |
| **kwargs, | |
| ) -> Union[CausalLMOutputWithPast, Tuple[torch.Tensor, ...]]: | |
| h = self.model(input_ids, attention_mask=attention_mask) | |
| logits = self.lm_head(h) | |
| loss = None | |
| if labels is not None: | |
| # Shift internally so that tokens < n predict n | |
| shift_logits = logits[..., :-1, :].contiguous() | |
| shift_labels = labels[..., 1:].contiguous() | |
| loss_fct = nn.CrossEntropyLoss() | |
| loss = loss_fct(shift_logits.view(-1, self.config.vocab_size), shift_labels.view(-1)) | |
| if not return_dict: | |
| output = (logits,) | |
| return ((loss,) + output) if loss is not None else output | |
| return CausalLMOutputWithPast( | |
| loss=loss, | |
| logits=logits, | |
| past_key_values=None, | |
| hidden_states=None, | |
| attentions=None, | |
| ) | |