ProviderProfile

Static keyword arguments forwarded to init_chat_model.

Once a profile is constructed, its kwargs can be read but not rewritten — for example, profile.init_kwargs["temperature"] = 2.0 raises TypeError. The registry stores its own defensive copy, so mutating the dict you passed into the constructor after the fact won't affect the registered profile either. To change a registered profile's kwargs, re-register (which merges on top) or construct a new profile.

When both init_kwargs and init_kwargs_factory are set on the same profile, the factory's output overrides init_kwargs on key collision.

Optional callable invoked with the raw model spec before initialization.

Runs before init_kwargs_factory is invoked and before init_chat_model is called; if it raises, the factory does not run and no model is constructed. Use for side-effectful checks that must run before init_chat_model (e.g. minimum-version enforcement). Raise to abort model construction.

Optional factory producing dynamic init kwargs at resolution time.

Use when values depend on runtime state such as environment variables.

Within a single profile, whenever the factory and init_kwargs set the same key, the factory's value wins. For example:

ProviderProfile(
    init_kwargs={"temperature": 0, "timeout": 30},
    init_kwargs_factory=lambda: {"temperature": 0.7, "base_url": os.environ["BASE_URL"]},
)

At resolution, this forwards temperature=0.7 (factory wins), timeout=30 (only in static), and base_url=<env value> (only from factory) to init_chat_model.

When merging profiles, if both the base and override profiles define a factory, both run at every resolution — base first, then override — and their outputs merge with the override's values winning on any shared keys. A worked example: the built-in OpenRouter factory always sets app_url and app_title; layer a user profile whose factory reads a per-tenant OPENROUTER_APP_TITLE_TENANT env var and sets app_title from it. Every resolution runs both factories; the user's app_title replaces the built-in, while the built-in's app_url is preserved.