PHPackages                             symfony/models-dev - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. symfony/models-dev

ActiveLibrary

symfony/models-dev
==================

Provides the models.dev data as a Composer package

v13.0(2d ago)62.7k↓12.1%1[1 PRs](https://github.com/symfony/models-dev/pulls)MITPythonCI passing

Since Mar 1Pushed 2d ago1 watchersCompare

[ Source](https://github.com/symfony/models-dev)[ Packagist](https://packagist.org/packages/symfony/models-dev)[ Fund](https://symfony.com/sponsor)[ GitHub Sponsors](https://github.com/fabpot)[ RSS](/packages/symfony-models-dev/feed)WikiDiscussions main Synced today

READMEChangelog (10)DependenciesVersions (21)Used By (0)

PHP models.dev Package
======================

[](#php-modelsdev-package)

This repository provides a daily snapshot of the [models.dev](https://models.dev)API as a Composer package. It makes the full catalog of AI model metadata (providers, models, pricing, context limits, modalities, …) available to any PHP project via a simple `composer require`.

How it works
------------

[](#how-it-works)

A GitHub Actions workflow runs every day at 06:00 UTC:

1. It fetches the latest data from `https://models.dev/api.json`.
2. If the data has changed, it commits the updated `models-dev.json` file.
3. It creates a GitHub Release with a new version tag and a changelog describing added/removed providers and models. The version follows semver: minor bumps for additions and metadata updates (`v1.0` → `v1.1`), major bumps when models or providers are removed (`v1.3` → `v2.0`).

Installation
------------

[](#installation)

Releases follow semver: minor versions add new models or providers, major versions indicate removals. Use the `^` constraint to automatically receive new models/providers while staying protected from removals:

```
composer require symfony/models-dev:^1.0
```

When a new major version is released, review the release notes to see what was removed before upgrading.

The `models-dev.json` file at the root of the package contains the full dataset.

Usage
-----

[](#usage)

This package can be used in conjunction with the [Symfony AI Models.dev bridge](https://github.com/symfony/ai-models-dev-platform), which provides a universal platform giving access to all AI providers available on models.dev with automatic capability discovery, pricing, and routing to specialized bridges. See the [full documentation](https://symfony.com/doc/current/ai/components/platform/models-dev.html)for details.

You can also use the JSON data directly:

```
$models = json_decode(
    file_get_contents(__DIR__.'/vendor/symfony/models-dev/models-dev.json'),
    true,
);

// List all providers
$providers = array_keys($models);

// Get all models for a given provider
$openaiModels = $models['openai']['models'];
```

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance100

Actively maintained with recent releases

Popularity29

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

20

Last Release

2d ago

Major Versions

v8.0 → v9.02026-03-15

v9.0 → v10.02026-03-16

v10.0 → v11.02026-03-17

v11.0 → v12.02026-03-18

v12.3 → v13.02026-03-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47313?v=4)[Fabien Potencier](/maintainers/fabpot)[@fabpot](https://github.com/fabpot)

---

Top Contributors

[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (40 commits)")

### Embed Badge

![Health badge](/badges/symfony-models-dev/health.svg)

```
[![Health](https://phpackages.com/badges/symfony-models-dev/health.svg)](https://phpackages.com/packages/symfony-models-dev)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
