Function create_model

libs/code/deepagents_code/config.py:4095–4365

Create a chat model. Uses `init_chat_model` for standard providers, or imports a custom `BaseChatModel` subclass when the provider has a `class_path` in config. Supports `provider:model` format (e.g., `'openai:gpt-5.5'`) for explicit provider selection, or bare model names for auto

(
    model_spec: str | None = None,
    *,
    extra_kwargs: dict[str, Any] | None = None,
    profile_overrides: dict[str, Any] | None = None,
)

def create_model(
    model_spec: str | None = None,
    *,
    extra_kwargs: dict[str, Any] | None = None,
    profile_overrides: dict[str, Any] | None = None,
) -> ModelResult:
    """Create a chat model.

    Uses `init_chat_model` for standard providers, or imports a custom
    `BaseChatModel` subclass when the provider has a `class_path` in config.

    Supports `provider:model` format (e.g., `'openai:gpt-5.5'`)
    for explicit provider selection, or bare model names for auto-detection.

    Args:
        model_spec: Model specification in `provider:model` format (e.g.,
            `'anthropic:claude-sonnet-4-5'`, `'openai:gpt-5.5'`) or just the model
            name for auto-detection (e.g., `'claude-sonnet-4-5'`).

                If not provided, uses environment-based defaults.
        extra_kwargs: Additional kwargs to pass to the model constructor.

            These take highest priority, overriding values from the config file.

            A `CLI_MAX_RETRIES_KEY` entry (set by the `--max-retries` flag) is
            treated specially: it is popped here and re-applied under the
            provider's resolved retry-param name with top precedence, rather than
            being forwarded verbatim to the constructor.
        profile_overrides: Extra profile fields from `--profile-override`.

            Merged on top of config file profile overrides (dcode wins).

    Returns:
        A `ModelResult` containing the model and its metadata.

    Raises:
        ModelConfigError: If provider cannot be determined from the model name
            or required provider package is not installed.
        MissingCredentialsError: If no credentials are configured for the
            resolved provider.

    Examples:
        >>> model = create_model("anthropic:claude-sonnet-4-5")
        >>> model = create_model("openai:gpt-5.5")
        >>> model = create_model("gpt-5.5")  # Auto-detects openai
        >>> model = create_model()  # Uses environment defaults
    """
    from deepagents_code.model_config import (
        IMPLICIT_AUTH_PROVIDERS,
        ModelConfig,
        ModelConfigError,
        ModelSpec,
        apply_stored_credentials,
        get_credential_env_var,
        has_provider_credentials,
        warn_on_split_credential_source,
    )