update installation guide and quickstart
Alessandro committed
Feb 10, 2026 at 14:25 UTC
4839ec3b45e7573c291bd16adb0d838631df9b88
12 files changed
+287
-192
docs/getting-started/installation.md
+215
-166
@@ -4,120 +4,145 @@ Click to open a video to learn how to install Agent Zero:
4
5
[](https://www.youtube.com/watch?v=w5v5Kjx51hs)
6
7
-This user guide provides instructions for installing and running Agent Zero using Docker, which is the primary runtime environment for the framework. For developers and contributors, we also provide instructions for setting up the [full development environment](../development/setup.md).
7
+## **Goal:** Go from zero to a first working chat with minimal setup.
8
9
-## Quick Start Guide
9
11
-**Goal:** Go from zero to a first working chat with minimal setup.
10
+## Step 1: Install Docker Desktop
11
+
12
+Docker Desktop provides the runtime environment for Agent Zero, ensuring consistent behavior and security across platforms. The entire framework runs within a Docker container, providing isolation and easy deployment.
13
+
14
+**Choose your operating system:**
15
+
16
+<table>
17
+<tr>
18
+<td align="center" width="33%">
19
+<a href="#windows-installation">
20
+<img src="../res/setup/oses/windows.png" width="80" alt="Windows"/><br/>
21
+<b>Windows</b>
22
+</a>
23
+</td>
24
+<td align="center" width="33%">
25
+<a href="#macos-installation">
26
+<img src="../res/setup/oses/apple.png" width="80" alt="macOS"/><br/>
27
+<b>macOS</b>
28
+</a>
29
+</td>
30
+<td align="center" width="33%">
31
+<a href="#linux-installation">
32
+<img src="../res/setup/oses/linux.png" width="80" alt="Linux"/><br/>
33
+<b>Linux</b>
34
+</a>
35
+</td>
36
+</tr>
37
+</table>
38
39
---
40
15
-## Step 1: Install Docker Desktop
41
+## <img src="../res/setup/oses/windows.png" width="30" alt="Windows"/> Windows Installation
42
17
-Docker Desktop provides the runtime environment for Agent Zero, ensuring consistent behavior and security across platforms. The entire framework runs within a Docker container, providing isolation and easy deployment.
43
+**1.1. Download Docker Desktop**
44
+
45
+Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the Windows version (Intel/AMD is the main download button).
46
+
47
+<img src="../res/setup/image-8.png" alt="docker download" width="200"/>
48
+<br><br>
49
+
50
+**1.2. Run the Installer**
51
+
52
+Run the installer with default settings.
53
+
54
+<img src="../res/setup/image-9.png" alt="docker install" width="300"/>
55
+<img src="../res/setup/image-10.png" alt="docker install" width="300"/>
56
+<br><br>
57
+
58
+**1.3. Launch Docker Desktop**
59
+
60
+Once installed, launch Docker Desktop from your Start menu or desktop shortcut.
61
+
62
+<img src="../res/setup/image-11.png" alt="docker installed" height="100"/>
63
19
-### Choose Your Operating System
20
-
21
-=== "Windows"
22
-
23
- **1.1. Download Docker Desktop**
24
-
25
- Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the Windows version (Intel/AMD is the main download button).
26
-
27
- <img src="../res/setup/image-8.png" alt="docker download" width="200"/>
28
- <br><br>
29
-
30
- **1.2. Run the Installer**
31
-
32
- Run the installer with default settings.
33
-
34
- <img src="../res/setup/image-9.png" alt="docker install" width="300"/>
35
- <img src="../res/setup/image-10.png" alt="docker install" width="300"/>
36
- <img src="../res/setup/image-12.png" alt="docker install" width="300"/>
37
- <br><br>
38
-
39
- **1.3. Launch Docker Desktop**
40
-
41
- Once installed, launch Docker Desktop from your Start menu or desktop shortcut.
42
-
43
- <img src="../res/setup/image-11.png" alt="docker installed" height="100"/>
44
- <img src="../res/setup/image-13.png" alt="docker installed" height="100"/>
45
- <br><br>
46
-
47
-=== "macOS"
48
-
49
- **1.1. Download Docker Desktop**
50
-
51
- Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the macOS version (choose Apple Silicon or Intel based on your Mac).
52
-
53
- <img src="../res/setup/image-8.png" alt="docker download" width="200"/>
54
- <br><br>
55
-
56
- **1.2. Install Docker Desktop**
57
-
58
- Drag and drop the Docker application to your Applications folder.
59
-
60
- <img src="../res/setup/image-9.png" alt="docker install" width="300"/>
61
- <img src="../res/setup/image-10.png" alt="docker install" width="300"/>
62
- <img src="../res/setup/image-12.png" alt="docker install" width="300"/>
63
- <br><br>
64
-
65
- **1.3. Launch Docker Desktop**
66
-
67
- Open Docker Desktop from your Applications folder.
68
-
69
- <img src="../res/setup/image-11.png" alt="docker installed" height="100"/>
70
- <img src="../res/setup/image-13.png" alt="docker installed" height="100"/>
71
- <br><br>
72
-
73
- **1.4. Configure Docker Socket**
74
-
75
- > [!NOTE]
76
- > **Important macOS Configuration:** In Docker Desktop's preferences (Docker menu) → Settings → Advanced, enable "Allow the default Docker socket to be used (requires password)."
77
-
78
- 
79
-
80
-=== "Linux"
81
-
82
- **1.1. Choose Installation Method**
83
-
84
- You can install either Docker Desktop or docker-ce (Community Edition).
85
-
86
- **Option A: Docker Desktop (Recommended for beginners)**
87
-
88
- Follow the instructions for your specific Linux distribution [here](https://docs.docker.com/desktop/install/linux-install/).
89
-
90
- **Option B: docker-ce (Lightweight alternative)**
91
-
92
- Follow the installation instructions [here](https://docs.docker.com/engine/install/).
93
-
94
- **1.2. Post-Installation Steps (docker-ce only)**
95
-
96
- If you installed docker-ce, add your user to the `docker` group:
97
-
98
- ```bash
99
- sudo usermod -aG docker $USER
100
- ```
101
-
102
- Log out and back in, then authenticate:
103
-
104
- ```bash
105
- docker login
106
- ```
107
-
108
- **1.3. Launch Docker**
109
-
110
- If you installed Docker Desktop, launch it from your applications menu.
111
-
112
- <img src="../res/setup/image-11.png" alt="docker installed" height="100"/>
113
- <img src="../res/setup/image-13.png" alt="docker installed" height="100"/>
64
+✅ **Docker is now installed!**
65
+
66
+### Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
67
68
---
69
117
-## Step 2: Run Agent Zero
70
+## <img src="../res/setup/oses/apple.png" width="30" alt="macOS"/> macOS Installation
71
+
72
+**1.1. Download Docker Desktop**
73
+
74
+Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the macOS version (choose Apple Silicon or Intel based on your Mac).
75
+
76
+<img src="../res/setup/image-8.png" alt="docker download" width="200"/>
77
+<br><br>
78
+
79
+**1.2. Install Docker Desktop**
80
+
81
+Drag and drop the Docker application to your Applications folder.
82
+
83
+<img src="../res/setup/image-12.png" alt="docker install" width="300"/>
84
+<br><br>
85
+
86
+**1.3. Launch Docker Desktop**
87
+
88
+Open Docker Desktop from your Applications folder.
89
+
90
+<img src="../res/setup/image-13.png" alt="docker installed" height="100"/>
91
+<br><br>
92
+
93
+**1.4. Configure Docker Socket**
94
95
> [!NOTE]
120
-> The Hacker profile is included in the main image. After launch, choose the **hacker** agent profile in Settings if you want the security-focused prompts and tooling.
96
+> **Important macOS Configuration:** In Docker Desktop's preferences (Docker menu) → Settings → Advanced, enable "Allow the default Docker socket to be used (requires password)."
97
+
98
+
99
+
100
+✅ **Docker is now installed!**
101
+
102
+### Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
103
+
104
+---
105
+
106
+## <img src="../res/setup/oses/linux.png" width="30" alt="Linux"/> Linux Installation
107
+
108
+**1.1. Choose Installation Method**
109
+
110
+You can install either Docker Desktop or docker-ce (Community Edition).
111
+
112
+**Option A: Docker Desktop (Recommended for beginners)**
113
+
114
+Follow the instructions for your specific Linux distribution [here](https://docs.docker.com/desktop/install/linux-install/).
115
+
116
+**Option B: docker-ce (Lightweight alternative)**
117
+
118
+Follow the installation instructions [here](https://docs.docker.com/engine/install/).
119
+
120
+**1.2. Post-Installation Steps (docker-ce only)**
121
+
122
+If you installed docker-ce, add your user to the `docker` group:
123
+
124
+```bash
125
+sudo usermod -aG docker $USER
126
+```
127
+
128
+Log out and back in, then authenticate:
129
+
130
+```bash
131
+docker login
132
+```
133
+
134
+**1.3. Launch Docker**
135
+
136
+If you installed Docker Desktop, launch it from your applications menu.
137
+
138
+✅ **Docker is now installed!**
139
+
140
+> [!TIP]
141
+> **Deploying on a VPS/Server?** For production deployments with reverse proxy, SSL, and domain configuration, see the [VPS Deployment Guide](vps-deployment.md).
142
+
143
+---
144
+
145
+## Step 2: Run Agent Zero
146
147
### 2.1. Pull the Agent Zero Docker Image
148
@@ -137,7 +162,11 @@ docker pull agent0ai/agent-zero
162
163
### 2.2. (Optional) Map Folders for Persistence
164
140
-Choose or create a directory on your machine where you want to store Agent Zero's data. This can be any location you prefer:
165
+Choose or create a folder on your computer where Agent Zero will save its data.
166
+
167
+### Setting up persistence is needed only if you want your data and files to remain available even after you delete the container.
168
+
169
+You can pick any location you find convenient:
170
171
- **Windows:** `C:\agent-zero-data`
172
- **macOS/Linux:** `/home/user/agent-zero-data`
@@ -167,15 +196,6 @@ The container will start and show in the "Containers" tab:
196
197
198
170
-**Using Terminal:**
171
-
172
-```bash
173
-docker run -p 0:80 -v /path/to/your/work_dir:/a0/work_dir agent0ai/agent-zero
174
-```
175
-
176
-- Replace `0` with a fixed port if you prefer (e.g., `50080:80`)
177
-- Map only the folders you need (e.g., `/a0/work_dir`, `/a0/usr/projects`), not the entire `/a0` directory
178
-
199
### 2.4. Access the Web UI
200
201
The framework will take a few seconds to initialize. Find the mapped port in Docker Desktop (shown as `<PORT>:80`) or click the port right under the container ID:
@@ -192,6 +212,14 @@ Open `http://localhost:<PORT>` in your browser. The Web UI will open - Agent Zer
212
> [!NOTE]
213
> After starting the container, you'll find all Agent Zero files in your chosen directory. You can access and edit these files directly on your machine, and the changes will be immediately reflected in the running container.
214
215
+**Running A0 using Terminal?**
216
+
217
+```bash
218
+docker run -p 0:80 -v /path/to/your/work_dir:/a0/usr agent0ai/agent-zero
219
+```
220
+
221
+- Replace `0` with a fixed port if you prefer (e.g., `50080:80`)
222
+
223
---
224
225
## Step 3: Configure Agent Zero
@@ -209,7 +237,10 @@ Agent Zero provides a comprehensive settings interface to customize various aspe
237
- **Knowledge Subdirectory:** Specify the location of custom knowledge files to enhance the agent's understanding.
238
239
> [!NOTE]
212
-> Since v0.9.7, custom prompts belong in `/a0/agents/<agent_name>/prompts/` rather than a shared `/prompts` folder. See the [Extensibility guide](../development/extensibility.md#prompts) for details.
240
+> Since v0.9.8, custom prompts belong in `/a0/usr/agents/<agent_name>/prompts/` rather than a shared `/prompts` folder. See the [Extensibility guide](../development/extensibility.md#prompts) for details.
241
+
242
+> [!NOTE]
243
+> The Hacker profile is included in the main image. After launch, choose the **hacker** agent profile in Settings if you want the security-focused prompts and tooling. The "hacker" branch is deprecated.
244
245
246
@@ -298,12 +329,13 @@ The Settings page is the control center for selecting the Large Language Models
329
| --- | --- |
330
| `chat_llm` | This is the primary LLM used for conversations and generating responses. |
331
| `utility_llm` | This LLM handles internal tasks like summarizing messages, managing memory, and processing internal prompts. Using a smaller, less expensive model here can improve efficiency. |
301
-| `embedding_llm` | This LLM is responsible for generating embeddings used for memory retrieval and knowledge base lookups. Changing the `embedding_llm` will re-index all of A0's memory. |
332
+| `browser_llm` | This LLM powers the browser agent for web navigation and interaction tasks. Vision support is recommended for better page understanding. |
333
+| `embedding_llm` | The embedding model shipped with A0 runs on CPU and is responsible for generating embeddings used for memory retrieval and knowledge base lookups. Changing the `embedding_llm` will re-index all of A0's memory. |
334
335
**How to Change:**
336
337
1. Open Settings page in the Web UI.
306
-2. Choose the provider for the LLM for each role (Chat model, Utility model, Embedding model) and write the model name.
338
+2. Choose the provider for the LLM for each role (Chat model, Utility model, Browser model, Embedding model) and write the model name.
339
3. Click "Save" to apply the changes.
340
341
### Important Considerations
@@ -314,17 +346,12 @@ Use the naming format required by your selected provider:
346
347
| Provider | Model Name Format | Example |
348
| --- | --- | --- |
317
-| OpenAI | Model name only | `gpt-4.1` |
318
-| OpenRouter | Provider prefix required | `openai/gpt-4.1` |
319
-| Venice AI | Model name with optional parameters | `qwen3-235b:disable_thinking=true` |
320
-| Ollama | Model name only | `llama3.2` |
321
-
322
-> [!IMPORTANT]
323
-> Remove `openai/` when using the native OpenAI provider. That prefix is only for OpenRouter.
349
+| OpenAI | Model name only | `claude-sonnet-4-5` |
350
+| OpenRouter | Provider prefix mostly required | `anthropic/claude-sonnet-4-5` |
351
+| Ollama | Model name only | `gpt-oss:20b` |
352
353
> [!TIP]
326
-> Venice model parameters can be appended directly to the model name, for example:
327
-> `qwen3-235b:disable_thinking=true&include_venice_system_prompt=false`
354
+> If you see "Invalid model ID," verify the provider and naming format on the provider website, or search the web for "<name-of-ai-model> model naming".
355
356
#### Context Window & Memory Split
357
@@ -335,7 +362,7 @@ Use the naming format required by your selected provider:
362
#### Utility Model Guidance
363
364
- Utility models handle summarization and memory extraction.
338
-- Very small models (≈4B) usually fail at reliable memory extraction.
365
+- Very small models (≈4B) usually fail at reliable context extraction.
366
- Aim for ~70B class models or strong cloud "flash/mini" models for better results.
367
368
#### Reasoning/Thinking Models
@@ -349,33 +376,45 @@ Use the naming format required by your selected provider:
376
377
Ollama is a powerful tool that allows you to run various large language models locally.
378
352
-### Installation
379
+---
380
+
381
+### <img src="../res/setup/oses/windows.png" width="30" alt="Windows"/> Windows Ollama Installation
382
354
-=== "Windows"
383
+Download and install Ollama from the official website:
384
356
- Download and install Ollama from the official website:
357
-
358
- <button>[Download Ollama Setup](https://ollama.com/download/OllamaSetup.exe)</button>
385
+<button>[Download Ollama Setup](https://ollama.com/download/OllamaSetup.exe)</button>
386
360
-=== "macOS"
387
+Once installed, continue to [Pulling Models](#pulling-models).
388
362
- **Using Homebrew:**
363
-
364
- ```bash
365
- brew install ollama
366
- ```
367
-
368
- **Using Installer:**
369
-
370
- Download from the [official website](https://ollama.com/).
389
+---
390
372
-=== "Linux"
391
+### <img src="../res/setup/oses/apple.png" width="30" alt="macOS"/> macOS Ollama Installation
392
374
- Run the installation script:
375
-
376
- ```bash
377
- curl -fsSL https://ollama.com/install.sh | sh
378
- ```
393
+**Using Homebrew:**
394
+
395
+```bash
396
+brew install ollama
397
+```
398
+
399
+**Using Installer:**
400
+
401
+Download from the [official website](https://ollama.com/).
402
+
403
+Once installed, continue to [Pulling Models](#pulling-models).
404
+
405
+---
406
+
407
+### <img src="../res/setup/oses/linux.png" width="30" alt="Linux"/> Linux Ollama Installation
408
+
409
+Run the installation script:
410
+
411
+```bash
412
+curl -fsSL https://ollama.com/install.sh | sh
413
+```
414
+
415
+Once installed, continue to [Pulling Models](#pulling-models).
416
+
417
+---
418
419
### Pulling Models
420
@@ -419,35 +458,39 @@ ollama rm <model-name>
458
```
459
460
> [!TIP]
422
-> Experiment with different model combinations to find the balance of performance and cost that best suits your needs. E.g., faster and lower latency LLMs will help, and you can also use `faiss_gpu` instead of `faiss_cpu` for the memory.
461
+> Experiment with different model combinations to find the balance of performance and cost that best suits your needs. E.g., faster and lower latency LLMs will help, and you can also use `faiss_gpu` instead of `faiss_cpu` for the memory.
462
463
---
464
465
## Using Agent Zero on Your Mobile Device
466
428
-Agent Zero's Web UI is accessible from any device on your network through the Docker container:
467
+Agent Zero can be accessed from mobile devices and other computers using the built-in **Tunnel feature**.
468
430
-> [!NOTE]
431
-> In settings, External Services tab, you can enable Cloudflare Tunnel to expose your Agent Zero instance to the internet.
432
-> ⚠️ Do not forget to set username and password in the settings Authentication tab to secure your instance on the internet.
469
+### Recommended: Using Tunnel (Remote Access)
470
434
-1. The Docker container automatically exposes the Web UI on all network interfaces
435
-2. Find the mapped port in Docker Desktop:
436
- - Look under the container name (usually in the format `<PORT>:80`)
437
- - For example, if you see `32771:80`, your port is `32771`
438
-3. Access the Web UI from any device using:
439
- - Local access: `http://localhost:<PORT>`
440
- - Network access: `http://<YOUR_COMPUTER_IP>:<PORT>`
471
+The Tunnel feature allows secure access to your Agent Zero instance from anywhere:
472
442
-> [!TIP]
443
-> - Your computer's IP address is usually in the format `192.168.x.x` or `10.0.x.x`
444
-> - You can find your external IP address by running `ipconfig` (Windows) or `ifconfig` (Linux/Mac)
445
-> - The port is automatically assigned by Docker unless you specify one
473
+1. Open Settings in the Web UI
474
+2. Navigate to the **External Services** tab
475
+3. Click on **Flare Tunnel** in the navigation menu
476
+4. Click **Create Tunnel** to generate a secure HTTPS URL
477
+5. Share this URL to access Agent Zero from any device
478
447
-> [!NOTE]
448
-> If you're running Agent Zero directly on your system (legacy approach) instead of using Docker, configure the bind address/ports via flags or environment variables:
449
-> - Use `--host 0.0.0.0` (or set `WEB_UI_HOST=0.0.0.0` in `.env`) to listen on all interfaces.
450
-> - Use `--port <PORT>` (or `WEB_UI_PORT`) to pick the HTTP port.
479
+> [!IMPORTANT]
480
+> **Security:** Always set a username and password in Settings → Authentication before creating a tunnel to secure your instance on the internet.
481
+
482
+For complete details on tunnel configuration and security considerations, see the [Tunneling guide](../advanced/tunneling.md).
483
+
484
+### Alternative: Local Network Access
485
+
486
+If you prefer to keep access limited to your local network:
487
+
488
+1. Find the mapped port in Docker Desktop (format: `<PORT>:80`, e.g., `32771:80`)
489
+2. Access from the same computer: `http://localhost:<PORT>`
490
+3. Access from other devices on the network: `http://<YOUR_COMPUTER_IP>:<PORT>`
491
+
492
+> [!TIP]
493
+> Find your computer's IP address with `ipconfig` (Windows) or `ifconfig`/`ip addr` (macOS/Linux). It's usually in the format `192.168.x.x` or `10.0.x.x`.
494
495
For developers or users who need to run Agent Zero directly on their system, see the [In-Depth Guide for Full Binaries Installation](../development/setup.md).
496
@@ -537,4 +580,10 @@ docker run -p 50080:80 \
580
581
After following the instructions for your specific operating system, you should have Agent Zero successfully installed and running. You can now start exploring the framework's capabilities and experimenting with creating your own intelligent agents.
582
583
+**Next Steps:**
584
+
585
+- For production server deployments, see the [VPS Deployment Guide](vps-deployment.md)
586
+- For development setup and extensions, see the [Development Guide](../development/setup.md)
587
+- For remote access via tunnel, see the [Tunneling Guide](../advanced/tunneling.md)
588
+
589
If you encounter any issues during the installation process, please consult the [Troubleshooting section](../guides/troubleshooting.md) of this documentation or refer to the Agent Zero [Skool](https://www.skool.com/agent-zero) or [Discord](https://discord.gg/B8KZKNsPpj) community for assistance.
docs/getting-started/vps-deployment.md
+3
@@ -52,6 +52,9 @@
52
53
## Docker Installation
54
55
+> [!NOTE]
56
+> For detailed Docker installation instructions and alternative methods, see the [Linux Installation section](installation.md#linux-installation) in the main installation guide.
57
+
58
### Method A: Debian/Ubuntu Systems
59
60
```bash
docs/quickstart.md
+69
-26
@@ -1,54 +1,97 @@
1
# Quick Start
2
-This guide provides a quick introduction to using Agent Zero. We'll cover launching the Web UI, starting a new chat, and running a simple task.
2
+This guide provides a quick introduction to using Agent Zero. We'll cover the essential installation steps and running your first task.
3
4
-## Launching the Web UI (Docker)
5
-1. Pull the latest image:
4
+## Installation Steps
5
+
6
+### Step 1: Install Docker Desktop
7
+
8
+Download and install Docker Desktop for your operating system:
9
+
10
+- **Windows:** Download from [Docker Desktop](https://www.docker.com/products/docker-desktop/) and run the installer with default settings
11
+- **macOS:** Download for Apple Silicon or Intel, drag to Applications, and enable the Docker socket in Settings → Advanced
12
+- **Linux:** Install Docker Desktop or docker-ce following the [official instructions](https://docs.docker.com/desktop/install/linux-install/)
13
+
14
+> [!TIP]
15
+> For complete OS-specific installation instructions, see the [full Installation Guide](getting-started/installation.md#step-1-install-docker-desktop).
16
+
17
+### Step 2: Pull the Agent Zero Image
18
+
19
+Using Docker Desktop GUI, search for `agent0ai/agent-zero` and click Pull, or use the terminal:
20
21
```bash
8
-docker pull agent0ai/agent-zero:latest
22
+docker pull agent0ai/agent-zero
23
```
24
11
-Notes:
12
-- HTTP binds to `--host/--port` (or `WEB_UI_HOST`/`WEB_UI_PORT`, default port 5000).
25
+### Step 3: Run the Container
26
+
27
+**Using Docker Desktop:** Go to Images tab, click Run next to `agent0ai/agent-zero`, open Optional settings, map a host port to container port `80` (use `0` for automatic assignment), then click Run.
28
14
-4. A message similar to this will appear in your terminal, indicating the Web UI is running:
29
+**Using Terminal:**
30
31
```bash
17
-docker run -p 0:80 agent0ai/agent-zero:latest
32
+docker run -p 0:80 agent0ai/agent-zero
33
```
34
20
-5. Open your web browser and navigate to the URL shown in the terminal (usually `http://127.0.0.1:5000`). You should see the Agent Zero Web UI.
35
+The container will start in a few seconds. Find the mapped port in Docker Desktop (shown as `<PORT>:80`).
36
+
37
+### Step 4: Open the Web UI and Configure API Key
38
+
39
+Open your browser and navigate to `http://localhost:<PORT>`. The Web UI will show a warning banner about missing API key.
40
+
41
+
42
+
43
+Click **Add your API key** to open Settings and configure:
44
22
-
45
+- **Default Provider:** OpenRouter (supports most models with a single API key)
46
+- **Alternative Providers:** Anthropic, OpenAI, Ollama (local models), and many others
47
+- **Model Selection:** Choose your chat model (e.g., `anthropic/claude-sonnet-4-5` for OpenRouter)
48
+
49
+> [!NOTE]
50
+> Agent Zero supports any LLM provider, including local models via Ollama. For detailed provider configuration and local model setup, see the [Installation Guide](getting-started/installation.md#choosing-your-llms).
51
+
52
+### Step 5: Start Your First Chat
53
+
54
+Once configured, you'll see the Agent Zero dashboard with access to:
55
+
56
+- **Projects** - organize your work into projects
57
+- **Memory** - open the memory dashboard
58
+- **Scheduler** - create and manage planned tasks
59
+- **Files** - open the File Browser
60
+- **Settings** - configure models and preferences
61
+- **System Stats** - monitor resource usage
62
+
63
+Click **New Chat** to start creating with Agent Zero!
64
+
65
+
66
67
> [!TIP]
25
-> As you can see, the Web UI has four distinct buttons for easy chat management:
26
-> `New Chat`, `Reset Chat`, `Save Chat`, and `Load Chat`.
27
-> Chats can be saved and loaded individually in `json` format and are stored in the
28
-> `/tmp/chats` directory.
68
+> The Web UI provides a comprehensive chat actions dropdown with options for managing conversations, including creating new chats, resetting, saving/loading, and many more advanced features. Chats are saved in JSON format in the `/usr/chats` directory.
69
+>
70
+> 
71
30
- 
72
+---
73
32
-## Running a Simple Task
33
-Let's ask Agent Zero to download a YouTube video. Here's how:
74
+## Example Interaction
75
+Let's ask Agent Zero to use one of the built-in skills. Here's how:
76
35
-1. Type "Download a YouTube video for me" in the chat input field and press Enter or click the send button.
77
+1. Type "Activate your brainstorming skill" in the chat input field and press Enter or click the send button.
78
2. Agent Zero will process your request. You'll see its thoughts and tool calls in the UI.
37
-3. The agent will ask you for the URL of the YouTube video you want to download.
79
+3. The agent will acknowledge the skill activation and ask you for a follow-up on the brainstorming request.
80
39
-## Example Interaction
81
Here's an example of what you might see in the Web UI at step 3:
82
42
-
83
+
84
85
## Next Steps
86
Now that you've run a simple task, you can experiment with more complex requests. Try asking Agent Zero to:
87
47
-* Perform calculations
48
-* Search the web for information
88
+* Connect to your email
89
* Execute shell commands
90
+* Develop skills
91
* Explore web development tasks
51
-* Create or modify files
92
+* Develop A0 itself
93
+
94
+### [Open Usage Guide](usage.md)
95
+
96
+Provides more in-depth information on tools, projects, tasks, and backup/restore.
97
53
-> [!TIP]
54
-> The [Usage Guide](usage.md) provides more in-depth information on tools, projects, tasks, and backup/restore.
docs/res/image-24.png
Binary files a/docs/res/image-24.png and /dev/null differ
docs/res/quickstart/image-24.png
Binary files /dev/null and b/docs/res/quickstart/image-24.png differ
docs/res/quickstart/ui_chat_management.png
Binary files /dev/null and b/docs/res/quickstart/ui_chat_management.png differ
docs/res/quickstart/ui_newchat1.png
Binary files /dev/null and b/docs/res/quickstart/ui_newchat1.png differ
docs/res/setup/oses/apple.png
Binary files /dev/null and b/docs/res/setup/oses/apple.png differ
docs/res/setup/oses/linux.png
Binary files /dev/null and b/docs/res/setup/oses/linux.png differ
docs/res/setup/oses/windows.png
Binary files /dev/null and b/docs/res/setup/oses/windows.png differ
docs/res/ui_chat_management.png
Binary files a/docs/res/ui_chat_management.png and /dev/null differ
docs/res/ui_newchat1.png
Binary files a/docs/res/ui_newchat1.png and /dev/null differ