modelparams

Typed model parameters for Python, generated from the open modelparams.dev catalog.

pip install modelparams

Typed request parameters

Generated TypedDict definitions provide autocomplete and static errors for unsupported keys, incorrect value types, and invalid enum values:

from modelparams import validate_params
from modelparams.types.openai import Gpt_4_1Params

params: Gpt_4_1Params = {
    "max_tokens": 1024,
    "temperature": 0.7,
}

validated = validate_params("openai/gpt-4.1", params)

validate_params uses a cached strict Pydantic adapter. It returns a provider-keyed dictionary or raises pydantic.ValidationError for unknown parameters, coercions, invalid enum values, or values outside the catalog range.

from openai import OpenAI

OpenAI().chat.completions.create(model="gpt-4.1", messages=messages, **validated)

Provider-specific dot paths remain literal dictionary keys:

from modelparams.types.anthropic import Claude_Haiku_4_5_20251001Params

params: Claude_Haiku_4_5_20251001Params = {
    "thinking.type": "enabled",
    "thinking.budget_tokens": 4096,
}

Catalog helpers

from modelparams import get_defaults, get_model, get_param, list_models

model = get_model("anthropic/claude-haiku-4-5-20251001")
print(model.auth_type, model.params)

defaults = get_defaults("anthropic/claude-haiku-4-5-20251001")
thinking = get_param("anthropic/claude-haiku-4-5-20251001", "thinking.type")
anthropic_models = list_models("anthropic")

The catalog is bundled with the package. No network request is made at runtime.

Development

From the repository root:

npm run codegen:python
uv sync --project packages/modelparams-python --extra dev
uv run --project packages/modelparams-python pytest packages/modelparams-python/tests

Generated catalog and type files are committed and verified in CI. Python releases use independent modelparams-py@x.y.z tags and publish to PyPI through the repository's trusted-publisher workflow.

Catalog entries expose api_surface as a typed value, so callers can distinguish request families such as openai-chat-completions and openai-responses before using a parameter set.

Metadata

Release files for modelparams 0.0.52

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for modelparams 0.0.52
File	Size	Uploaded
modelparams-0.0.52.tar.gz	51.6 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for modelparams 0.0.52
File	Interpreter	ABI	Platform	Reset
modelparams-0.0.52-py3-none-any.whl 69.0 kB Oct 9, 2026	Python 3	none	any	Details

Total release size: 120.6 kB

Release files / modelparams-0.0.52.tar.gz

Download URL	modelparams-0.0.52.tar.gz
Size	51.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`c485a972653fbd5d6a46941896a47c80b62cdab00467ea9a351a023d85cbbf4e`
BLAKE2b-256 checksum How to use checksums	`3da174950f3a4a8c2494e21c8b0bd5150f6e1f529951ad5600223275d43f213b`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mnfst/modelparams.dev
Publishing commit: github.com/mnfst/modelparams.dev/tree/37a16d3ade07b4c058f8bf9a7bc1b0245abc90d1

Workflow

Publishing configuration: github.com/mnfst/modelparams.dev/blob/37a16d3ade07b4c058f8bf9a7bc1b0245abc90d1/.github/workflows/release-modelparams-python.yml
Publishing logs: github.com/mnfst/modelparams.dev/actions/runs/37890402106/attempts/1

Artifact

Subject: modelparams-0.0.52.tar.gz
SHA-256 checksum: c485a972653fbd5d6a46941896a47c80b62cdab00467ea9a351a023d85cbbf4e Verifying attestations

Release files / modelparams-0.0.52-py3-none-any.whl

Download URL	modelparams-0.0.52-py3-none-any.whl
Size	69.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`384dd6b8d37c4731b4d391be6d4efe6f7563a8e104919e206f3c781b2f9cf299`
BLAKE2b-256 checksum How to use checksums	`0caebaf87e461e2f281ffea33f06dc76befe5febe6077f819d734e3eb31418e3`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mnfst/modelparams.dev
Publishing commit: github.com/mnfst/modelparams.dev/tree/37a16d3ade07b4c058f8bf9a7bc1b0245abc90d1

Workflow

Publishing configuration: github.com/mnfst/modelparams.dev/blob/37a16d3ade07b4c058f8bf9a7bc1b0245abc90d1/.github/workflows/release-modelparams-python.yml
Publishing logs: github.com/mnfst/modelparams.dev/actions/runs/37890402106/attempts/1

Artifact

Subject: modelparams-0.0.52-py3-none-any.whl
SHA-256 checksum: 384dd6b8d37c4731b4d391be6d4efe6f7563a8e104919e206f3c781b2f9cf299 Verifying attestations