You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A detailed setup guide for Windows, macOS, and Linux with a video can be found in the Agent Zero Documentation at [this page](./docs/setup/installation.md).
57
-
58
56
### ⚡ Quick Start
59
57
58
+
**macOS / Linux:**
60
59
```bash
61
-
# Pull and run with Docker
60
+
curl -fsSL https://bash.agent-zero.ai | bash
61
+
```
62
62
63
-
docker pull agent0ai/agent-zero
64
-
docker run -p 50001:80 agent0ai/agent-zero
63
+
**Windows (PowerShell):**
64
+
```powershell
65
+
irm https://ps.agent-zero.ai | iex
66
+
```
65
67
66
-
# Visit http://localhost:50001 to start
68
+
**Docker:**
69
+
```bash
70
+
docker run -p 80:80 agent0ai/agent-zero
67
71
```
68
72
73
+
A detailed setup guide for Windows, macOS, and Linux can be found in the Agent Zero Documentation at [this page](./docs/setup/installation.md).
74
+
69
75
70
76
# 💡 Key Features
71
77
@@ -172,228 +178,6 @@ docker run -p 50001:80 agent0ai/agent-zero
172
178
|[Troubleshooting](./docs/guides/troubleshooting.md)| Common issues and their solutions |
173
179
174
180
175
-
## 🎯 Changelog
176
-
177
-
GitHub release notes for the latest eligible `main` tag are generated during `.github/workflows/docker-publish.yml` from commit subjects and descriptions since the previous published release, using OpenRouter and the editable prompt in `scripts/openrouter_release_notes_system_prompt.md`.
178
-
179
-
### v0.9.8 - Skills, UI Redesign & Git projects
180
-
[Release video](https://youtu.be/NV7s78yn6DY)
181
-
182
-
- Skills
183
-
- Skills System replacing the legacy Instruments with a new `SKILL.md` standard for structured, portable agent capabilities.
184
-
- Built-in skills, and UI support for importing and listing skills
185
-
- Real-time WebSocket infrastructure replacing the polling-based approach for UI state synchronization
186
-
- UI Redesign
187
-
- Process groups to visually group agent actions with expand/collapse support
188
-
- Timestamps, steps count and execution time with tool-specific badges
189
-
- Step detail modals with key-value and raw JSON display
190
-
- Collapsible responses with show more/less and copy buttons on code blocks and tables
191
-
- Message queue system allowing users to queue messages while the agent is still processing
192
-
- In-browser file editor for viewing and editing files without leaving the UI
193
-
- Welcome screen redesign with info and warning banners for connection security, missing API keys, and system resources
194
-
- Scheduler redesign with standalone modal, separate task list, detail and editor components, and project support
195
-
- Smooth response rendering and scroll stabilization across chat, terminals, and image viewer
196
-
- Chat width setting and reworked preferences panel
197
-
- Image viewer improvements with scroll support and expanded viewer
198
-
- Redesigned sidebar with reusable dropdown component and streamlined buttons
199
-
- Inline button confirmations for critical actions
200
-
- Improved login design and new logout button
201
-
- File browser enhanced with rename and file actions dropdown
202
-
- Git projects
203
-
- Git-based projects with clone authentication for public and private repositories
204
-
- Four new LLM providers: CometAPI, Z.AI, Moonshot AI, and AWS Bedrock
205
-
- Microsoft Dev Tunnels integration for secure remote access
206
-
- User data migration to `/usr` directory for cleaner separation of user and system files
207
-
- Subagents system with configurable agent profiles for different roles
208
-
- Memory operations offloaded to deferred tasks for better performance
209
-
- Environment variables can now configure settings via `A0_SET_*` prefix in `.env`
210
-
- Automatic migration with overwrite support for `.env`, scheduler, knowledge, and legacy directories
211
-
- Projects support extended to MCP, A2A, and external API
212
-
- Workdir outside project support for more flexible file organization
213
-
- Agent number tracking in backend and responses for multi-agent identification
214
-
- Many bug fixes and stability improvements across the UI, MCP tools, scheduler, uploads, and WebSocket handling
215
-
216
-
217
-
### v0.9.7 - Projects
218
-
[Release video](https://youtu.be/RrTDp_v9V1c)
219
-
- Projects management
220
-
- Support for custom instructions
221
-
- Integration with memory, knowledge, files
222
-
- Project specific secrets
223
-
- New Welcome screen/Dashboard
224
-
- New Wait tool
225
-
- Subordinate agent configuration override support
226
-
- Support for multiple documents at once in document_query_tool
227
-
- Improved context on interventions
228
-
- Openrouter embedding support
229
-
- Frontend components refactor and polishing
230
-
- SSH metadata output fix
231
-
- Support for windows powershell in local TTY utility
## **Goal:** Go from zero to a first working chat with minimal setup.
9
+
The install script is the fastest way to get Agent Zero running. It handles Docker, image pulling, and container setup automatically.
10
+
11
+
**macOS / Linux:**
12
+
```bash
13
+
curl -fsSL https://bash.agent-zero.ai | bash
14
+
```
15
+
16
+
**Windows (PowerShell):**
17
+
```powershell
18
+
irm https://ps.agent-zero.ai | iex
19
+
```
20
+
21
+
**Docker (run directly):**
22
+
```bash
23
+
docker run -p 80:80 agent0ai/agent-zero
24
+
```
25
+
26
+
Once the install completes, open the URL shown in your terminal to access the Web UI and proceed to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
27
+
28
+
---
29
+
30
+
## Manual Docker Setup
8
31
32
+
If you prefer to set things up manually, follow the steps below.
9
33
10
-
## Step 1: Install Docker Desktop
34
+
###Step 1: Install Docker Desktop
11
35
12
36
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
37
@@ -39,7 +63,7 @@ Docker Desktop provides the runtime environment for Agent Zero, ensuring consist
39
63
---
40
64
41
65
<aname="windows-installation"></a>
42
-
## <imgsrc="../res/setup/oses/windows.png"width="30"alt="Windows"/> Windows Installation
66
+
####<imgsrc="../res/setup/oses/windows.png"width="30"alt="Windows"/> Windows Installation
43
67
44
68
**1.1. Download Docker Desktop**
45
69
@@ -64,12 +88,12 @@ Once installed, launch Docker Desktop from your Start menu or desktop shortcut.
64
88
65
89
✅ **Docker is now installed!**
66
90
67
-
### Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
91
+
Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
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:
0 commit comments