# hogeheer499-commits/strix-halo-guide architecture

> Architecture diagram of the GitHub repository hogeheer499-commits/strix-halo-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hogeheer499-commits/strix-halo-guide
- Repository: https://github.com/hogeheer499-commits/strix-halo-guide

## Overview

This repository is an independent Strix Halo local-LLM guide and evidence collection, not an inference server. Its main reader workflow is to choose a supported machine and configuration, prepare the operating system and GPU memory settings, install and qualify a runtime, then run a model and compare measured results. The guide also covers model/runtime route decisions, performance and stability, buyer guidance, Windows, and community evidence. Benchmark and analysis scripts support those evidence branches. The README documents the setup flow; the sampled scripts show specific benchmark behavior, but many guide subsystems are documentation or data whose implementation was not sampled.

Main entry points: [`README.md`](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/README.md) (Quick start), [`data/README.md`](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/README.md) (Evidence datasets), [`data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py`](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py) (MTP repro), [`COMMUNITY_RESULTS.md`](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/COMMUNITY_RESULTS.md) (Community results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Setup Guide"]
  node_quickstart["Quick start<br/>[README.md]"]
  node_manual["Manual setup"]
  node_windows["Windows route<br/>[WINDOWS_START.md]"]
  node_security["Security guidance<br/>[SECURE_LOCAL_AI.md]"]
end

subgraph group_qualification["Runtime Qualification"]
  node_runtime["Local LLM runtime"]
  node_runtime_qual["Runtime qualification"]
  node_model_routes["Model routes<br/>[CURRENT_MODELS.md]"]
end

subgraph group_benchmarks["Benchmark Evidence"]
  node_controlled_compare["Ollama comparison"]
  node_quality_repro["ROCmFPX repro<br/>[run-repro.py]"]
  node_mtp_repro["MTP repro<br/>[run-repro.py]"]
  node_mtp_hip["HIP control<br/>[run-hip-control.py]"]
  node_thermal_analyze["Thermal analysis<br/>[analyze.py]"]
  node_embed_check["Embedding check"]
  node_density_parse["Density analysis"]
  node_charts["Evidence charts<br/>[generate_charts.py]"]
  node_evidence[("Evidence datasets<br/>[README.md]")]
  node_bench_docs["Benchmark method<br/>[BENCHMARKS.md]"]
end

subgraph group_community["Community Evidence"]
  node_community_results["Community results"]
  node_system_matrix["System evidence matrix"]
end

subgraph group_buyer["Hardware Decisions"]
  node_buyer_guide["Buyer guidance<br/>[BUYER_USE_CASES.md]"]
  node_buyer_validation["Buyer validation"]
end

node_reader(("Local AI user"))

node_reader -->|"follows"| node_quickstart
node_quickstart -->|"offers manual route"| node_manual
node_quickstart -->|"offers Windows route"| node_windows
node_quickstart -->|"configures and runs"| node_runtime
node_quickstart -->|"checks qualification"| node_runtime_qual
node_quickstart -->|"consults advisories"| node_security
node_reader -->|"evaluates systems"| node_buyer_guide
node_buyer_guide -->|"uses validation"| node_buyer_validation
node_reader -->|"reviews methods"| node_bench_docs
node_controlled_compare -->|"starts and queries"| node_runtime
node_quality_repro -->|"starts and queries"| node_runtime
node_mtp_repro -->|"starts and queries"| node_runtime
node_mtp_hip -->|"reuses repro"| node_mtp_repro
node_embed_check -.->|"prints metrics"| node_evidence
node_thermal_analyze -.->|"summarizes campaign"| node_community_results
node_density_parse -.->|"parses campaign"| node_evidence
node_charts -.->|"visualizes results"| node_evidence
node_community_results -.->|"contributes system evidence"| node_system_matrix

click node_quickstart "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/README.md"
click node_manual "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/STRIX_HALO_LOCAL_LLM_SETUP.md"
click node_windows "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/WINDOWS_START.md"
click node_security "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/SECURE_LOCAL_AI.md"
click node_runtime_qual "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/RUNTIME_QUALIFICATION_2026-09-19.md"
click node_model_routes "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/CURRENT_MODELS.md"
click node_controlled_compare "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-16/ollama-0311-0312-0320-controlled/run-controlled-compare.py"
click node_quality_repro "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-16/step37-rocmfpx-q3-qualityplus/run-repro.py"
click node_mtp_repro "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py"
click node_mtp_hip "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-hip-control.py"
click node_thermal_analyze "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-18/community-failsafe-corsair-thermal-sclk-issue24/analyze.py"
click node_embed_check "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-25/nemotron-embed-1b-v2-official/run_embedding_check.py"
click node_density_parse "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/scripts/parse_density_gate_campaign.py"
click node_charts "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/scripts/generate_charts.py"
click node_evidence "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/README.md"
click node_community_results "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/COMMUNITY_RESULTS.md"
click node_system_matrix "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/SYSTEM_EVIDENCE_MATRIX.md"
click node_buyer_guide "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BUYER_USE_CASES.md"
click node_buyer_validation "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BUYER_PATH_VALIDATION.md"
click node_bench_docs "https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BENCHMARKS.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_quickstart,node_manual,node_windows,node_security,node_reader toneBlue
class node_runtime,node_runtime_qual,node_model_routes toneAmber
class node_controlled_compare,node_quality_repro,node_mtp_repro,node_mtp_hip,node_thermal_analyze,node_embed_check,node_density_parse,node_charts,node_evidence,node_bench_docs toneMint
class node_community_results,node_system_matrix toneRose
class node_buyer_guide,node_buyer_validation toneIndigo
```

## Components

### Setup Guide

- [Quick start](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/README.md): `README.md`
- [Manual setup](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/STRIX_HALO_LOCAL_LLM_SETUP.md): `STRIX_HALO_LOCAL_LLM_SETUP.md`
- [Windows route](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/WINDOWS_START.md): `WINDOWS_START.md`
- [Security guidance](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/SECURE_LOCAL_AI.md): `SECURE_LOCAL_AI.md`

### Runtime Qualification

- **Local LLM runtime**
- [Runtime qualification](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/RUNTIME_QUALIFICATION_2026-09-19.md): `RUNTIME_QUALIFICATION_2026-09-19.md`
- [Model routes](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/CURRENT_MODELS.md): `CURRENT_MODELS.md`

### Benchmark Evidence

- [Ollama comparison](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-16/ollama-0311-0312-0320-controlled/run-controlled-compare.py): `data/raw/2026-07-16/ollama-0311-0312-0320-controlled/run-controlled-compare.py`
- [ROCmFPX repro](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-16/step37-rocmfpx-q3-qualityplus/run-repro.py): `data/raw/2026-07-16/step37-rocmfpx-q3-qualityplus/run-repro.py`
- [MTP repro](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py): `data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py`
- [HIP control](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-hip-control.py): `data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-hip-control.py`
- [Thermal analysis](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-18/community-failsafe-corsair-thermal-sclk-issue24/analyze.py): `data/raw/2026-07-18/community-failsafe-corsair-thermal-sclk-issue24/analyze.py`
- [Embedding check](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/raw/2026-07-25/nemotron-embed-1b-v2-official/run_embedding_check.py): `data/raw/2026-07-25/nemotron-embed-1b-v2-official/run_embedding_check.py`
- [Density analysis](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/scripts/parse_density_gate_campaign.py): `scripts/parse_density_gate_campaign.py`
- [Evidence charts](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/scripts/generate_charts.py): `scripts/generate_charts.py`
- [Evidence datasets](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/data/README.md): `data/README.md`
- [Benchmark method](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BENCHMARKS.md): `BENCHMARKS.md`

### Community Evidence

- [Community results](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/COMMUNITY_RESULTS.md): `COMMUNITY_RESULTS.md`
- [System evidence matrix](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/SYSTEM_EVIDENCE_MATRIX.md): `SYSTEM_EVIDENCE_MATRIX.md`

### Hardware Decisions

- [Buyer guidance](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BUYER_USE_CASES.md): `BUYER_USE_CASES.md`
- [Buyer validation](https://github.com/hogeheer499-commits/strix-halo-guide/blob/main/BUYER_PATH_VALIDATION.md): `BUYER_PATH_VALIDATION.md`

### Other components

- **Local AI user**

## Connections

- Local AI user → Quick start: follows (evidence: `README.md`)
- Quick start → Manual setup: offers manual route (evidence: `README.md`)
- Quick start → Windows route: offers Windows route (evidence: `README.md`)
- Quick start → Local LLM runtime: configures and runs (evidence: `README.md`)
- Quick start → Runtime qualification: checks qualification (evidence: `README.md`)
- Quick start → Security guidance: consults advisories (evidence: `README.md`)
- Local AI user → Buyer guidance: evaluates systems (evidence: `README.md`)
- Buyer guidance → Buyer validation: uses validation
- Local AI user → Benchmark method: reviews methods (evidence: `README.md`)
- Ollama comparison → Local LLM runtime: starts and queries (evidence: `data/raw/2026-07-16/ollama-0311-0312-0320-controlled/run-controlled-compare.py`)
- ROCmFPX repro → Local LLM runtime: starts and queries (evidence: `data/raw/2026-07-16/step37-rocmfpx-q3-qualityplus/run-repro.py`)
- MTP repro → Local LLM runtime: starts and queries (evidence: `data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-repro.py`)
- HIP control → MTP repro: reuses repro (evidence: `data/raw/2026-08-09/qwen3-next-80b-mtp-b10330/run-hip-control.py`)
- Embedding check → Evidence datasets: prints metrics
- Thermal analysis → Community results: summarizes campaign
- Density analysis → Evidence datasets: parses campaign
- Evidence charts → Evidence datasets: visualizes results
- Community results → System evidence matrix: contributes system evidence
