mcpField
M
model-architecture-diagram

model-architecture-diagram

github.com/bbufDevelopment1.1k78 installsUpdated today
Repository

About model-architecture-diagram

A skill that finds indexed public, original architecture diagrams for named models. It is intended for people seeking model-specific diagrams and returns source image links with attribution, or reports when no match is indexed.

Key features

  1. 01Resolves model names and aliases
  2. 02Returns original diagram image links
  3. 03Preserves source attribution
  4. 04Lists known diagram aliases

Use cases

  1. 01Finding an architecture diagram for a model
  2. 02Retrieving multiple diagrams for a direct match
  3. 03Checking whether a model has an indexed diagram

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bbuf/ai-infra-auto-driven-skills --skill model-architecture-diagram

After installing, type/model-architecture-diagramin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
diagram-index.json
source-notes.md
scripts/
model_architecture_diagram.py

Details

From the project README

Model Architecture Diagram

Workflow

Return only public original diagrams indexed by this skill.

  1. Run the bundled resolver:
python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py "<model name>"
  1. If the resolver returns kind: existing, return the raw image Markdown it prints and preserve the source attribution line.
  2. If the resolver returns kind: no_match, tell the user that no public original architecture diagram is indexed for that model.

Source Priority

Use references/diagram-index.json as the source of truth. It stores raw GitHub image URLs and official vendor/CDN or pinned Hugging Face resolve/<sha> URLs. Official sources include Qwen and XiaomiMiMo; GitHub sources:

  • datawhalechina/self-llm
  • CalvinXKY/InfraTech
  • Tongyi-MAI/Z-Image
  • Wan-Video/Wan2.1
  • Wan-Video/Wan2.2
  • Tencent-Hunyuan/HunyuanVideo
  • Tencent-Hunyuan/Hunyuan3D-2
  • brayevalerien/Flux.1-Architecture-Diagram

Prefer detailed implementation, cookbook, or architecture-card diagrams over paper figures. Good sources show module boundaries, dataflow, MoE / attention / cache paths, or model-specific runtime structure rather than only a high-level paper overview. Official repository diagrams and curated implementation diagrams are first choice; paper figures are fallback only when no more detailed public original diagram is indexed.

Do not copy remote image binaries into the skill. Return the indexed original URLs so the chat renderer can display the original image.

Existing Diagram Rule

For a direct match, show the original image. Good direct matches include:

  • DeepSeek V3/V3.2/V4, GLM-5, Kimi K2/K2.5/K3, MiniMax M2.5, Qwen3.5, Qwen3-VL, and Step 3.5 Flash from InfraTech.
  • Qwen3.8-Flash-Next has an official diagram (also named qwen4_exp in runtime code). Plain Qwen3.8 2.4T remains no_match; these are different architectures.
  • MiMo V2.6, MiMo V2.5 Pro and GLM-5.2 have indexed originals. GLM-5.3 remains no_match because no direct diagram was verified.
  • Hunyuan-A13B, Kimi-VL, Qwen3, Qwen3-VL detail flows, MiniMax M2, and Llama 4 architecture/module diagrams from self-llm.
  • Z-Image, Wan2.1, Wan2.2, HunyuanVideo, Hunyuan3D 2.0, and FLUX.1 diffusion architecture/module diagrams from public GitHub sources.

If multiple diagrams match, show all high-confidence matches up to the resolver's default limit. For example, DeepSeek V3 may return the full architecture plus MLA MHA/MQA diagrams.

Hosted Original Diagram Gallery

Do not commit the sgl-cookbook-model-architecture-images/ gallery into the repository. The public-original image set is hosted as a GitHub Release asset and indexed by a GitHub issue.

Current hosted artifact:

The gallery is a 2026-05-02 snapshot containing 44 public original diagram image files; it does not mirror the current index, plus a lightweight index.html, index.md, manifest.json, HTML contact sheet, and architecture-audit.md.

To inspect the gallery locally:

curl -L -o /tmp/sgl-cookbook-model-architecture-images-2026-05-02.zip \
  https://github.com/BBuf/AI-Infra-Auto-Driven-SKILLS/releases/download/sgl-cookbook-architecture-images-2026-05-02/sgl-cookbook-model-architecture-images-2026-05-02.zip
unzip -q /tmp/sgl-cookbook-model-architecture-images-2026-05-02.zip -d /tmp
open /tmp/sgl-cookbook-model-architecture-images/index.html

Useful Commands

List known original diagram aliases:

python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py --list-known

Emit JSON for automation:

python3 skills/model-architecture-diagram/scripts/model_architecture_diagram.py "GLM-5" --format json

References

  • references/diagram-index.json: original diagram link index and aliases.
  • references/source-notes.md: audited source repositories and local cache paths.

Comments

Markdown supported