Skip to content

Agent Zero AI framework

Refresh onboarding screenshots in docs

Alessandro50f80d57dc9b
diff --git a/docs/README.md b/docs/README.md
index d9dac83ee..5c668f029 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -13,7 +13,7 @@ docs focus on practical setup, screenshots, and user workflows.
- **[Quickstart Guide](quickstart.md):** Get up and running in 5 minutes with Agent Zero.
- **[Agent Zero Launcher](guides/launcher.md):** Use the desktop app to set up Docker, install Agent Zero, open Instances, or connect a remote Instance.
-- **[First-Run Onboarding](guides/onboarding.md):** Choose Cloud or Local, add a provider key, and select main and utility models.
+- **[First-Run Onboarding](guides/onboarding.md):** Choose Cloud, AI account, or Local access, then select main and utility models.
- **[Installation Guide](setup/installation.md):** A0 Launcher downloads, A0 Install, direct Docker, updates, and advanced Docker setup (includes [How to Update](setup/installation.md#how-to-update-agent-zero)).
- **[A0 CLI Connector](guides/a0-cli-connector.md):** Install the host connector for a running Agent Zero instance, use the command palette, and switch Browser modes.
- **[Self Update](guides/self-update.md):** How the in-app updater works (technical reference).
diff --git a/docs/guides/onboarding.md b/docs/guides/onboarding.md
index 012e56c5c..1b9879190 100644
--- a/docs/guides/onboarding.md
+++ b/docs/guides/onboarding.md
@@ -1,62 +1,59 @@
# First-Run Onboarding
Use onboarding the first time you open Agent Zero, or any time the Web UI says
-your models still need setup. The wizard helps you pick a provider, add the
-needed key or connection, choose the main model, choose the utility model, and
-start chatting.
+your models still need setup. The wizard helps you pick Cloud, AI account, or
+Local access, configure a main model, choose a utility model, and start
+chatting.
-This example uses **Agent Zero API** with a fake demo key and
-`claude-opus-4-6`. Replace the demo key with your own key.
+This example uses **OpenRouter** with a masked demo key. Replace the demo key
+with your own key.
-## Choose Cloud Or Local
+## Open Onboarding
-Open the Web UI and click **Start Onboarding** from the welcome banner. On the
-first screen, choose whether Agent Zero should use a hosted provider or a local
-model server.
+Open the Web UI. The welcome screen can show account shortcuts, and the message
+composer is ready immediately.
-![Onboarding start screen with Cloud and Local choices](../res/usage/onboarding/onboarding-start.png)
+![Welcome screen with account and channel setup cards](../res/usage/onboarding/onboarding-start.png)
-Choose **Cloud** when you want to use Agent Zero API, OpenRouter, Anthropic,
-OpenAI, Google, Venice, or another hosted provider. Choose **Local** when you
-want to connect to Ollama, LM Studio, or another model server running on your
-machine.
+If you send a message before models are configured, Agent Zero creates the chat,
+holds the message, and shows the model gate inside the conversation. Choose
+**Cloud provider**, **AI account**, or **Local model** to open onboarding.
-## Pick Agent Zero API
+![Chat model gate with Cloud provider, AI account, and Local model choices](../res/usage/onboarding/onboarding-model-gate.png)
-On the Cloud provider screen, click **Agent Zero API**.
+## Choose A Provider Path
-![Cloud provider picker with Agent Zero API](../res/usage/onboarding/onboarding-cloud-provider.png)
+Choose **Cloud** when you want to paste an API key for OpenRouter, OpenAI,
+Anthropic, Google, Venice, or another hosted provider.
-The ChatGPT/Codex account option is also available on this Cloud screen if you
-want to connect by device code instead of pasting a provider key.
+![Cloud provider picker with hosted providers](../res/usage/onboarding/onboarding-cloud-provider.png)
-## Add The Key And Main Model
+Choose **Account** when you want to sign in with Codex/ChatGPT, GitHub Copilot,
+Google Cloud Gemini, or xAI Grok instead of pasting a provider key.
-Paste your Agent Zero API key in **API key**. The screenshot uses a fake example
-key, and the field is masked.
+![AI account picker with Codex, Copilot, Google Cloud Gemini, and Grok](../res/usage/onboarding/onboarding-account-provider.png)
-Click the magnifier in **Main model** to open the model list, then choose
-`claude-opus-4-6`.
+Choose **Local** when you want to connect to Ollama, LM Studio, oMLX, llama.cpp,
+vLLM, or another model server running on your machine.
-![Agent Zero API setup with model dropdown open](../res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png)
+![Local model provider picker with Ollama, LM Studio, oMLX, llama.cpp, and vLLM](../res/usage/onboarding/onboarding-local-ollama-main.png)
-After the model is selected, click **Choose utility model**.
+## Configure The Main Model
-![Agent Zero API setup with key and main model selected](../res/usage/onboarding/onboarding-agent-zero-api-key-model.png)
+For API-key providers, choose the main model and paste the provider key. The
+screenshot uses a masked demo key.
-## Choose The Utility Model
+![OpenRouter setup with main model and masked API key](../res/usage/onboarding/onboarding-agent-zero-api-key-model.png)
-The utility model handles supporting work such as summarizing, organizing
-memory, and other background tasks.
+After the main model is selected, click **Choose utility model**.
-Leave **Use same as Main Model** checked if you want both roles to use
-`claude-opus-4-6`.
+## Choose The Utility Model
-![Utility model step using the same model as main](../res/usage/onboarding/onboarding-utility-same-model.png)
+The utility model handles quick internal tasks such as summaries, naming, and
+memory. A small, fast, cheap model usually works best here. The wizard may
+prefill a utility provider and model, but it remains an explicit choice.
-You can also uncheck **Use same as Main Model** and choose a different utility
-provider and model. For example, you might keep a strong main model for chat and
-use a faster or cheaper model for utility tasks.
+![Utility model step with OpenRouter and a fast Gemini model](../res/usage/onboarding/onboarding-utility-same-model.png)
Click **Finish setup** when the utility model looks right.
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 491d086cf..bdc446cf3 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -62,18 +62,19 @@ For the full setup flow, host picker screenshots, command palette guidance, Brow
### Open the Web UI and complete onboarding
Open your browser and navigate to `http://localhost:<PORT>`. The Web UI will
-show the onboarding banner. Click **Start Onboarding** to choose Cloud or
-Local, add a provider key or account connection, and select your main and
-utility models.
+open on the welcome screen. If models still need setup, send a message or use
+the setup shortcuts to choose Cloud, AI account, or Local access, then select
+your main and utility models.
![Agent Zero Web UI](res/setup/6-docker-a0-running-new.png)
-For a screenshot walkthrough using **Agent Zero API** with
-`claude-opus-4-6`, see the [First-Run Onboarding guide](guides/onboarding.md).
+For a screenshot walkthrough using OpenRouter, see the
+[First-Run Onboarding guide](guides/onboarding.md).
> [!NOTE]
-> Agent Zero supports hosted providers and local models. You can use the same
-> provider for main and utility work, or choose separate providers for each.
+> Agent Zero supports hosted providers, account-backed providers, and local
+> models. Choose a strong main model for chat and a fast utility model for
+> internal tasks.
### Start your first chat
diff --git a/docs/res/usage/onboarding/onboarding-account-provider.png b/docs/res/usage/onboarding/onboarding-account-provider.png
new file mode 100644
index 000000000..803b1ea46
Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-account-provider.png differ
diff --git a/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.png b/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.png
index c46498169..28aeebef7 100644
Binary files a/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.png and b/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.png differ
diff --git a/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png b/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png
index b899b35ad..28aeebef7 100644
Binary files a/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png and b/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png differ
diff --git a/docs/res/usage/onboarding/onboarding-cloud-provider.png b/docs/res/usage/onboarding/onboarding-cloud-provider.png
index efcb181fd..dcdbcc481 100644
Binary files a/docs/res/usage/onboarding/onboarding-cloud-provider.png and b/docs/res/usage/onboarding/onboarding-cloud-provider.png differ
diff --git a/docs/res/usage/onboarding/onboarding-local-ollama-main.png b/docs/res/usage/onboarding/onboarding-local-ollama-main.png
new file mode 100644
index 000000000..3c7891c44
Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-local-ollama-main.png differ
diff --git a/docs/res/usage/onboarding/onboarding-model-gate.png b/docs/res/usage/onboarding/onboarding-model-gate.png
new file mode 100644
index 000000000..457939151
Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-model-gate.png differ
diff --git a/docs/res/usage/onboarding/onboarding-ready.png b/docs/res/usage/onboarding/onboarding-ready.png
index 81b215f68..c11a6ce38 100644
Binary files a/docs/res/usage/onboarding/onboarding-ready.png and b/docs/res/usage/onboarding/onboarding-ready.png differ
diff --git a/docs/res/usage/onboarding/onboarding-start.png b/docs/res/usage/onboarding/onboarding-start.png
index 5102833d1..eb618ed4d 100644
Binary files a/docs/res/usage/onboarding/onboarding-start.png and b/docs/res/usage/onboarding/onboarding-start.png differ
diff --git a/docs/res/usage/onboarding/onboarding-utility-same-model.png b/docs/res/usage/onboarding/onboarding-utility-same-model.png
index 992497535..f0c7048d9 100644
Binary files a/docs/res/usage/onboarding/onboarding-utility-same-model.png and b/docs/res/usage/onboarding/onboarding-utility-same-model.png differ
diff --git a/docs/setup/installation.md b/docs/setup/installation.md
index 8306508aa..3571d0f99 100644
--- a/docs/setup/installation.md
+++ b/docs/setup/installation.md
@@ -401,10 +401,10 @@ docker run -p 0:80 -v /path/to/your/work_dir:/a0/usr agent0ai/agent-zero
## Step 3: Configure Agent Zero
-The UI will show a welcome banner when model setup is missing. Click
-**Start Onboarding** to choose Cloud or Local, add a provider key or account
-connection, and select your main and utility models. For the screenshot
-walkthrough, see the [First-Run Onboarding guide](../guides/onboarding.md).
+The UI opens on the welcome screen. If model setup is missing, send a message
+or use the setup shortcuts to choose Cloud, AI account, or Local access, then
+select your main and utility models. For the screenshot walkthrough, see the
+[First-Run Onboarding guide](../guides/onboarding.md).
### Settings Configuration