modelparams 0.0.1__py3-none-any.whl

modelparams/validation.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from functools import cache
+from typing import Any, cast
+
+from pydantic import TypeAdapter
+
+from ._generated.model_ids import ModelId
+from ._generated.registry import PARAM_TYPES
+from .models import JsonPrimitive
+
+
+@cache
+def params_adapter(model_id: ModelId) -> TypeAdapter[Any]:
+    return TypeAdapter(PARAM_TYPES[model_id])
+
+
+def validate_params(model_id: ModelId, params: object) -> dict[str, JsonPrimitive]:
+    return cast(dict[str, JsonPrimitive], params_adapter(model_id).validate_python(params))

modelparams-0.0.1.dist-info/METADATA

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: modelparams
+Version: 0.0.1
+Summary: Typed model parameters for Python, generated from the modelparams.dev catalog.
+Project-URL: Homepage, https://modelparams.dev
+Project-URL: Repository, https://github.com/mnfst/modelparameters.dev
+Project-URL: Issues, https://github.com/mnfst/modelparameters.dev/issues
+Author: modelparams.dev contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,llm,model-parameters,pydantic,typing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pydantic<3,>=2.10
+Requires-Dist: typing-extensions>=4.12
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Requires-Dist: twine>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# modelparams
+
+Typed model parameters for Python, generated from the open
+[modelparams.dev](https://modelparams.dev) catalog.
+
+```bash
+pip install modelparams
+```
+
+## Typed request parameters
+
+Generated `TypedDict` definitions provide autocomplete and static errors for unsupported keys,
+incorrect value types, and invalid enum values:
+
+```python
+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.
+
+```python
+from openai import OpenAI
+
+OpenAI().chat.completions.create(model="gpt-4.1", messages=messages, **validated)
+```
+
+Provider-specific dot paths remain literal dictionary keys:
+
+```python
+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
+
+```python
+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:
+
+```bash
+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.

modelparams-0.0.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+modelparams/__init__.py,sha256=nouNDDxx5IVmKr3gL2g0bfd4ofc5qBuVWivxcdRcNFc,1120
+modelparams/catalog.py,sha256=r8mYGtSEM-aPGspECmK5aojtvGKNLtFHozRafxJYiq4,1828
+modelparams/models.py,sha256=eSALYojcFesln7MaCeWw70dztkKF163_I2Z-_84pGDo,1753
+modelparams/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+modelparams/validation.py,sha256=sUeCwBczGScZQH7IyU-kdOvrs9VeAM0_Ik9MXmnSEfs,541
+modelparams/_generated/__init__.py,sha256=z0HeJhBAyprM_tz9scFxEDrtExlso4I7eu-DgsKKGR0,146
+modelparams/_generated/catalog.json,sha256=nrj_kP7s5mWBUa9SLFDfgCE04oSf5WE1TkTdarYEcTQ,504529
+modelparams/_generated/model_ids.py,sha256=17PE0FJbpjZCK5PGqWGYq9aCzOG_urHCheCxGO_wUI8,17702
+modelparams/_generated/registry.py,sha256=f1P_S-aukDcp-IQePxi6tQ9K5vPFAHXOnHtdRh5VEIA,17792
+modelparams/types/__init__.py,sha256=ZuGQ9XxP5Kt0jJuivCGwitkHOXOcuS7lVMaiT0HdG0k,356
+modelparams/types/alibaba.py,sha256=IMSlN0rMvv-CA_bC4AKQIxtIWNQqjWVJNAYQvNjBeYQ,6011
+modelparams/types/anthropic.py,sha256=oZbf2cotGlHNb9zra_OpubY-a-aeDoks8Rq5mfY9rXI,23616
+modelparams/types/cerebras.py,sha256=gqJPVqOFyxThkvQ0ElNcEKFkTWxEEhLkQ2mTLH6oOKU,1055
+modelparams/types/cohere.py,sha256=rvtI8oShvYaWnIrbhlB-QekUZw3B9G8bJetVAy3PQUc,6911
+modelparams/types/deepseek.py,sha256=1-7Oq6LJjhzDDvWIMCnEb1mpVRk6WXoVx7xuYsD8Skw,2194
+modelparams/types/google.py,sha256=ODa5Fos8uuPp9ZPVgLKmX5DoRziub0nT1TGsYmkFjZ4,16132
+modelparams/types/groq.py,sha256=MZEMj1P4G8mvPkmE15OFb3GORa7hySjT72YRPDocP_E,1065
+modelparams/types/meta.py,sha256=L1whJJh6zWfVNpGLS3DiU2-z54TwZZvkvRc5sloSzRs,2558
+modelparams/types/minimax.py,sha256=HBGpDlQHNSJ0K25sgZVGquxDPUdZ5bu80V1rbW9659g,7014
+modelparams/types/mistral.py,sha256=r-eq2sCFqDiIuUBZqf4T_k15KAykObgYEKTvqkNJVck,9246
+modelparams/types/moonshot.py,sha256=nSl4ujAobUlNWYeQb-8Wg7rcm8fF3dJStk3NQNag9io,5174
+modelparams/types/nvidia.py,sha256=HsO6XjqPwCfMYMmhf2T6OeWotNL9tXEr7qRCnfBgs90,9003
+modelparams/types/openai.py,sha256=0FjqUzvbQ4DVk3P_TAjKvpdykyu7JCf6jWNFKW2PMFE,19088
+modelparams/types/perplexity.py,sha256=zCn4TnyNCEos97lh4c8yZnZdpCOaIlpksH5bMwrtRP8,3651
+modelparams/types/thinking_machines.py,sha256=E473QST64OCbWgskbzOoAy2W4gT-2sdZugRtVvJFMnU,783
+modelparams/types/xai.py,sha256=8Eeb-9PzJN-ZekJGpm-jv00GTrRogm5c0kev_7z9rYY,6274
+modelparams/types/xiaomi.py,sha256=iH-e7I9PMgO5G9LpcUtIJ1NZGnlssFaFq-HMqqLsG_4,1987
+modelparams/types/z_ai.py,sha256=Z1s5xr1bgC6rQafI7Jtdu3e3uPv5Eb9LZXpi42b8WEg,11222
+modelparams-0.0.1.dist-info/METADATA,sha256=HC9wY6C91o43uPGnyDtFMByKAhUkLQYSSJxARqrVxXg,3288
+modelparams-0.0.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+modelparams-0.0.1.dist-info/licenses/LICENSE,sha256=m-i-2Cglz658ZXbK7m5Za4Ftp8WmTVI2DuOE0_FqQpM,1085
+modelparams-0.0.1.dist-info/RECORD,,

modelparams-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

modelparams-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 modelparams.dev contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.