# coqui-ai/stt-models architecture

> Architecture diagram of the GitHub repository coqui-ai/stt-models, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/coqui-ai/stt-models
- Repository: https://github.com/coqui-ai/stt-models

## Overview

##### Project type and purpose
- This is an open-source “model registry” repository for Coqui STT. It tracks and publishes released speech-to-text models, organized by language, provider, and version. Consumers download these assets to use with the Coqui STT engine.

##### File structure
- Top level:
- README.md – project description
- .github/ – CI/CD and PR templates
- Per-language directories (e.g., “english”, “spanish”, “amharic”)
- Inside each: one or more provider subdirectories (e.g., “coqui”, “itml”, “ccoreilly”)
- Inside each provider: versioned folders (e.g., “v0.1.0”, “v1.0.0‐digits”, “v0.8.99”)
- Each version folder contains: LICENSE, MODEL_CARD.md, alphabet.txt, and sometimes test CSVs or scorer files
- No code or services – purely static artifacts with semantic versioning.

##### README
- Describes purpose: “tracks releases of open models for 🐸STT”
- Points to GitHub Releases for downloads

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Repository Layer
    subgraph "GitHub Repository" 
        direction TB
        Repo["GitHub Repository"]:::storage
        README["README.md"]:::storage
        ActionsDir[".github/"]:::storage
        subgraph "Languages" 
            direction TB
            subgraph "English" 
                direction TB
                subgraph "Coqui Provider"
                    direction TB
                    VerEng["v1.0.0-digits"]:::storage
                    MetaEng["Model Artifacts (LICENSE, MODEL_CARD.md, alphabet.txt)"]:::artifact
                end
            end
            subgraph "Spanish" 
                direction TB
                subgraph "Jaco-assistant Provider"
                    direction TB
                    VerSpa["v0.0.1"]:::storage
                    MetaSpa["Model Artifacts (LICENSE, MODEL_CARD.md, alphabet.txt)"]:::artifact
                end
            end
            subgraph "Amharic" 
                direction TB
                subgraph "Itml Provider"
                    direction TB
                    VerAmh["v0.1.0"]:::storage
                    MetaAmh["Model Artifacts (LICENSE, MODEL_CARD.md, alphabet.txt)"]:::artifact
                end
            end
        end
    end

    %% CI/CD Layer
    CI["CI/CD Pipeline (GitHub Actions)"]:::compute

    %% Releases Layer
    Releases["GitHub Releases"]:::storage

    %% Consumers Layer
    subgraph "Consumers" 
        direction TB
        Engine["Coqui STT Engine"]:::runtime
        Apps["End-user Applications"]:::runtime
    end

    %% Connections
    Repo -->|"push commits"| CI
    CI -->|"CI validation"| CI
    CI -->|"publish assets"| Releases
    Releases -->|"HTTPS GET"| Engine
    Releases -->|"HTTPS GET"| Apps

    %% Click Events
    click Repo "https://github.com/coqui-ai/stt-models/tree/main//"
    click README "https://github.com/coqui-ai/stt-models/blob/main//README.md"
    click ActionsDir "https://github.com/coqui-ai/stt-models/tree/main//.github/"
    click VerEng "https://github.com/coqui-ai/stt-models/blob/main//english/coqui/v1.0.0-digits"
    click MetaEng "https://github.com/coqui-ai/stt-models/blob/main//english/coqui/v1.0.0-digits"
    click VerSpa "https://github.com/coqui-ai/stt-models/blob/main//spanish/jaco-assistant/v0.0.1"
    click MetaSpa "https://github.com/coqui-ai/stt-models/blob/main//spanish/jaco-assistant/v0.0.1"
    click VerAmh "https://github.com/coqui-ai/stt-models/blob/main//amharic/itml/v0.1.0"
    click MetaAmh "https://github.com/coqui-ai/stt-models/blob/main//amharic/itml/v0.1.0"

    %% Styles
    classDef storage fill:#bbdefb,stroke:#1e88e5,color:#0d47a1;
    classDef compute fill:#c8e6c9,stroke:#388e3c,color:#1b5e20;
    classDef runtime fill:#ffe0b2,stroke:#fb8c00,color:#e65100;
    classDef artifact fill:#e1bee7,stroke:#8e24aa,color:#4a148c;
```
