mirror of https://github.com/agent0ai/agent-zero.git synced 2026-05-17 04:01:13 +00:00

Alessandro 983d431a5e browser: replace browser-use agent with native browser

Introduce the new built-in Browser plugin for Agent Zero, replacing the legacy
browser-use-based browser agent with a direct Playwright-powered browser tool,
live WebUI viewer, browser session controls, status APIs, configuration, and
extension-management support.

Add browser-specific modal behavior so the browser can run as a floating,
resizable, no-backdrop window, including modal focus, toggle, and idempotent
open helpers for richer WebUI surfaces.

Remove the old `_browser_agent` core plugin and the `browser-use` dependency,
then clean up stale browser-model wiring and references across agent code,
model configuration docs, setup guides, troubleshooting docs, skills, and
Agent Zero knowledge.

Update regression and WebUI extension-surface coverage for the new browser
architecture and modal behavior.

The legacy browser-use implementation has been extracted from core so it can
continue separately as a community plugin published through the A0 Plugin Index for any user or professional that were relying on it for workflow.

2026-04-24 15:43:52 +02:00

2.9 KiB

Raw Permalink Blame History

Model Configuration

Manage which models Agent Zero uses for chat, utility, and embeddings, with support for scoped overrides and reusable presets.

What It Does

This plugin centralizes model selection and model-related settings for the application. It provides helpers and APIs for:

selecting chat, utility, and embedding models
reading and saving model presets
checking for missing API keys
allowing optional per-chat model overrides
resolving config at global, project, agent, and chat scope

Main Behavior

Scoped configuration
- Reads plugin config through the standard plugin config system with project and agent overrides.
Preset management
- Loads presets from a user file when present and falls back to bundled defaults.
- Project presets can be stored beside a project's scoped model config.
Per-chat override
- Allows a chat context to store a temporary override or preset reference in context data.
Model object construction
- Builds ModelConfig objects and the runtime chat, utility, and embedding wrappers used elsewhere in the app.
API key validation
- Reports configured providers that still require API keys.

Key Files

Core helper
- helpers/model_config.py resolves config, presets, overrides, and runtime model objects.
APIs
- api/model_config_get.py
- api/model_config_set.py
- api/model_override.py
- api/model_presets.py
- api/model_search.py
- api/api_keys.py
Hooks
- hooks.py exposes plugin-level integration hooks.

Configuration Scope

Settings section: agent
Per-project config: true
Per-agent config: true
Always enabled: true

Project-Scoped Model Config

Projects store copied model settings in the standard scoped plugin path:

/a0/usr/projects/<project>/.a0proj/plugins/_model_config/config.json

Project-only presets live beside that config:

/a0/usr/projects/<project>/.a0proj/plugins/_model_config/presets.yaml

The project preset file uses the same plain YAML list schema as global presets. It does not contain scope metadata:

- name: Research
  chat:
    provider: openrouter
    name: anthropic/claude-sonnet-4.6
    api_base: ""
    ctx_length: 200000
    ctx_history: 0.7
    vision: true
  utility:
    provider: openrouter
    name: openai/gpt-5.4-mini
    api_base: ""
    ctx_length: 128000
    ctx_input: 0.7

Selecting a preset for a project copies the preset's chat and optional utility settings into the project's config.json. The embedding model is copied from the current effective config, because presets currently define chat and utility only.

Plugin Metadata

Name: _model_config
Title: Model Configuration
Description: Manages LLM model selection and configuration for chat, utility, and embedding models. Supports per-project and per-agent overrides with optional per-chat model switching.

2.9 KiB Raw Permalink Blame History