Skip to content

Repository files navigation

OpenModels Registry

The open-source registry of LLM models, inference providers, and provider-model mappings. Community-maintained, schema-validated, and machine-readable.

Current stats: 138 models · 52 providers · 209 mappings

Overview

OpenModels is a structured, version-controlled registry that serves as the single source of truth for LLM model metadata, inference provider details, and provider-model mappings (including pricing and rate limits). All data is stored as human-readable YAML files and validated against JSON Schemas on every pull request.

Coverage

VendorModels
OpenAIGPT-5.6 Terra, GPT-5.6 Sol, GPT-5.6 Luna, GPT-5.5, GPT-5.4 Mini, GPT-OSS 120B, GPT-OSS 20B, GPT-5.4, GPT-5.5 Pro, GPT-5, GPT-4
AnthropicClaude Opus 5, Claude Sonnet 5, Claude Mythos 5, Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 4.6, Claude Opus 4.6, Claude Sonnet 4.5, Claude Haiku 4.5, Claude 3 Opus
GoogleGemini 3.7 Flash, Gemini 3.6 Flash, Gemini 3.5 Flash-Lite, Gemini 3.5 Flash Cyber, Gemini 3.5 Pro, DiffusionGemma, Gemma 4 12B, Gemini 3 Flash, Gemini 3.5 Flash, Gemini 3.1 Flash-Lite, Gemma 4 (E2B/E4B/26B/31B), Gemini 3.1 Pro, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemma 3 (1B/4B/12B/27B)
xAIGrok 4.6, Grok 4.5, Grok 4.3, Grok 4.20, Grok 4.1 Fast, Grok 4
DeepSeekDeepSeek V4 Pro, DeepSeek V4 Flash, DeepSeek V4, DeepSeek R1, DeepSeek V3
MetaMuse Spark 1.1, Muse Spark, Llama 4 Scout, Llama 4 Maverick, Llama 3.3 70B, Llama 3.2 (3B/11B/90B), Llama 3.1 8B
MistralMistral Small 4, Mistral Medium 3.5, Mistral Large 3, Devstral 2, Mistral Small 3.1, Codestral
AlibabaQwen3.8-Flash-Next, Qwen 3.8 Max, Qwen 3.7 Plus, Qwen 3.7 Max, Qwen 3.6 (27B, 35B-A3B, Plus), Qwen 3.6, Qwen3 Coder, Qwen3 235B, Qwen3 32B, QwQ-32B
MoonshotKimi K3, Kimi K2.7 Code, Kimi K2.6
CohereCommand A+, Command A, Command R7B
Cohere For AITiny Aya, Aya Expanse 32B
ZhipuGLM-5.3-Flash, GLM-5.3, GLM-5.2, GLM-5.1, GLM-4.7
MiniMaxM3, M2.7
Sarvam AISarvam-M, Sarvam-105B, Sarvam-30B, Sarvam-1
Sakana AISakana Fugu Ultra, Sakana Fugu
Motif TechnologiesMotif 3 Beta
Thinking Machines LabInkling
OpenBMBMiniCPM-V 4.6
NVIDIANemotron 3 Ultra, Nemotron 3 Super 120B, Nemotron Nano 9B
MicrosoftPhi-4 Mini, Phi-4
YandexYandexGPT 5 Lite
SberGigaChat 3.1 Ultra, GigaChat 3.1 Lightning
ISSAIKazLLM 1.0 70B
Astana HubAlemLLM
IBMGranite 4.1 30B, Granite 4.1 8B
XiaomiMiMo-V2.5-Pro
MTS AICotype Nano
TencentHy3 Preview
PoolsideLaguna M.1
AI21 LabsJamba Large 1.7
TIIFalcon-H1, Falcon 3 10B
01.AIYi-Lightning
WriterPalmyra X5
DatabricksDBRX
SnowflakeArctic
Stability AIStableLM 2 12B
Uzbek LLM LabAlloma 8B Instruct
InclusionAIRing-2.6-1T
UpstageSolar Pro 3
LLM360/MBZUAIK2 Think
OpenAI (Audio)Whisper
VNGRSKumru 7B
TrendyolTrendyol LLM 8B T1
WiroAIWiroAI Turkish LLM 9B

Providers

01.AI · AI21 Labs · Alibaba Model Studio · Amazon Bedrock · Anthropic · Anyscale · Azure AI · Baseten · Cerebras · Cloudflare Workers AI · Cohere · Deep Infra · DeepSeek · Featherless · Fireworks · Google AI Studio · Google (Vertex AI) · Groq · Hugging Face Inference · Hyperbolic · IBM watsonx.ai · InclusionAI · Inference.net · Lambda · Meta · MiniMax · Mistral · Modal · Moonshot · Nebius · NLP Cloud · Novita · NVIDIA NIM · OpenAI · OpenRouter · Perplexity · Reka AI · Replicate · Sakana AI · SambaNova · Sarvam AI · Sber · Scaleway · SiliconFlow · Snowflake Cortex AI · Tinker · Together AI · Upstage · xAI · Xiaomi MiMo · Yandex Cloud · Zhipu AI

Structure

openmodels/
├── models/ # Canonical model definitions (YAML)
├── providers/ # Inference provider definitions (YAML)
├── mappings/ # Provider-model mappings with pricing (YAML)
│ ├── anthropic/
│ ├── openai/
│ ├── together-ai/
│ └── ...
├── schemas/ # JSON Schema definitions for validation
│ ├── model.schema.json
│ ├── provider.schema.json
│ └── mapping.schema.json
├── validate_registry.py # Validation script
└── requirements.txt # Python dependencies

Contributing

We welcome contributions from the community. You can add new models, providers, or mappings by opening a pull request.

Quick Start

  1. Fork this repository
  2. Create a new branch for your changes
  3. Add or update YAML files (see templates below)
  4. Run validation locally to check your changes
  5. Open a pull request

Adding a Model

Create a new file at models/{model-id}.yaml:

id: my-new-model # Unique ID (kebab-case, lowercase)name: My New Model # Display namedescription: A brief description of the model and its capabilities.capabilities: # What the model can do
- chat
- completion
- function-calling
- code-generationmodalities: # Input/output modalities
- text
- codecontext_window: 128000# Max context window in tokenslicensing: apache-2.0 # License (e.g., proprietary, apache-2.0, mit)created_at: "2025-01-01T00:00:00.000Z"updated_at: "2025-01-01T00:00:00.000Z"

Required fields: id, name, description, capabilities, modalities, context_window, licensing, created_at, updated_at

Adding a Provider

Create a new file at providers/{provider-id}.yaml:

id: my-provider # Unique ID (kebab-case, lowercase)name: My Provider # Display namedescription: Description of the inference provider.api_base_url: https://api.myprovider.com/v1auth_type: api-key # One of: bearer, api-key, oauth2regions: # Deployment regions
- us-east-1
- eu-west-1compatibility: openai # API compatibility (openai, anthropic, custom)created_at: "2025-01-01T00:00:00.000Z"updated_at: "2025-01-01T00:00:00.000Z"

Required fields: id, name, description, api_base_url, auth_type, regions, compatibility, created_at, updated_at

Adding a Mapping

Create a new file at mappings/{provider-id}/{model-id}.yaml:

model_id: deepseek-v3 # Must reference an existing modelprovider_id: together-ai # Must reference an existing providerprovider_model_name: deepseek-ai/DeepSeek-V3 # Provider's internal model namepricing:
input_per_million: 0.90# Price per 1M input tokens (required)output_per_million: 0.90# Price per 1M output tokens (required)currency: USD # ISO 4217 currency code (required)rate_limits:
requests_per_minute: 600tokens_per_minute: 1000000context_window_override: null # Override model's default (or null)available_regions: # Subset of provider's regions
- us-east-1created_at: "2025-01-01T00:00:00.000Z"updated_at: "2025-01-01T00:00:00.000Z"

Required fields: model_id, provider_id, provider_model_name, pricing, rate_limits, available_regions, created_at, updated_at

Extensible Pricing Model

The pricing structure supports optional fields for specialized pricing dimensions:

FieldDescription
input_per_millionPrice per 1M input tokens (required)
output_per_millionPrice per 1M output tokens (required)
currencyISO 4217 currency code (required)
cache_write_per_millionPrice per 1M tokens written to cache
cache_read_per_millionPrice per 1M tokens read from cache
image_per_unitPrice per image unit (vision models)
audio_per_secondPrice per second of audio
reasoning_tokens_per_millionPrice per 1M reasoning tokens
search_grounding_per_queryPrice per search grounding query

See mappings/.example-extended-pricing.yaml for a complete example.

ID Format Rules

  • Use kebab-case (lowercase letters, numbers, and hyphens only)
  • Must be unique across all files of the same type
  • Examples: deepseek-v3, together-ai, gpt-5-4-mini

Validation

All pull requests are automatically validated by GitHub Actions. The validation checks:

  • YAML Syntax — All YAML files must be parseable
  • Schema Validation — Files must conform to their JSON Schema (schemas/)
  • Duplicate IDs — Model and provider IDs must be unique
  • Referential Integrity — Mappings must reference existing models and providers

Running Validation Locally

# Install dependencies
pip install -r requirements.txt
# Run the validation script
python validate_registry.py

Example output on success:

✅ Validation Passed
Validated 135 files successfully.

Example output on failure:

❌ Validation Failed
Summary: 2 of 135 files failed validation.
Schema Validation Errors:
models/invalid-model.yaml
- context_window: -1000 is less than the minimum of 1

Schemas

JSON Schema definitions in schemas/ enforce the structure of all YAML files:

  • model.schema.json — Model definition schema
  • provider.schema.json — Provider definition schema
  • mapping.schema.json — Mapping definition schema

GitHub Actions

The validation workflow triggers on pull requests that modify:

  • models/**, providers/**, mappings/**
  • schemas/**
  • validate_registry.py, requirements.txt

The workflow will:

  1. Install Python dependencies
  2. Run the validation script
  3. Post validation results as a PR comment
  4. Block the PR if validation fails

On merge to main, the ingestion workflow automatically loads updated data into the platform database.

API & Platform

The OpenModels platform provides a REST API and web interface for querying registry data, comparing providers, and viewing telemetry (health, latency, uptime).

License

This registry is open source. See the repository for license details.

About

Developer infrastructure for discovering and comparing LLM models and providers

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages