Skip to content

Repository files navigation

Kmodels

A credential-free, auditable catalog of AI models and public pricing across providers.

Explore the catalog · JSON exports · Design decisions

Kmodels collects reviewed official sources into one versioned, static dataset. Model identity stays exact at (provider_id, model_id, version) granularity; pricing retains the conditions that change a rate.

JSON exports

Every profile is generated from the same validated catalog snapshot and carries its version and generation time.

Profile Best for JSON
IDs Small provider → model ID lookup catalog/ids.json
Summary Flat rows with provider, ID, version, tasks, and status catalog/summary.json
Models Default semantic catalog, grouped by provider and model ID with every version catalog/models.json
Full catalog Audit-rich model, source, coverage, warning, and provenance data catalog/index.json
Providers Provider metadata and provider-scoped coverage providers/index.json
Pricing Canonical price books, conditions, validity, and source observations pricing/index.json

Provider-specific exports are available at:

https://kmodels.void.app/providers/<provider>/index.json
https://kmodels.void.app/providers/<provider>/models/index.json

Profiles never guess a “latest” version. Pricing is bound to the exact catalog snapshot; an absent price is unknown, not free.

Reliability

  • Official hosts and parsing rules are reviewed in src/catalog/manifests.ts.
  • Refreshes validate schema drift, model drops, price changes, and provenance per provider.
  • A failed provider refresh retains its last validated partition instead of publishing partial data.
  • Raw responses and credentials are never published. Optional account-scoped sources cannot redefine the public catalog.

Development

vp install
vp run collect
vp dev
Command Purpose
vp run collect Refresh catalog, pricing, projections, and the semantic summary
vp run compile:pricing Recompile canonical pricing offline from retained parsed inputs
vp run prepare:assets Regenerate UI and export assets from the accepted pair
vp run report:refresh Render the latest structured refresh report
vp check Format, lint, and type-check
vp test --run Run fixtures, drift guards, and behavior tests
vp run build Build the static site and materialize validated JSON exports

GitHub Actions refreshes public sources hourly and commits only validated output. Deployment and optional source credentials are documented in docs/automation.md.

About

An auditable catalog of AI provider model offerings

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages