Agent Zero AI framework
Refresh onboarding screenshots in docs
Alessandro50f80d57dc9b
diff --git a/docs/README.md b/docs/README.mdindex 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.mdindex 012e56c5c..1b9879190 100644--- a/docs/guides/onboarding.md+++ b/docs/guides/onboarding.md@@ -1,62 +1,59 @@# First-Run OnboardingUse 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.-+-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+-On the Cloud provider screen, click **Agent Zero API**.+## Choose A Provider Path-+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.+-## 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.+-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.-+-After the model is selected, click **Choose utility model**.+## Configure The Main Model-+For API-key providers, choose the main model and paste the provider key. The+screenshot uses a masked demo key.-## Choose The Utility Model+-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-+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.+Click **Finish setup** when the utility model looks right.diff --git a/docs/quickstart.md b/docs/quickstart.mdindex 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 onboardingOpen 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.-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 chatdiff --git a/docs/res/usage/onboarding/onboarding-account-provider.png b/docs/res/usage/onboarding/onboarding-account-provider.pngnew file mode 100644index 000000000..803b1ea46Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-account-provider.png differdiff --git a/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.png b/docs/res/usage/onboarding/onboarding-agent-zero-api-key-model.pngindex c46498169..28aeebef7 100644Binary 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 differdiff --git a/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.png b/docs/res/usage/onboarding/onboarding-agent-zero-api-model-dropdown.pngindex b899b35ad..28aeebef7 100644Binary 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 differdiff --git a/docs/res/usage/onboarding/onboarding-cloud-provider.png b/docs/res/usage/onboarding/onboarding-cloud-provider.pngindex efcb181fd..dcdbcc481 100644Binary files a/docs/res/usage/onboarding/onboarding-cloud-provider.png and b/docs/res/usage/onboarding/onboarding-cloud-provider.png differdiff --git a/docs/res/usage/onboarding/onboarding-local-ollama-main.png b/docs/res/usage/onboarding/onboarding-local-ollama-main.pngnew file mode 100644index 000000000..3c7891c44Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-local-ollama-main.png differdiff --git a/docs/res/usage/onboarding/onboarding-model-gate.png b/docs/res/usage/onboarding/onboarding-model-gate.pngnew file mode 100644index 000000000..457939151Binary files /dev/null and b/docs/res/usage/onboarding/onboarding-model-gate.png differdiff --git a/docs/res/usage/onboarding/onboarding-ready.png b/docs/res/usage/onboarding/onboarding-ready.pngindex 81b215f68..c11a6ce38 100644Binary files a/docs/res/usage/onboarding/onboarding-ready.png and b/docs/res/usage/onboarding/onboarding-ready.png differdiff --git a/docs/res/usage/onboarding/onboarding-start.png b/docs/res/usage/onboarding/onboarding-start.pngindex 5102833d1..eb618ed4d 100644Binary files a/docs/res/usage/onboarding/onboarding-start.png and b/docs/res/usage/onboarding/onboarding-start.png differdiff --git a/docs/res/usage/onboarding/onboarding-utility-same-model.png b/docs/res/usage/onboarding/onboarding-utility-same-model.pngindex 992497535..f0c7048d9 100644Binary files a/docs/res/usage/onboarding/onboarding-utility-same-model.png and b/docs/res/usage/onboarding/onboarding-utility-same-model.png differdiff --git a/docs/setup/installation.md b/docs/setup/installation.mdindex 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