# leelachesszero/lczero architecture

> Architecture diagram of the GitHub repository leelachesszero/lczero, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leelachesszero/lczero
- Repository: https://github.com/leelachesszero/lczero

## Overview

- Input flow: UCI commands → Engine
- Evaluation: Position → Neural Network → UCT Search
- Hardware acceleration: Network → OpenCL → GPU
- Output flow: UCT Search → Best Move Selection → UCI Interface

##### Parallel Processing (Use overlapping or nested blocks)

How the system handles parallel processing:
- Thread Pool management
- GPU computation distribution
- Neural Network batch processing

##### Key Subsystems (Use nested containers)

Neural Network Processing:
- [Neural Network System]
- Network Inference
- OpenCL Acceleration
- Cache Management

Search System:
- [UCT Search System]
- Node Management
- Position Evaluation
- Move Selection

##### Important Notes

- Version/build information
- System requirements (OpenCL, BLAS, etc.)
- Optional components (CPU-only vs GPU mode)

##### Technical Details to Highlight

- C++14 codebase
- OpenCL acceleration
- BLAS integration
- Multi-threading support
- Training pipeline separation

## Diagram (Mermaid)

```mermaid
graph TB
    classDef core fill:#e1f5fe,stroke:#01579b
    classDef hardware fill:#fff3e0,stroke:#e65100
    classDef support fill:#f3e5f5,stroke:#4a148c
    classDef external fill:#f5f5f5,stroke:#212121
    classDef interface fill:#e8f5e9,stroke:#1b5e20

    subgraph External["External Systems"]
        GUI[Chess GUI]:::external
        Training[Training Pipeline]:::external
        Weights[Network Weights]:::external
        SyzygyDB[Syzygy Database Files]:::external
    end

    subgraph Core["Core Engine Components"]
        UCI[UCI Interface]:::core
        Position[Position Management]:::core
        Movegen[Move Generation]:::core
        Network[Neural Network]:::core
        UCTSearch[UCT Search]:::core
        TimeMan[Time Management]:::core
    end

    subgraph Hardware["Hardware Acceleration"]
        OpenCL[OpenCL Management]:::hardware
        GPUKernels[GPU Compute Kernels]:::hardware
    end

    subgraph Support["Support Systems"]
        NNCache[Neural Network Cache]:::support
        ThreadPool[Thread Pool]:::support
        Random[Random Number Generation]:::support
        Syzygy[Syzygy Tablebase Probe]:::support
    end

    GUI --> UCI
    UCI --> Position
    Position --> Movegen
    Position --> Network
    Network --> NNCache
    Network --> OpenCL
    OpenCL --> GPUKernels
    Network --> UCTSearch
    UCTSearch --> ThreadPool
    UCTSearch --> Random
    Position --> Syzygy
    Syzygy --> SyzygyDB
    TimeMan --> UCTSearch
    UCTSearch --> UCI
    Training -.-> Weights
    Weights -.-> Network

    %% Click events for component mapping
    click UCI "https://github.com/LeelaChessZero/lczero/blob/release/src/UCI.cpp"
    click Position "https://github.com/LeelaChessZero/lczero/blob/release/src/Position.cpp"
    click Movegen "https://github.com/LeelaChessZero/lczero/blob/release/src/Movegen.cpp"
    click Network "https://github.com/LeelaChessZero/lczero/blob/release/src/Network.cpp"
    click UCTSearch "https://github.com/LeelaChessZero/lczero/blob/release/src/UCTSearch.cpp"
    click TimeMan "https://github.com/LeelaChessZero/lczero/blob/release/src/TimeMan.cpp"
    click OpenCL "https://github.com/LeelaChessZero/lczero/blob/release/src/OpenCL.cpp"
    click GPUKernels "https://github.com/LeelaChessZero/lczero/tree/release/src/clblast_level3/"
    click NNCache "https://github.com/LeelaChessZero/lczero/blob/release/src/NNCache.cpp"
    click ThreadPool "https://github.com/LeelaChessZero/lczero/blob/release/src/ThreadPool.h"
    click Random "https://github.com/LeelaChessZero/lczero/blob/release/src/Random.cpp"
    click Syzygy "https://github.com/LeelaChessZero/lczero/blob/release/src/syzygy/tbprobe.cpp"

    %% Legend
    classDef legendClass fill:#fff,stroke:#333
    class GUI,Training,Weights,SyzygyDB,UCI,Position,Movegen,Network,UCTSearch,TimeMan,OpenCL,GPUKernels,NNCache,ThreadPool,Random,Syzygy legendClass
```
