inspector / ir /artifacts /deepseek_v2.json
lysandre's picture
lysandre HF Staff
Deploy architecture inspector
ed5700a verified
Raw
History Blame Contribute Delete
16.5 kB
{
"architecture": {
"attention_variant": "MLA",
"family": "causal_lm",
"is_moe": true,
"mixer": "attention",
"moe": {
"num_experts": 64,
"num_shared_experts": 2
},
"positional": "rope",
"tie_word_embeddings": false,
"view": "decoder"
},
"capabilities": {
"attention_backends": [
"eager",
"sdpa",
"flash_attention",
"flex_attention"
],
"attention_patterns": [
"causal"
],
"attention_schedule": null,
"kernels": {
"RMSNorm": [
"kernels-community/liger-kernels",
"kernels-community/rmsnorm",
"kernels-community/mlx_rmsnorm"
]
},
"task_heads": [
"causal_lm",
"sequence_classification"
],
"tensor_parallel": true
},
"components": [
{
"children": [
"embed_tokens",
"decoder_layers",
"norm",
"rotary_emb"
],
"class_name": "DeepseekV2Model",
"id": "model",
"kind": "model",
"path_pattern": "model"
},
{
"attributes": {
"embedding_dim": "config.hidden_size",
"num_embeddings": "config.vocab_size",
"tied_lm_head": false
},
"class_name": "Embedding",
"id": "embed_tokens",
"kind": "embedding",
"path_pattern": "model.embed_tokens"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV2RMSNorm",
"id": "norm",
"kind": "normalization",
"path_pattern": "model.norm"
},
{
"attributes": {
"head_dim": "config.head_dim",
"rope_theta": 10000.0,
"scheme": "rope"
},
"class_name": "DeepseekV2RotaryEmbedding",
"id": "rotary_emb",
"kind": "position",
"path_pattern": "model.rotary_emb"
}
],
"config": {
"class_name": "DeepseekV2Config",
"model_type": "deepseek_v2",
"module": "transformers.models.deepseek_v2.configuration_deepseek_v2",
"referenced_fields": {
"num_hidden_layers": 32
},
"salient_fields": {
"head_dim": 64,
"hidden_act": "silu",
"hidden_size": 4096,
"intermediate_size": 11008,
"is_encoder_decoder": false,
"max_position_embeddings": 2048,
"num_attention_heads": 32,
"num_hidden_layers": 32,
"num_key_value_heads": 32,
"tie_word_embeddings": false,
"vocab_size": 32000
}
},
"edges": [
{
"kind": "data",
"source": "embed_tokens",
"target": "decoder_layers"
},
{
"kind": "data",
"source": "decoder_layers",
"target": "norm"
},
{
"kind": "data",
"source": "decoder_layer.input_layernorm",
"target": "decoder_layer.post_attention_layernorm"
},
{
"kind": "mask",
"source": "input:attention_mask",
"target": "decoder_layer.self_attn"
},
{
"kind": "residual",
"source": "decoder_layer",
"target": "decoder_layer.self_attn"
},
{
"kind": "position",
"source": "rotary_emb",
"target": "decoder_layer.self_attn"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn",
"target": "decoder_layer.self_attn.q_a_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn",
"target": "decoder_layer.self_attn.q_b_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn",
"target": "decoder_layer.self_attn.kv_a_proj_with_mqa"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn",
"target": "decoder_layer.self_attn.kv_b_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn.q_a_proj",
"target": "decoder_layer.self_attn.o_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn.q_b_proj",
"target": "decoder_layer.self_attn.o_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn.kv_a_proj_with_mqa",
"target": "decoder_layer.self_attn.o_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.self_attn.kv_b_proj",
"target": "decoder_layer.self_attn.o_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.shared_experts",
"target": "decoder_layer.mlp.shared_experts.gate_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.shared_experts",
"target": "decoder_layer.mlp.shared_experts.up_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.shared_experts.gate_proj",
"target": "decoder_layer.mlp.shared_experts.down_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.shared_experts.up_proj",
"target": "decoder_layer.mlp.shared_experts.down_proj"
},
{
"kind": "cache_read",
"source": "state:kv_cache",
"target": "decoder_layer.self_attn"
},
{
"kind": "cache_write",
"source": "decoder_layer.self_attn",
"target": "state:kv_cache"
},
{
"kind": "route",
"source": "decoder_layer.mlp",
"target": "decoder_layer.mlp.experts"
},
{
"kind": "route",
"source": "decoder_layer.mlp",
"target": "decoder_layer.mlp.shared_experts"
},
{
"kind": "route",
"source": "decoder_layer.mlp.shared_experts",
"target": "decoder_layer.mlp.shared_experts.gate_proj"
},
{
"kind": "route",
"source": "decoder_layer.mlp.shared_experts",
"target": "decoder_layer.mlp.shared_experts.up_proj"
},
{
"kind": "route",
"source": "decoder_layer.mlp.shared_experts",
"target": "decoder_layer.mlp.shared_experts.down_proj"
}
],
"extends": "llama",
"model_type": "deepseek_v2",
"patches": [
{
"added": {
"attrs": [
"attention_bias",
"attention_dropout",
"attribute_map",
"base_model_ep_plan",
"base_model_tp_plan",
"bos_token_id",
"eos_token_id",
"first_k_dense_replace",
"hidden_act",
"hidden_size",
"initializer_range",
"intermediate_size",
"keys_to_ignore_at_inference",
"kv_lora_rank",
"max_position_embeddings",
"mlp_bias",
"model_type",
"moe_intermediate_size",
"n_group",
"n_routed_experts",
"n_shared_experts",
"norm_topk_prob",
"num_attention_heads",
"num_experts_per_tok",
"num_hidden_layers",
"num_key_value_heads",
"pad_token_id",
"q_lora_rank",
"qk_nope_head_dim",
"qk_rope_head_dim",
"rms_norm_eps",
"rope_parameters",
"routed_scaling_factor",
"tie_word_embeddings",
"topk_group",
"topk_method",
"use_cache",
"v_head_dim",
"vocab_size"
],
"methods": [
"__post_init__"
]
},
"component_kind": "config",
"parent_class": "LlamaConfig",
"relation": "new",
"target_class": "DeepseekV2Config"
},
{
"component_kind": "moe",
"overridden": {
"methods": [
"__init__",
"forward"
]
},
"parent_class": "Qwen2MoeTopKRouter",
"parent_model": "qwen2_moe",
"relation": "inherits",
"target_class": "DeepseekV2TopkRouter"
},
{
"added": {
"methods": [
"__init__",
"forward"
]
},
"component_kind": "moe",
"parent_class": "Module",
"relation": "new",
"target_class": "DeepseekV2Moe"
},
{
"component_kind": "feed_forward",
"overridden": {
"methods": [
"__init__"
]
},
"parent_class": "LlamaMLP",
"relation": "inherits",
"target_class": "DeepseekV2MLP"
},
{
"component_kind": "position",
"overridden": {
"methods": [
"forward"
]
},
"parent_class": "LlamaRotaryEmbedding",
"relation": "inherits",
"target_class": "DeepseekV2RotaryEmbedding"
},
{
"added": {
"methods": [
"__init__",
"forward"
]
},
"component_kind": "attention",
"parent_class": "Module",
"relation": "new",
"target_class": "DeepseekV2Attention"
},
{
"component_kind": "transformer_block",
"overridden": {
"methods": [
"__init__"
]
},
"parent_class": "LlamaDecoderLayer",
"relation": "inherits",
"target_class": "DeepseekV2DecoderLayer"
},
{
"added": {
"methods": [
"_init_weights"
]
},
"component_kind": "model",
"parent_class": "LlamaPreTrainedModel",
"relation": "inherits",
"target_class": "DeepseekV2PreTrainedModel"
}
],
"provenance": {
"config_class": "DeepseekV2Config",
"config_module": "transformers.models.deepseek_v2.configuration_deepseek_v2",
"model_class": "DeepseekV2Model",
"model_module": "transformers.models.deepseek_v2.modeling_deepseek_v2"
},
"repeats": [
{
"body": "decoder_layer",
"container_path_pattern": "model.layers",
"count": 32,
"count_expr": "config.num_hidden_layers",
"count_source": "config",
"id": "decoder_layers",
"index_symbol": "i",
"item_path_pattern": "model.layers.{i}",
"kind": "symbolic_repeat",
"provenance": {
"class_name": "DeepseekV2DecoderLayer",
"container_path_pattern": "model.layers",
"item_path_pattern": "model.layers.{i}",
"source": "module_tree_repeat_collapse"
},
"repeated_class_name": "DeepseekV2DecoderLayer"
}
],
"schema_version": "architecture-template-v0",
"templates": [
{
"children": [
"decoder_layer.self_attn",
"decoder_layer.mlp",
"decoder_layer.input_layernorm",
"decoder_layer.post_attention_layernorm"
],
"class_name": "DeepseekV2DecoderLayer",
"id": "decoder_layer",
"kind": "transformer_block",
"path_pattern": "model.layers.{i}"
},
{
"attributes": {
"head_dim": 64,
"n_heads": 32,
"n_kv_heads": 32,
"pattern": "causal",
"rope": true,
"variant": "MLA"
},
"children": [
"decoder_layer.self_attn.q_a_proj",
"decoder_layer.self_attn.q_a_layernorm",
"decoder_layer.self_attn.q_b_proj",
"decoder_layer.self_attn.kv_a_proj_with_mqa",
"decoder_layer.self_attn.kv_a_layernorm",
"decoder_layer.self_attn.kv_b_proj",
"decoder_layer.self_attn.o_proj"
],
"class_name": "DeepseekV2Attention",
"id": "decoder_layer.self_attn",
"kind": "attention",
"path_pattern": "model.layers.{i}.self_attn"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": 1536
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.q_a_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.q_a_proj"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV2RMSNorm",
"id": "decoder_layer.self_attn.q_a_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.self_attn.q_a_layernorm"
},
{
"attributes": {
"in_features": 1536,
"out_features": 6144,
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.q_b_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.q_b_proj"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": 576,
"tp": "mla_kv_a_proj"
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.kv_a_proj_with_mqa",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.kv_a_proj_with_mqa"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV2RMSNorm",
"id": "decoder_layer.self_attn.kv_a_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.self_attn.kv_a_layernorm"
},
{
"attributes": {
"in_features": 512,
"out_features": 8192,
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.kv_b_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.kv_b_proj"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": "config.hidden_size",
"tp": "rowwise"
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.o_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.o_proj"
},
{
"attributes": {
"num_experts": 64,
"num_shared_experts": 2
},
"children": [
"decoder_layer.mlp.experts",
"decoder_layer.mlp.gate",
"decoder_layer.mlp.shared_experts"
],
"class_name": "DeepseekV2Moe",
"id": "decoder_layer.mlp",
"kind": "moe",
"path_pattern": "model.layers.{i}.mlp"
},
{
"attributes": {
"num_experts": 64,
"num_shared_experts": 2
},
"class_name": "DeepseekV2Experts",
"id": "decoder_layer.mlp.experts",
"kind": "moe",
"path_pattern": "model.layers.{i}.mlp.experts"
},
{
"attributes": {
"num_experts": 64,
"num_shared_experts": 2
},
"class_name": "DeepseekV2TopkRouter",
"id": "decoder_layer.mlp.gate",
"kind": "moe",
"path_pattern": "model.layers.{i}.mlp.gate"
},
{
"attributes": {
"num_experts": 64,
"num_shared_experts": 2
},
"children": [
"decoder_layer.mlp.shared_experts.gate_proj",
"decoder_layer.mlp.shared_experts.up_proj",
"decoder_layer.mlp.shared_experts.down_proj"
],
"class_name": "DeepseekV2MLP",
"id": "decoder_layer.mlp.shared_experts",
"kind": "moe",
"path_pattern": "model.layers.{i}.mlp.shared_experts"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": 2814,
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.shared_experts.gate_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.shared_experts.gate_proj"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": 2814,
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.shared_experts.up_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.shared_experts.up_proj"
},
{
"attributes": {
"in_features": 2814,
"out_features": "config.hidden_size",
"tp": "rowwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.shared_experts.down_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.shared_experts.down_proj"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV2RMSNorm",
"id": "decoder_layer.input_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.input_layernorm"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV2RMSNorm",
"id": "decoder_layer.post_attention_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.post_attention_layernorm"
}
]
}