What's Changed

• feat: simplify model and model provider configuration by @adi-wan-askui in https://github.com/askui/vision-agent/pull/173

🚀 Features

• Simplified Model Provider Configuration:

• Multi-Cloud Provider Support: Added native support for Anthropic models hosted on AWS Bedrock and Google Vertex AI. Simply install the optional dependencies (anthropic[bedrock] or anthropic[vertex]) and configure via environment variables. ```python import os from askui import VisionAgent

  Using Vertex AI

  os.environ["ANTHROPIC_VERTEX_PROJECT_ID"] = "test-project" os.environ["CLOUD_ML_REGION"] = "europe-west1"

  with VisionAgent() as agent: agent.act("do something", model="vertex/claude-sonnet-4@20250514") ```

• Provider Registry: Configure model providers through the model registry using keys ending with "/" instead of having to configure each model separately. For example, register "openai/" as a provider and all models prefixed with "openai/" will route to that provider implementation. python with VisionAgent(models={"openai/": YourOpenAiCustomMessagesApi()}) as agent: agent.act("do something", model="openai/gpt-4o") agent.act("do something", model="openai/gpt-5")

• Default Provider Environment Variable: Added ASKUI__VA__MODEL_PROVIDER environment variable to set a default model provider that automatically prefixes all model names.

• Default Model Environment Variable: Added ASKUI__VA__MODEL environment variable for setting the default model. Supports both simple strings and JSON for complex configurations: bash export ASKUI__VA__MODEL='{"act":"askui/claude-sonnet-4-20250514"}'

• Pre-configured Providers: Added "askui/", "bedrock/", "anthropic/", and "vertex/" providers by default, enabling seamless usage like: python agent.act("search", model="askui/claude-sonnet-4-20250514") agent.act("search", model="bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0")

• New Model Support: Added support for claude-haiku-4-5-20251001 and claude-sonnet-4-5-20250929 Anthropic models with updated model cards in documentation.

📜 Documentation

• Enhanced Documentation: Significantly expanded docs/using-models.md with comprehensive guides on model provider configuration, authentication, and custom provider setup.

🚨 BREAKING CHANGES

• Removed model from MessageSettings: The model parameter has been removed from MessageSettings.

• Migration: Use the model parameter of act(), get(), locate() or pass it to a class extending AgentBase instead. ```python # Before (v0.20.x) agent.act("search", settings=ActSettings(messages=MessageSettings(model="claude-haiku-4-5"), model="askui")

  After (v0.21.0)

  agent.act("search", model="askui/claude-haiku-4-5") ```

• Upgraded minimum anthropic dependency to 0.72.0:

• Migration: Replace anthropic.NotGiven with anthropic.Omit and anthropic.NOT_GIVEN with anthropic.omit.

• Renamed model_choice parameter to model: The parameter name has been unified across ActModel.act(), GetModel.get(), and LocateModel.locate().

• Migration: Replace all instances of model_choice= with model=. ```python # Before (v0.20.x) act_model.act("search", model_choice="claude-sonnet-4")

  After (v0.21.0)

  act_model.act("search", model="claude-sonnet-4") ```

• Removed ASKUI__MESSAGES__* and ANTHROPIC__MESSAGES__* environment variables: These configuration variables are no longer supported.

• Migration: Use the settings and model parameters when calling <agent>.act() instead. ```python # Before (v0.20.x) # Set via environment: ASKUI__MESSAGES__MODEL=claude-sonnet-4

  After (v0.21.0)

  agent.act("search", model="claude-sonnet-4", settings=ActSettings(...))

  Or use: ASKUI__VA__MODEL=claude-sonnet-4

  ```

• Removed AgentBase.model property: Direct access to the model property has been removed from AgentBase.

• Migration: Pass the model parameter to individual methods (act(), get(), locate()) or set it via the VisionAgent constructor.

Full Changelog: https://github.com/askui/vision-agent/compare/v0.20.3...v0.21.0