inspector / ir /artifacts /deepseek_v3.json
lysandre's picture
lysandre HF Staff
Deploy architecture inspector
ed5700a verified
Raw
History Blame Contribute Delete
13.7 kB
{
"architecture": {
"attention_variant": "MLA",
"family": "causal_lm",
"is_moe": true,
"mixer": "attention",
"moe": {
"experts_per_token": 8,
"num_experts": 256,
"num_shared_experts": 1
},
"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",
"token_classification"
],
"tensor_parallel": true
},
"components": [
{
"children": [
"embed_tokens",
"decoder_layers",
"norm",
"rotary_emb"
],
"class_name": "DeepseekV3Model",
"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": "DeepseekV3RMSNorm",
"id": "norm",
"kind": "normalization",
"path_pattern": "model.norm"
},
{
"attributes": {
"head_dim": "config.head_dim",
"rope_theta": 10000.0,
"scheme": "rope"
},
"class_name": "DeepseekV3RotaryEmbedding",
"id": "rotary_emb",
"kind": "position",
"path_pattern": "model.rotary_emb"
}
],
"config": {
"class_name": "DeepseekV3Config",
"model_type": "deepseek_v3",
"module": "transformers.models.deepseek_v3.configuration_deepseek_v3",
"referenced_fields": {
"num_hidden_layers": 61
},
"salient_fields": {
"head_dim": 64,
"hidden_act": "silu",
"hidden_size": 7168,
"intermediate_size": 18432,
"is_encoder_decoder": false,
"max_position_embeddings": 4096,
"num_attention_heads": 128,
"num_hidden_layers": 61,
"num_key_value_heads": 128,
"tie_word_embeddings": false,
"vocab_size": 129280
}
},
"edges": [
{
"kind": "data",
"source": "embed_tokens",
"target": "decoder_layers"
},
{
"kind": "data",
"source": "decoder_layers",
"target": "norm"
},
{
"kind": "data",
"source": "decoder_layer.self_attn",
"target": "decoder_layer.mlp"
},
{
"kind": "data",
"source": "decoder_layer.mlp",
"target": "decoder_layer.input_layernorm"
},
{
"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": "residual",
"source": "decoder_layer",
"target": "decoder_layer.mlp"
},
{
"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",
"target": "decoder_layer.mlp.gate_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp",
"target": "decoder_layer.mlp.up_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.gate_proj",
"target": "decoder_layer.mlp.down_proj"
},
{
"kind": "data",
"provenance": "intra_module",
"source": "decoder_layer.mlp.up_proj",
"target": "decoder_layer.mlp.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"
}
],
"extends": "llama",
"model_type": "deepseek_v3",
"patches": [
{
"component_kind": "moe",
"overridden": {
"methods": [
"__init__",
"forward"
]
},
"parent_class": "DeepseekV2TopkRouter",
"parent_model": "deepseek_v2",
"relation": "inherits",
"target_class": "DeepseekV3TopkRouter"
},
{
"component_kind": "moe",
"overridden": {
"methods": [
"__init__"
]
},
"parent_class": "Qwen2MoeExperts",
"parent_model": "qwen2_moe",
"relation": "inherits",
"target_class": "DeepseekV3Experts"
},
{
"added": {
"methods": [
"__init__",
"forward"
]
},
"component_kind": "attention",
"parent_class": "Module",
"relation": "new",
"target_class": "DeepseekV3Attention"
},
{
"component_kind": "transformer_block",
"overridden": {
"methods": [
"__init__"
]
},
"parent_class": "LlamaDecoderLayer",
"relation": "inherits",
"target_class": "DeepseekV3DecoderLayer"
},
{
"added": {
"attrs": [
"_keep_in_fp32_modules_strict",
"_keys_to_ignore_on_load_unexpected"
],
"methods": [
"_init_weights"
]
},
"component_kind": "model",
"parent_class": "LlamaPreTrainedModel",
"relation": "inherits",
"target_class": "DeepseekV3PreTrainedModel"
},
{
"component_kind": "head",
"parent_class": "GenericForSequenceClassification",
"relation": "new",
"target_class": "DeepseekV3ForSequenceClassification"
},
{
"component_kind": "head",
"parent_class": "GenericForTokenClassification",
"relation": "new",
"target_class": "DeepseekV3ForTokenClassification"
}
],
"provenance": {
"config_class": "DeepseekV3Config",
"config_module": "transformers.models.deepseek_v3.configuration_deepseek_v3",
"model_class": "DeepseekV3Model",
"model_module": "transformers.models.deepseek_v3.modeling_deepseek_v3"
},
"repeats": [
{
"body": "decoder_layer",
"container_path_pattern": "model.layers",
"count": 61,
"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": "DeepseekV3DecoderLayer",
"container_path_pattern": "model.layers",
"item_path_pattern": "model.layers.{i}",
"source": "module_tree_repeat_collapse"
},
"repeated_class_name": "DeepseekV3DecoderLayer"
}
],
"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": "DeepseekV3DecoderLayer",
"id": "decoder_layer",
"kind": "transformer_block",
"path_pattern": "model.layers.{i}"
},
{
"attributes": {
"head_dim": 64,
"n_heads": 128,
"n_kv_heads": 128,
"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": "DeepseekV3Attention",
"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": "DeepseekV3RMSNorm",
"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": 24576
},
"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
},
"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": "DeepseekV3RMSNorm",
"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": 32768
},
"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": 16384,
"out_features": "config.hidden_size"
},
"class_name": "Linear",
"id": "decoder_layer.self_attn.o_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.self_attn.o_proj"
},
{
"attributes": {
"activation": "silu",
"hidden_size": 7168,
"intermediate_size": 18432
},
"children": [
"decoder_layer.mlp.gate_proj",
"decoder_layer.mlp.up_proj",
"decoder_layer.mlp.down_proj"
],
"class_name": "DeepseekV3MLP",
"id": "decoder_layer.mlp",
"kind": "feed_forward",
"path_pattern": "model.layers.{i}.mlp"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": "config.intermediate_size",
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.gate_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.gate_proj"
},
{
"attributes": {
"in_features": "config.hidden_size",
"out_features": "config.intermediate_size",
"tp": "colwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.up_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.up_proj"
},
{
"attributes": {
"in_features": "config.intermediate_size",
"out_features": "config.hidden_size",
"tp": "rowwise"
},
"class_name": "Linear",
"id": "decoder_layer.mlp.down_proj",
"kind": "projection",
"path_pattern": "model.layers.{i}.mlp.down_proj"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV3RMSNorm",
"id": "decoder_layer.input_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.input_layernorm"
},
{
"attributes": {
"kernel": "RMSNorm",
"norm_type": "rms"
},
"class_name": "DeepseekV3RMSNorm",
"id": "decoder_layer.post_attention_layernorm",
"kind": "normalization",
"path_pattern": "model.layers.{i}.post_attention_layernorm"
}
]
}