Browser Model Override

Browser Model Override is an Agent Zero plugin that overrides Agent.get_browser_model() so the bundled browser agent can use a dedicated LLM instead of the main chat model.

What It Does

• keeps the main chat model unchanged
• routes browser-use decisions through a separate model
• creates plugin-local config.json automatically on ZIP or Git install
• exposes a plugin config screen for browser model settings
• fails clearly if the browser model is enabled but not configured

Installation

This plugin is intended to be published with the plugin root as the repository root.

• ZIP install: install the archive through Agent Zero's plugin installer
• Git install: install the repository directly through Agent Zero's Git plugin installer

On first install, the plugin creates config.json from default_config.yaml automatically.

Configuration

The generated config file lives at:

usr/plugins/browser_model_override/config.json

Example:

{
  "browser_model": {
    "provider": "openrouter",
    "name": "anthropic/claude-3.7-sonnet",
    "api_key": "",
    "api_base": "",
    "ctx_length": 128000,
    "vision": true,
    "rl_requests": 0,
    "rl_input": 0,
    "rl_output": 0,
    "kwargs": {}
  }
}

Required fields:

• browser_model.provider
• browser_model.name

Enable or disable the plugin itself through Agent Zero's Plugins UI.

If the plugin is enabled there and either required field is missing, browser tasks fail with a clear configuration error instead of falling back to the main chat model.

Compatibility

• requires Agent Zero with the bundled _browser_agent plugin enabled
• designed as an addon plugin, not a replacement browser tool

License

MIT