# jonathanchaveztamales/llmstats architecture

> Architecture diagram of the GitHub repository jonathanchaveztamales/llmstats, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jonathanchaveztamales/llmstats
- Repository: https://github.com/jonathanchaveztamales/llmstats

## Overview

##### Project type and purpose
- This is an open-source, community-driven data repository of large language models (LLMs) and provider metadata.
- It does not implement a full frontend/backend stack itself, but it serves as the canonical data source for the interactive dashboard at llm-stats.com and any downstream consumers.

##### File structure
- Top-level directories:
- models/ – JSON files for each LLM organized by provider → model → model.json
- providers/ – JSON files describing each API provider → provider.json
- schemas/ – JSON Schema definitions (models-schema.json, providers-schema.json) and validator.js
- Tooling & configuration:
- package.json & package-lock.json – Node project to install dependencies (e.g., ajv for schema validation)
- .github/workflows/schema-validation.yml – CI pipeline that runs validator.js on all JSON data
- Contribution docs: CONTRIBUTING.md, LICENSE.md, PR templates, .gitignore

##### README for additional insights
- Describes the scope: model parameters, benchmarks, pricing, licensing
- Emphasizes the community contribution workflow and data quality (validation, multiple citations)
- Mentions an external interactive dashboard (llm-stats.com) that consumes this data

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Contributors & Process"
        Contrib["Contributors"]:::external
        Fork["Fork/Clone Repo"]:::process
        PR["Pull Request"]:::process
        Contrib --> Fork
        Fork --> PR
    end

    subgraph "Continuous Integration"
        CI["GitHub Actions CI"]:::process
        Validator["validator.js"]:::process
        PR --> CI
        CI --> Validator
    end

    subgraph "Data Store"
        Models["models/"]:::data
        Providers["providers/"]:::data
        Schemas["schemas/"]:::data
    end

    subgraph "Tooling & Documentation"
        Package["package.json"]:::data
        Lock["package-lock.json"]:::data
        ContribDocs["CONTRIBUTING.md"]:::doc
        License["LICENSE.md"]:::doc
        PRTemplate[".github/pull_request_template.md"]:::doc
    end

    CI -->|reads schemas| Schemas
    CI -->|validates models| Models
    CI -->|validates providers| Providers
    CI -->|runs| Validator

    CI -->|feedback pass/fail| Reviewers["Reviewers"]:::external
    Reviewers --> Merge["Merge to main"]:::process

    Merge --> Models
    Merge --> Providers
    Merge --> Schemas

    subgraph "Downstream Consumers"
        Dashboard["Interactive Dashboard"]:::external
        ThirdParty["Third-party Tools"]:::external
    end

    Merge --> Dashboard
    Merge --> ThirdParty

    click Models "https://github.com/jonathanchaveztamales/llmstats/tree/main/models/"
    click Providers "https://github.com/jonathanchaveztamales/llmstats/tree/main/providers/"
    click Schemas "https://github.com/jonathanchaveztamales/llmstats/tree/main/schemas/"
    click Validator "https://github.com/jonathanchaveztamales/llmstats/blob/main/schemas/validator.js"
    click CI "https://github.com/jonathanchaveztamales/llmstats/blob/main/.github/workflows/schema-validation.yml"
    click Package "https://github.com/jonathanchaveztamales/llmstats/blob/main/package.json"
    click Lock "https://github.com/jonathanchaveztamales/llmstats/blob/main/package-lock.json"
    click ContribDocs "https://github.com/jonathanchaveztamales/llmstats/blob/main/CONTRIBUTING.md"
    click License "https://github.com/jonathanchaveztamales/llmstats/blob/main/LICENSE.md"
    click PRTemplate "https://github.com/jonathanchaveztamales/llmstats/blob/main/.github/pull_request_template.md"

    classDef data fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef process fill:#90EE90,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
    classDef doc fill:#D3D3D3,stroke:#333,stroke-width:1px
```
