modelparams 0.0.1__tar.gz

modelparams-0.0.1/.gitignore

@@ -0,0 +1,21 @@
+node_modules/
+/dist/
+/build/
+packages/*/dist/
+packages/*/*.tsbuildinfo
+.cache/
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+__pycache__/
+*.py[cod]
+*.log
+.DS_Store
+.env
+.env.local
+.vercel/
+coverage/
+.vscode/
+.idea/
+.gstack/

modelparams-0.0.1/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.

modelparams-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,74 @@
+# 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/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "modelparams"
+version = "0.0.1"
+description = "Typed model parameters for Python, generated from the modelparams.dev catalog."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "modelparams.dev contributors" }]
+keywords = ["ai", "llm", "model-parameters", "pydantic", "typing"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = ["pydantic>=2.10,<3", "typing-extensions>=4.12"]
+
+[project.urls]
+Homepage = "https://modelparams.dev"
+Repository = "https://github.com/mnfst/modelparameters.dev"
+Issues = "https://github.com/mnfst/modelparameters.dev/issues"
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2",
+  "mypy>=1.13",
+  "pytest>=8.3",
+  "ruff>=0.9",
+  "twine>=6.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/modelparams"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/LICENSE", "/README.md", "/pyproject.toml", "/src"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+extend-exclude = ["src/modelparams/_generated", "src/modelparams/types"]
+
+[tool.ruff.lint]
+select = ["B", "E", "F", "I", "UP"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+files = ["src/modelparams", "tests/typecheck"]

modelparams-0.0.1/src/modelparams/__init__.py

@@ -0,0 +1,60 @@
+from importlib import metadata
+
+from ._generated.model_ids import MODEL_IDS, PROVIDERS, ModelId, Provider
+from .catalog import (
+    BY_ID,
+    CATALOG,
+    DEFAULTS,
+    get_defaults,
+    get_model,
+    get_param,
+    list_all_models,
+    list_models,
+)
+from .models import (
+    Applicability,
+    ApplicabilityCondition,
+    CatalogEntry,
+    JsonPrimitive,
+    Parameter,
+    ParamGroup,
+    ParamRange,
+    ParamType,
+)
+from .validation import params_adapter, validate_params
+
+
+def _package_version() -> str:
+    try:
+        return metadata.version("modelparams")
+    except metadata.PackageNotFoundError:
+        return "0+unknown"
+
+
+__version__ = _package_version()
+
+__all__ = [
+    "BY_ID",
+    "CATALOG",
+    "DEFAULTS",
+    "MODEL_IDS",
+    "PROVIDERS",
+    "Applicability",
+    "ApplicabilityCondition",
+    "CatalogEntry",
+    "JsonPrimitive",
+    "ModelId",
+    "Parameter",
+    "ParamGroup",
+    "ParamRange",
+    "ParamType",
+    "Provider",
+    "__version__",
+    "get_defaults",
+    "get_model",
+    "get_param",
+    "list_all_models",
+    "list_models",
+    "params_adapter",
+    "validate_params",
+]

modelparams-0.0.1/src/modelparams/_generated/__init__.py

@@ -0,0 +1,2 @@
+# AUTO-GENERATED by packages/modelparams-python/scripts/codegen.ts.
+# Do not edit by hand; the YAML catalog under /models is the source of truth.