# LLM DB v2026.4.5 - Table of Contents

LLM model metadata catalog with fast, capability-aware lookups.

## Pages

- [LLM DB - A LLM Model Metadata Database](readme.md)
- [Changelog](changelog.md)

- Guides
  - [Model Spec Formats](model-spec-formats.md)
  - [Pricing and Billing](pricing-and-billing.md)
  - [Schema System](schema-system.md)
  - [Sources and Engine](sources-and-engine.md)
  - [Runtime Filters](runtime-filters.md)
  - [Using the Data](using-the-data.md)
  - [Release Process](release-process.md)

## Modules

- [LLMDB](LLMDB.md): Fast, persistent_term-backed LLM model metadata catalog.
- [LLMDB.Application](LLMDB.Application.md): OTP Application for LLMDB.
- [LLMDB.Config](LLMDB.Config.md): Configuration reading and normalization for LLMDB.
- [LLMDB.DeepMergeShim](LLMDB.DeepMergeShim.md): Shim to call DeepMerge.deep_merge/3 with a 3-arity resolver without Dialyzer false positives.
- [LLMDB.Engine](LLMDB.Engine.md): Pure ETL pipeline for BUILD-TIME LLM model catalog generation.
- [LLMDB.Enrich](LLMDB.Enrich.md): Lightweight, deterministic enrichment of model data.
- [LLMDB.Enrich.AzureWireProtocol](LLMDB.Enrich.AzureWireProtocol.md): Wire protocol enrichment using Azure AI Foundry inference task metadata.
- [LLMDB.Enrich.RuntimeContract](LLMDB.Enrich.RuntimeContract.md): Deterministic runtime-contract enrichment for packaged provider and model data.
- [LLMDB.Generated.ValidModalities](LLMDB.Generated.ValidModalities.md): Auto-generated module containing all valid modality atoms.
- [LLMDB.History](LLMDB.History.md): Read-only runtime access to generated model history artifacts.
- [LLMDB.History.Backfill](LLMDB.History.Backfill.md): Backfills model history by diffing committed provider snapshots across git history.
- [LLMDB.History.Bundle](LLMDB.History.Bundle.md): Snapshot-store helpers for local history bundles.

- [LLMDB.History.Migrator](LLMDB.History.Migrator.md): One-time migration from Git-tracked metadata history into snapshot-store artifacts.
- [LLMDB.History.Rebuilder](LLMDB.History.Rebuilder.md): Rebuilds snapshot-based history artifacts from an ordered snapshot observation chain.
- [LLMDB.Loader](LLMDB.Loader.md): Handles loading and merging of packaged snapshots with runtime customization.
- [LLMDB.Merge](LLMDB.Merge.md): Precedence-aware merging with exclude handling for LLM model data.
- [LLMDB.Model](LLMDB.Model.md): Model struct with Zoi schema validation.
- [LLMDB.Normalize](LLMDB.Normalize.md): Complete normalization utilities for raw data into consistent formats.
- [LLMDB.Packaged](LLMDB.Packaged.md): Provides access to the packaged base snapshot.
- [LLMDB.Pricing](LLMDB.Pricing.md): Pricing pipeline for converting legacy cost data and applying provider defaults.
- [LLMDB.Provider](LLMDB.Provider.md): Provider struct with Zoi schema validation.
- [LLMDB.Query](LLMDB.Query.md): Query functions for selecting models based on capabilities and requirements.
- [LLMDB.Runtime](LLMDB.Runtime.md): Runtime configuration compilation for consumer applications.
- [LLMDB.Snapshot](LLMDB.Snapshot.md): Canonical snapshot artifact helpers.
- [LLMDB.Snapshot.Builder](LLMDB.Snapshot.Builder.md): Builds canonical snapshot artifacts from configured sources.

- [LLMDB.Snapshot.ReleaseStore](LLMDB.Snapshot.ReleaseStore.md): GitHub Releases-backed snapshot artifact store.
- [LLMDB.Source](LLMDB.Source.md): Unified data source interface for LLMDB.
- [LLMDB.Sources.Anthropic](LLMDB.Sources.Anthropic.md): Remote source for Anthropic models (https://api.anthropic.com/v1/models).
- [LLMDB.Sources.Google](LLMDB.Sources.Google.md): Remote source for Google Gemini models (https://generativelanguage.googleapis.com/v1beta/models).
- [LLMDB.Sources.Llmfit](LLMDB.Sources.Llmfit.md): Sidecar source for llmfit open-weight metadata.
- [LLMDB.Sources.Local](LLMDB.Sources.Local.md): Loads model metadata from local TOML files in a directory structure.
- [LLMDB.Sources.ModelsDev](LLMDB.Sources.ModelsDev.md): Remote source for models.dev metadata (https://models.dev/api.json).
- [LLMDB.Sources.OpenAI](LLMDB.Sources.OpenAI.md): Remote source for OpenAI models (https://api.openai.com/v1/models).
- [LLMDB.Sources.OpenRouter](LLMDB.Sources.OpenRouter.md): Remote source for OpenRouter metadata (https://openrouter.ai/api/v1/models).
- [LLMDB.Sources.XAI](LLMDB.Sources.XAI.md): Remote source for xAI (Grok) models (https://api.x.ai/v1/models).
- [LLMDB.Sources.Zenmux](LLMDB.Sources.Zenmux.md): Remote source for Zenmux models (https://zenmux.ai/api/v1/models).
- [LLMDB.Spec](LLMDB.Spec.md): Canonical "provider:model" spec parsing and resolution.
- [LLMDB.Store](LLMDB.Store.md): Manages persistent_term storage for LLM model snapshots with atomic swaps.
- [LLMDB.Validate](LLMDB.Validate.md): Validation functions for providers and models using Zoi schemas.

## Mix Tasks

- [mix llm_db.build](Mix.Tasks.LlmDb.Build.md): Builds a canonical `snapshot.json` from configured sources.
- [mix llm_db.history.backfill](Mix.Tasks.LlmDb.History.Backfill.md): Backfills model history from committed provider snapshots.
- [mix llm_db.history.check](Mix.Tasks.LlmDb.History.Check.md): Checks whether the local installed history bundle matches the published
history metadata in the snapshot store.
- [mix llm_db.history.migrate_git](Mix.Tasks.LlmDb.History.MigrateGit.md): Performs the one-time migration from legacy Git-tracked metadata commits into
content-addressed snapshots plus snapshot-based history artifacts.
- [mix llm_db.history.rebuild](Mix.Tasks.LlmDb.History.Rebuild.md): Rebuilds local history artifacts from the published snapshot observation chain,
then bundles the result and optionally republishes `history.tar.gz` plus
`history-meta.json` to an immutable `history-<snapshot_id>` release for the
latest snapshot in the chain.

- [mix llm_db.history.sync](Mix.Tasks.LlmDb.History.Sync.md): Downloads the published history bundle from the snapshot store and extracts it
into the local history directory.
- [mix llm_db.install](Mix.Tasks.LlmDb.Install.md): Install and configure LLM DB for use in an application.
- [mix llm_db.models](Mix.Tasks.LlmDb.Models.md): Lists all models from the LLMDB catalog with lifecycle status and aliases.
- [mix llm_db.pull](Mix.Tasks.LlmDb.Pull.md): Pulls latest model metadata from all configured remote sources and caches locally.
- [mix llm_db.snapshot.build](Mix.Tasks.LlmDb.Snapshot.Build.md): Alias for `mix llm_db.build`.

- [mix llm_db.snapshot.fetch](Mix.Tasks.LlmDb.Snapshot.Fetch.md): Fetches a published snapshot from GitHub Releases.
- [mix llm_db.snapshot.publish](Mix.Tasks.LlmDb.Snapshot.Publish.md): Builds and publishes a canonical snapshot to GitHub Releases.
- [mix llm_db.version](Mix.Tasks.LlmDb.Version.md): Updates the version in mix.exs to CalVer format (YYYY.M.PATCH).

