# raullenchai/free-llm-api-resources architecture

> Architecture diagram of the GitHub repository raullenchai/free-llm-api-resources, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raullenchai/free-llm-api-resources
- Repository: https://github.com/raullenchai/free-llm-api-resources

## Overview

This repository publishes a generated catalogue of free LLM API access and trial-credit providers, including models and usage limits. The main workflow is running the Python generator, which gathers provider information and produces the README catalogue. The source excerpts show provider API fetching and model metadata, but not the full orchestration or all provider integrations; those links are therefore kept broad.

Main entry points: [`src/pull_available_models.py`](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/pull_available_models.py) (Catalogue generator), [`src/data.py`](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/data.py) (Model metadata), [`src/1-second-of-silence.mp3`](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/1-second-of-silence.mp3) (Silence audio sample), [`README.md`](https://github.com/raullenchai/free-llm-api-resources/blob/main/README.md) (Provider catalogue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["Catalogue generation"]
  node_generator["Catalogue generator"]
  node_metadata["Model metadata<br/>[data.py]"]
  node_silence["Silence audio sample"]
  node_catalogue["Provider catalogue<br/>[README.md]"]
end

subgraph group_sources["Provider sources"]
  node_free_apis{{"Free provider APIs"}}
  node_trial_apis{{"Trial-credit provider APIs"}}
end

node_maintainer(("Maintainer"))

node_maintainer -->|"runs"| node_generator
node_generator -->|"fetches data"| node_free_apis
node_generator -->|"fetches data"| node_trial_apis
node_generator -->|"uses mappings"| node_metadata
node_generator -->|"uploads sample"| node_silence
node_generator -->|"generates"| node_catalogue

click node_generator "https://github.com/raullenchai/free-llm-api-resources/blob/main/src/pull_available_models.py"
click node_metadata "https://github.com/raullenchai/free-llm-api-resources/blob/main/src/data.py"
click node_silence "https://github.com/raullenchai/free-llm-api-resources/blob/main/src/1-second-of-silence.mp3"
click node_catalogue "https://github.com/raullenchai/free-llm-api-resources/blob/main/README.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_generator,node_metadata,node_silence,node_catalogue toneBlue
class node_free_apis,node_trial_apis toneAmber
class node_maintainer toneIndigo
```

## Components

### Catalogue generation

- [Catalogue generator](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/pull_available_models.py): `src/pull_available_models.py`
- [Model metadata](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/data.py): `src/data.py`
- [Silence audio sample](https://github.com/raullenchai/free-llm-api-resources/blob/main/src/1-second-of-silence.mp3): `src/1-second-of-silence.mp3`
- [Provider catalogue](https://github.com/raullenchai/free-llm-api-resources/blob/main/README.md): `README.md`

### Provider sources

- **Free provider APIs**
- **Trial-credit provider APIs**

### Other components

- **Maintainer**

## Connections

- Maintainer → Catalogue generator: runs
- Catalogue generator → Free provider APIs: fetches data
- Catalogue generator → Trial-credit provider APIs: fetches data
- Catalogue generator → Model metadata: uses mappings
- Catalogue generator → Silence audio sample: uploads sample
- Catalogue generator → Provider catalogue: generates