# clawlabsai/free-ai-models architecture

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

- Interactive diagram: https://gitdiagram.com/clawlabsai/free-ai-models
- Repository: https://github.com/clawlabsai/free-ai-models

## Overview

Free AI Models is a community-maintained catalog of free AI models, refreshed daily from public model sources and enriched with ranking and health data. Its main workflow fetches and normalizes provider listings, merges live ranking metadata, saves a current snapshot and dated history, then regenerates the README table. A weekly comparison script uses those snapshots to prepare release notes. The graph reflects documented capabilities and excerpted source; unsampled implementation details are not inferred.

Main entry points: [`scripts/fetch-models.js`](https://github.com/clawlabsai/free-ai-models/blob/main/scripts/fetch-models.js) (Model fetcher), [`scripts/weekly-release.js`](https://github.com/clawlabsai/free-ai-models/blob/main/scripts/weekly-release.js) (Weekly comparison), [`data/models.json`](https://github.com/clawlabsai/free-ai-models/blob/main/data/models.json) (Current catalog), [`data/history`](https://github.com/clawlabsai/free-ai-models/tree/main/data/history) (Daily snapshots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Collection and enrichment"]
  node_fetcher["Model fetcher<br/>[fetch-models.js]"]
end

subgraph group_catalog["Catalog and history"]
  node_current[("Current catalog<br/>[models.json]")]
  node_history[("Daily snapshots")]
end

subgraph group_updates["Presentation and updates"]
  node_readme["Model list<br/>[README.md]"]
  node_weekly["Weekly comparison<br/>[weekly-release.js]"]
end

node_maintainer(("Maintainer"))
node_openrouter["OpenRouter"]
node_pollinations["Pollinations AI"]
node_ranking["ZeroOptimize data"]
node_releases["GitHub releases"]
node_reader(("Catalog reader"))

node_maintainer -->|"runs update"| node_fetcher
node_fetcher -->|"fetches listings"| node_openrouter
node_fetcher -->|"fetches listings"| node_pollinations
node_fetcher -->|"fetches rankings"| node_ranking
node_fetcher -->|"writes snapshot"| node_current
node_fetcher -->|"archives snapshot"| node_history
node_fetcher -->|"regenerates table"| node_readme
node_weekly -->|"reads snapshot"| node_current
node_weekly -->|"reads baseline"| node_history
node_weekly -.->|"prepares release notes"| node_releases
node_reader -->|"browses catalog"| node_current
node_reader -->|"views model list"| node_readme

click node_fetcher "https://github.com/clawlabsai/free-ai-models/blob/main/scripts/fetch-models.js"
click node_current "https://github.com/clawlabsai/free-ai-models/blob/main/data/models.json"
click node_history "https://github.com/clawlabsai/free-ai-models/tree/main/data/history"
click node_readme "https://github.com/clawlabsai/free-ai-models/blob/main/README.md"
click node_weekly "https://github.com/clawlabsai/free-ai-models/blob/main/scripts/weekly-release.js"

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_fetcher toneBlue
class node_current,node_history toneAmber
class node_readme,node_weekly,node_openrouter toneMint
class node_maintainer,node_pollinations,node_ranking,node_releases,node_reader toneIndigo
```

## Components

### Collection and enrichment

- [Model fetcher](https://github.com/clawlabsai/free-ai-models/blob/main/scripts/fetch-models.js): `scripts/fetch-models.js`

### Catalog and history

- [Current catalog](https://github.com/clawlabsai/free-ai-models/blob/main/data/models.json): `data/models.json`
- [Daily snapshots](https://github.com/clawlabsai/free-ai-models/tree/main/data/history): `data/history`

### Presentation and updates

- [Model list](https://github.com/clawlabsai/free-ai-models/blob/main/README.md): `README.md`
- [Weekly comparison](https://github.com/clawlabsai/free-ai-models/blob/main/scripts/weekly-release.js): `scripts/weekly-release.js`

### Other components

- **Maintainer**
- **OpenRouter**
- **Pollinations AI**
- **ZeroOptimize data**
- **GitHub releases**
- **Catalog reader**

## Connections

- Maintainer → Model fetcher: runs update
- Model fetcher → OpenRouter: fetches listings (evidence: `scripts/fetch-models.js`)
- Model fetcher → Pollinations AI: fetches listings (evidence: `scripts/fetch-models.js`)
- Model fetcher → ZeroOptimize data: fetches rankings (evidence: `scripts/fetch-models.js`)
- Model fetcher → Current catalog: writes snapshot (evidence: `scripts/fetch-models.js`)
- Model fetcher → Daily snapshots: archives snapshot (evidence: `scripts/fetch-models.js`)
- Model fetcher → Model list: regenerates table (evidence: `scripts/fetch-models.js`)
- Weekly comparison → Current catalog: reads snapshot (evidence: `scripts/weekly-release.js`)
- Weekly comparison → Daily snapshots: reads baseline (evidence: `scripts/weekly-release.js`)
- Weekly comparison → GitHub releases: prepares release notes (evidence: `README.md`)
- Catalog reader → Current catalog: browses catalog (evidence: `README.md`)
- Catalog reader → Model list: views model list (evidence: `README.md`)
