repository namespaces update
frdel committed
Jul 18, 2025 at 10:52 UTC
dbe6b0fe7d11430d2d87e39ee6ca41291432ea5b
15 files changed
+123
-365
LICENSE
+3
-3
@@ -1,8 +1,8 @@
1
MIT License
2
3
-Copyright (c) 2024 Jan Tomášek
4
-Contact: tomasekhonza@gmail.com
5
-Repository: https://github.com/frdel/agent-zero
3
+Copyright (c) 2025 Agent Zero, s.r.o
4
+Contact: pr@agent-zero.ai
5
+Repository: https://github.com/agent0ai/agent-zero
6
7
Permission is hereby granted, free of charge, to any person obtaining a copy
8
of this software and associated documentation files (the "Software"), to deal
README.md
+4
-8
@@ -3,7 +3,7 @@
3
# `Agent Zero`
4
5
6
-[](https://agent-zero.ai) [](https://github.com/sponsors/frdel) [](https://x.com/Agent0ai) [](https://discord.gg/B8KZKNsPpj) [](https://www.youtube.com/@AgentZeroFW) [](https://www.linkedin.com/in/jan-tomasek/) [](https://warpcast.com/agent-zero)
6
+[](https://agent-zero.ai) [](https://github.com/sponsors/agent0ai) [](https://x.com/Agent0ai) [](https://discord.gg/B8KZKNsPpj) [](https://www.youtube.com/@AgentZeroFW) [](https://www.linkedin.com/in/jan-tomasek/) [](https://warpcast.com/agent-zero)
7
8
[Introduction](#a-personal-organic-agentic-framework-that-grows-and-learns-with-you) •
9
[Installation](./docs/installation.md) •
@@ -93,10 +93,6 @@
93
94
- **Research** - `"Gather and summarize five recent AI papers about CoT prompting"`
95
96
-# Hacking Edition
97
-- Agent Zero also offers a Hacking Edition based on Kali linux with modified prompts for cybersecurity tasks
98
-- The setup is the same as the regular version, just use the frdel/agent-zero-run:hacking image instead of frdel/agent-zero-run
99
-> **Note:** The Hacking Edition and all its prompts and features will be merged into the main branch in the following release.
96
97
98
# ⚙️ Installation
@@ -112,8 +108,8 @@ A detailed setup guide for Windows, macOS, and Linux with a video can be found i
108
```bash
109
# Pull and run with Docker
110
115
-docker pull frdel/agent-zero-run
116
-docker run -p 50001:80 frdel/agent-zero-run
111
+docker pull agent0ai/agent-zero
112
+docker run -p 50001:80 agent0ai/agent-zero
113
114
# Visit http://localhost:50001 to start
115
```
@@ -265,4 +261,4 @@ Default models set to gpt-4.1
261
262
- [Join our Discord](https://discord.gg/B8KZKNsPpj) for live discussions or [visit our Skool Community](https://www.skool.com/agent-zero).
263
- [Follow our YouTube channel](https://www.youtube.com/@AgentZeroFW) for hands-on explanations and tutorials
268
-- [Report Issues](https://github.com/frdel/agent-zero/issues) for bug fixes and features
264
+- [Report Issues](https://github.com/agent0ai/agent-zero/issues) for bug fixes and features
agent.py
+1
-1
@@ -215,7 +215,7 @@ class AgentConfig:
215
knowledge_subdirs: list[str] = field(default_factory=lambda: ["default", "custom"])
216
code_exec_docker_enabled: bool = False
217
code_exec_docker_name: str = "A0-dev"
218
- code_exec_docker_image: str = "frdel/agent-zero-run:development"
218
+ code_exec_docker_image: str = "agent0ai/agent-zero-run:development"
219
code_exec_docker_ports: dict[str, int] = field(
220
default_factory=lambda: {"22/tcp": 55022, "80/tcp": 55080}
221
)
docker/base/build.txt
+2
-2
@@ -9,10 +9,10 @@ docker build -t agent-zero-base:local --no-cache .
9
docker login
10
11
# with cache
12
-docker buildx build -t frdel/agent-zero-base:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
12
+docker buildx build -t agent0ai/agent-zero-base:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
13
14
# without cache
15
-docker buildx build -t frdel/agent-zero-base:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) --no-cache .
15
+docker buildx build -t agent0ai/agent-zero-base:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) --no-cache .
16
17
# plain output
18
--progress=plain
\ No newline at end of file
docker/run/Dockerfile
+1
-1
@@ -1,6 +1,6 @@
1
# Use the pre-built base image for A0
2
# FROM agent-zero-base:local
3
-FROM frdel/agent-zero-base:latest
3
+FROM agent0ai/agent-zero-base:latest
4
5
# Check if the argument is provided, else throw an error
6
ARG BRANCH
docker/run/build.txt
+6
-7
@@ -1,24 +1,23 @@
1
# local image with smart cache
2
-docker build -t agent-zero-run:local --build-arg BRANCH=development --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
2
+docker build -t agent-zero:local --build-arg BRANCH=development --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
3
4
# local image without cache
5
-docker build -t agent-zero-run:local --build-arg BRANCH=development --no-cache .
5
+docker build -t agent-zero:local --build-arg BRANCH=development --no-cache .
6
+
7
7
-# local image from Kali
8
-docker build -f ./DockerfileKali -t agent-zero-run:hacking --build-arg BRANCH=main --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
8
9
# dockerhub push:
10
11
docker login
12
13
# development:
15
-docker buildx build --build-arg BRANCH=development -t frdel/agent-zero-run:development --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
14
+docker buildx build --build-arg BRANCH=development -t agent0ai/agent-zero:development --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
15
16
# testing:
18
-docker buildx build --build-arg BRANCH=testing -t frdel/agent-zero-run:testing --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
17
+docker buildx build --build-arg BRANCH=testing -t agent0ai/agent-zero:testing --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
18
19
# main
21
-docker buildx build --build-arg BRANCH=main -t frdel/agent-zero-run:vx.x.x -t frdel/agent-zero-run:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
20
+docker buildx build --build-arg BRANCH=main -t agent0ai/agent-zero:vx.x.x -t agent0ai/agent-zero:latest --platform linux/amd64,linux/arm64 --push --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .
21
22
23
# plain output
docker/run/docker-compose.yml
+1
-1
@@ -1,7 +1,7 @@
1
services:
2
agent-zero:
3
container_name: agent-zero
4
- image: frdel/agent-zero:latest
4
+ image: agent0ai/agent-zero:latest
5
volumes:
6
- ./agent-zero:/a0
7
ports:
docker/run/fs/ins/install_A0.sh
+1
-1
@@ -11,7 +11,7 @@ if [ -z "$1" ]; then
11
fi
12
BRANCH="$1"
13
14
-git clone -b "$BRANCH" "https://github.com/frdel/agent-zero" "/git/agent-zero" || {
14
+git clone -b "$BRANCH" "https://github.com/agent0ai/agent-zero" "/git/agent-zero" || {
15
echo "CRITICAL ERROR: Failed to clone repository. Branch: $BRANCH"
16
exit 1
17
}
docs/README.md
+2
-2
@@ -12,8 +12,8 @@ To begin with Agent Zero, follow the links below for detailed guides on various
12
13
- **Download Agent Zero:** Follow the [installation guide](installation.md) to download and run Agent Zero.
14
- **Join the Community:** Join the Agent Zero [Skool](https://www.skool.com/agent-zero) or [Discord](https://discord.gg/Z2tun2N3) community to discuss ideas, ask questions, and collaborate with other contributors.
15
-- **Share your Work:** Share your Agent Zero creations, workflows and discoverings on our [Show and Tell](https://github.com/frdel/agent-zero/discussions/categories/show-and-tell) area on GitHub.
16
-- **Report Issues:** Use the [GitHub issue tracker](https://github.com/frdel/agent-zero/issues) to report framework-relative bugs or suggest new features.
15
+- **Share your Work:** Share your Agent Zero creations, workflows and discoverings on our [Show and Tell](https://github.com/agent0ai/agent-zero/discussions/categories/show-and-tell) area on GitHub.
16
+- **Report Issues:** Use the [GitHub issue tracker](https://github.com/agent0ai/agent-zero/issues) to report framework-relative bugs or suggest new features.
17
18
## Table of Contents
19
docs/cuda_docker_setup.md
deleted
-104
@@ -1,104 +0,0 @@
1
-# Agent Zero: CUDA GPU Support 🚀
2
-
3
-This guide explains how to build and run Agent Zero with NVIDIA GPU acceleration using CUDA. Running with CUDA enables faster performance for AI workloads by leveraging your GPU.
4
-
5
----
6
-
7
-## Prerequisites
8
-
9
-Before you begin, ensure you have:
10
-
11
-1. **NVIDIA GPU** with CUDA capability
12
-2. **NVIDIA Driver** installed on your host system
13
-3. **NVIDIA Container Toolkit** ([Install Guide](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html))
14
- _This enables Docker to access your GPU_
15
-4. **Docker** and **Docker Compose** installed
16
-
17
----
18
-
19
-## 1. Build the CUDA Docker Image
20
-
21
-Open a terminal in this directory and run:
22
-
23
-```bash
24
-# Set the branch you want to build from (default: main)
25
-$branch="main"
26
-docker build --no-cache -t frdel/agent-zero-run-cuda:testing --build-arg BRANCH=$branch -f Dockerfile.cuda .
27
-```
28
-
29
----
30
-
31
-## 2. Run Agent Zero with CUDA Support
32
-
33
-You can start Agent Zero with GPU support using Docker Compose:
34
-
35
-```bash
36
-# On Linux, macOS, or Windows PowerShell:
37
-docker-compose -f docker-compose.cuda.yml up -d
38
-```
39
-
40
-- This will launch Agent Zero in the background with GPU acceleration enabled.
41
-
42
----
43
-
44
-## 3. Access Agent Zero
45
-
46
-Once the container is running, open your browser and go to:
47
-
48
-[http://localhost:50080](http://localhost:50080)
49
-
50
----
51
-
52
-## 4. Stopping Agent Zero
53
-
54
-To stop the CUDA-enabled Agent Zero container:
55
-
56
-```bash
57
-docker-compose -f docker-compose.cuda.yml down
58
-```
59
-
60
----
61
-
62
-## 5. Switching Between CPU and GPU Versions
63
-
64
-You can easily switch between the CPU and GPU versions:
65
-
66
-1. **Stop the currently running version:**
67
- ```bash
68
- # For CPU version:
69
- docker-compose down
70
- # For GPU version:
71
- docker-compose -f docker-compose.cuda.yml down
72
- ```
73
-
74
-2. **Start the version you want:**
75
- ```bash
76
- # CPU version:
77
- docker-compose -f docker-compose.yml up -d
78
-
79
- # GPU (CUDA) version:
80
- docker-compose -f docker-compose.cuda.yml up -d
81
- ```
82
-
83
----
84
-
85
-## Troubleshooting & Tips
86
-
87
-- **First time setup may take several minutes** as dependencies are downloaded and installed.
88
-- If you encounter issues with GPU access, verify your NVIDIA drivers and the NVIDIA Container Toolkit are correctly installed.
89
-- To check if CUDA is available inside the container, you can run:
90
- ```bash
91
- docker exec -it <container_name> python3 -c "import torch; print(torch.cuda.is_available())"
92
- ```
93
-- For advanced configuration, see the comments in [`Dockerfile.cuda`](mdc:docker/run/Dockerfile.cuda).
94
-
95
----
96
-
97
-## More Information
98
-
99
-- [NVIDIA Container Toolkit Documentation](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html)
100
-- [Agent Zero Project](https://github.com/frdel/agent-zero) (replace with your actual repo link if different)
101
-
102
----
103
-
104
-**Enjoy accelerated AI with Agent Zero and CUDA!**
docs/installation.md
+11
-11
@@ -58,10 +58,10 @@ The following user guide provides instructions for installing and running Agent
58
59
2. **Run Agent Zero:**
60
61
-- Note: Agent Zero also offers a Hacking Edition based on Kali linux with modified prompts for cybersecurity tasks. The setup is the same as the regular version, just use the frdel/agent-zero-run:hacking image instead of frdel/agent-zero-run.
61
+- Note: Agent Zero also offers a Hacking Edition based on Kali linux with modified prompts for cybersecurity tasks. The setup is the same as the regular version, just use the agent0ai/agent-zero:hacking image instead of agent0ai/agent-zero.
62
63
2.1. Pull the Agent Zero Docker image:
64
-- Search for `frdel/agent-zero-run` in Docker Desktop
64
+- Search for `agent0ai/agent-zero` in Docker Desktop
65
- Click the `Pull` button
66
- The image will be downloaded to your machine in a few minutes
67
@@ -71,7 +71,7 @@ The following user guide provides instructions for installing and running Agent
71
> Alternatively, run the following command in your terminal:
72
>
73
> ```bash
74
-> docker pull frdel/agent-zero-run
74
+> docker pull agent0ai/agent-zero
75
> ```
76
77
2.2. Create a data directory for persistence:
@@ -92,7 +92,7 @@ The following user guide provides instructions for installing and running Agent
92
93
2.3. Run the container:
94
- In Docker Desktop, go back to the "Images" tab
95
-- Click the `Run` button next to the `frdel/agent-zero-run` image
95
+- Click the `Run` button next to the `agent0ai/agent-zero` image
96
- Open the "Optional settings" menu
97
- Set the port to `0` in the second "Host port" field (for automatic port assignment)
98
@@ -111,7 +111,7 @@ Optionally you can map local folders for file persistence:
111
> [!TIP]
112
> Alternatively, run the following command in your terminal:
113
> ```bash
114
-> docker run -p $PORT:80 -v /path/to/your/data:/a0 frdel/agent-zero-run
114
+> docker run -p $PORT:80 -v /path/to/your/data:/a0 agent0ai/agent-zero
115
> ```
116
> - Replace `$PORT` with the port you want to use (e.g., `50080`)
117
> - Replace `/path/to/your/data` with your chosen directory path
@@ -315,7 +315,7 @@ For developers or users who need to run Agent Zero directly on their system,see
315
2. **Update Process (Docker Desktop)**
316
- Go to Docker Desktop and stop the container from the "Containers" tab
317
- Right-click and select "Remove" to remove the container
318
-- Go to "Images" tab and remove the `frdel/agent-zero-run` image or click the three dots to pull the difference and update the Docker image.
318
+- Go to "Images" tab and remove the `agent0ai/agent-zero` image or click the three dots to pull the difference and update the Docker image.
319
320
321
@@ -338,13 +338,13 @@ For developers or users who need to run Agent Zero directly on their system,see
338
> docker rm agent-zero
339
>
340
> # Remove the old image
341
-> docker rmi frdel/agent-zero-run
341
+> docker rmi agent0ai/agent-zero
342
>
343
> # Pull the latest image
344
-> docker pull frdel/agent-zero-run
344
+> docker pull agent0ai/agent-zero
345
>
346
> # Run new container with the same volume mount
347
-> docker run -p $PORT:80 -v /path/to/your/data:/a0 frdel/agent-zero-run
347
+> docker run -p $PORT:80 -v /path/to/your/data:/a0 agent0ai/agent-zero
348
> ```
349
350
3. **Full Binaries**
@@ -403,9 +403,9 @@ For developers or users who need to run Agent Zero directly on their system,see
403
404
405
## 2. Download Agent Zero
406
-- You can clone the Agent Zero repository (https://github.com/frdel/agent-zero) from GitHub if you know how to use Git. In this tutorial I will just show how to download the files.
406
+- You can clone the Agent Zero repository (https://github.com/agent0ai/agent-zero) from GitHub if you know how to use Git. In this tutorial I will just show how to download the files.
407
408
-1. Go to the Agent Zero releases [here](https://github.com/frdel/agent-zero/releases).
408
+1. Go to the Agent Zero releases [here](https://github.com/agent0ai/agent-zero/releases).
409
2. The latest release is on the top of the list, click the "Source Code (zip)" button under "Assets" to download it.
410
411
<img src="res/setup/image-14-u.png" alt="agent zero download" width="500"/>
initialize.py
+1
-1
@@ -81,7 +81,7 @@ def initialize_agent():
81
mcp_servers=current_settings["mcp_servers"],
82
code_exec_docker_enabled=False,
83
# code_exec_docker_name = "A0-dev",
84
- # code_exec_docker_image = "frdel/agent-zero-run:development",
84
+ # code_exec_docker_image = "agent0ai/agent-zero:development",
85
# code_exec_docker_ports = { "22/tcp": 55022, "80/tcp": 55080 }
86
# code_exec_docker_volumes = {
87
# files.get_base_dir(): {"bind": "/a0", "mode": "rw"},
knowledge/default/main/about/github_readme.md
+65
-184
@@ -1,184 +1,65 @@
1
-<div align="center">
2
-
3
-
4
-
5
-### A dynamic, organic, and fully transparent open-source AI framework.
6
-
7
-[Installation](./docs/installation.md) •
8
-[How to update](./docs/installation.md#how-to-update-agent-zero) •
9
-[Documentation](./docs/README.md) •
10
-[Usage](./docs/usage.md)
11
-
12
-[](https://www.skool.com/agent-zero) [](https://discord.gg/B8KZKNsPpj) [](https://www.youtube.com/@AgentZeroFW) [](https://www.linkedin.com/in/jan-tomasek/) [](https://x.com/JanTomasekDev)
13
-
14
-</div>
15
-
16
-https://github.com/user-attachments/assets/c168759d-57d8-4b43-b62a-1026afcf52e6
17
-
18
-## A personal agentic framework that grows and learns with you
19
-
20
-- Agent Zero is not a predefined agentic framework. It is designed to be dynamic, organically growing, and learning as you use it.
21
-- Agent Zero is fully transparent, readable, comprehensible, customizable, and interactive.
22
-- Agent Zero uses the computer as a tool to accomplish its (your) tasks.
23
-
24
-# 💡 Key Features
25
-
26
-1. **General-purpose Assistant**
27
-
28
-- Agent Zero is not pre-programmed for specific tasks (but can be). It is meant to be a general-purpose personal assistant. Give it a task, and it will gather information, execute commands and code, cooperate with other agent instances, and do its best to accomplish it.
29
-- It has a persistent memory, allowing it to memorize previous solutions, code, facts, instructions, etc., to solve tasks faster and more reliably in the future.
30
-
31
-
32
-
33
-2. **Computer as a Tool**
34
-
35
-- Agent Zero uses the operating system as a tool to accomplish its tasks. It has no single-purpose tools pre-programmed. Instead, it can write its own code and use the terminal to create and use its own tools as needed.
36
-- The only default tools in its arsenal are online search, memory features, communication (with the user and other agents), and code/terminal execution. Everything else is created by the agent itself or can be extended by the user.
37
-- Tool usage functionality has been developed from scratch to be the most compatible and reliable, even with very small models.
38
-- **Default Tools:** Agent Zero includes tools like knowledge, webpage content, code execution, and communication.
39
-- **Creating Custom Tools:** Extend Agent Zero's functionality by creating your own custom tools.
40
-- **Instruments:** Instruments are a new type of tool that allow you to create custom functions and procedures that can be called by Agent Zero.
41
-
42
-3. **Multi-agent Cooperation**
43
-
44
-- Every agent has a superior agent giving it tasks and instructions. Every agent then reports back to its superior.
45
-- In the case of the first agent in the chain (Agent 0), the superior is the human user; the agent sees no difference.
46
-- Every agent can create its subordinate agent to help break down and solve subtasks. This helps all agents keep their context clean and focused.
47
-
48
-
49
-
50
-
51
-4. **Completely Customizable and Extensible**
52
-
53
-- Almost nothing in this framework is hard-coded. Nothing is hidden. Everything can be extended or changed by the user.
54
-- The whole behavior is defined by a system prompt in the **prompts/default/agent.system.md** file. Change this prompt and change the framework dramatically.
55
-- The framework does not guide or limit the agent in any way. There are no hard-coded rails that agents have to follow.
56
-- Every prompt, every small message template sent to the agent in its communication loop can be found in the **prompts/** folder and changed.
57
-- Every default tool can be found in the **python/tools/** folder and changed or copied to create new predefined tools.
58
-
59
-
60
-
61
-5. **Communication is Key**
62
-
63
-- Give your agent a proper system prompt and instructions, and it can do miracles.
64
-- Agents can communicate with their superiors and subordinates, asking questions, giving instructions, and providing guidance. Instruct your agents in the system prompt on how to communicate effectively.
65
-- The terminal interface is real-time streamed and interactive. You can stop and intervene at any point. If you see your agent heading in the wrong direction, just stop and tell it right away.
66
-- There is a lot of freedom in this framework. You can instruct your agents to regularly report back to superiors asking for permission to continue. You can instruct them to use point-scoring systems when deciding when to delegate subtasks. Superiors can double-check subordinates' results and dispute. The possibilities are endless.
67
-
68
-## 🚀 Things you can build with Agent Zero
69
-
70
-- **Development Projects** - `"Create a React dashboard with real-time data visualization"`
71
-
72
-- **Data Analysis** - `"Analyze last quarter's NVIDIA sales data and create trend reports"`
73
-
74
-- **Content Creation** - `"Write a technical blog post about microservices"`
75
-
76
-- **System Admin** - `"Set up a monitoring system for our web servers"`
77
-
78
-- **Research** - `"Gather and summarize five recent AI papers about CoT prompting"`
79
-
80
-# ⚙️ Installation
81
-
82
-Click to open a video to learn how to install Agent Zero:
83
-
84
-[](https://www.youtube.com/watch?v=cHDCCSr1YRI&t=24s)
85
-
86
-A detailed setup guide for Windows, macOS, and Linux with a video can be found in the Agent Zero Documentation at [this page](./docs/installation.md).
87
-
88
-### ⚡ Quick Start
89
-
90
-```bash
91
-# Pull and run with Docker
92
-
93
-docker pull frdel/agent-zero-run
94
-docker run -p 50001:80 frdel/agent-zero-run
95
-
96
-# Visit http://localhost:50001 to start
97
-```
98
-
99
-- Developers and contributors: download the full binaries for your system from the [releases page](https://github.com/frdel/agent-zero/releases) and then follow the instructions [provided here](./docs/installation.md#in-depth-guide-for-full-binaries-installation).
100
-
101
-## 🐳 Fully Dockerized, with Speech-to-Text and TTS
102
-
103
-
104
-
105
-- Customizable settings allow users to tailor the agent's behavior and responses to their needs.
106
-- The Web UI output is very clean, fluid, colorful, readable, and interactive; nothing is hidden.
107
-- You can load or save chats directly within the Web UI.
108
-- The same output you see in the terminal is automatically saved to an HTML file in **logs/** folder for every session.
109
-
110
-
111
-
112
-- Agent output is streamed in real-time, allowing users to read along and intervene at any time.
113
-- No coding is required; only prompting and communication skills are necessary.
114
-- With a solid system prompt, the framework is reliable even with small models, including precise tool usage.
115
-
116
-## 👀 Keep in Mind
117
-
118
-1. **Agent Zero Can Be Dangerous!**
119
-
120
-- With proper instruction, Agent Zero is capable of many things, even potentially dangerous actions concerning your computer, data, or accounts. Always run Agent Zero in an isolated environment (like Docker) and be careful what you wish for.
121
-
122
-2. **Agent Zero Is Not Pre-programmed; It Is Prompt-based.**
123
-
124
-- The whole framework contains only a minimal amount of code and does not guide the agent in any way. Everything lies in the system prompt located in the **prompts/** folder.
125
-
126
-3. **If You Cannot Provide the Ideal Environment, Let Your Agent Know.**
127
-
128
-- Agent Zero is made to be used in an isolated virtual environment (for safety) with some tools preinstalled and configured.
129
-
130
-### 📌 Known Problems
131
-
132
-1. The system prompt may need improvements; contributions are welcome!
133
-2. The agent may inadvertently alter its operating environment; cleaning up the `work_dir` often fixes this.
134
-3. Agents might loop in multi-agentic interactions, leading to unexpected behaviors.
135
-
136
-## 📚 Read the Documentation
137
-
138
-| Page | Description |
139
-|-------|-------------|
140
-| [Installation](./docs/installation.md) | Installation, setup and configuration |
141
-| [Usage](./docs/usage.md) | Basic and advanced usage |
142
-| [Architecture](./docs/architecture.md) | System design and components |
143
-| [Contributing](./docs/contributing.md) | How to contribute |
144
-| [Troubleshooting](./docs/troubleshooting.md) | Common issues and their solutions |
145
-
146
-## 🎯 Changelog
147
-
148
-### Coming soon
149
-
150
-- **User Interaction Refinements**
151
-- **Browser Use and RAG Tools**
152
-
153
-> [!IMPORTANT]
154
->
155
->**Changes to frdel/agent-zero Docker image since v0.7:**
156
->
157
-> The new Docker image `frdel/agent-zero-run` provides the new unified environment.
158
-
159
-### v0.8
160
-
161
-- **Docker Runtime**
162
-- **New Messages History and Summarization System**
163
-- **Agent Behavior Change and Management**
164
-- **Text-to-Speech (TTS) and Speech-to-Text (STT)**
165
-- **Settings Page in Web UI**
166
-- **SearXNG Integration Replacing Perplexity + DuckDuckGo**
167
-- **File Browser Functionality**
168
-- **KaTeX Math Visualization Support**
169
-- **In-chat File Attachments**
170
-
171
-### v0.7
172
-
173
-- **Automatic Memory**
174
-- **UI Improvements**
175
-- **Instruments**
176
-- **Extensions Framework**
177
-- **Reflection Prompts**
178
-- **Bug Fixes**
179
-
180
-## 🤝 Community and Support
181
-
182
-- [Join our Discord](https://discord.gg/B8KZKNsPpj) for live discussions or [visit our Skool Community](https://www.skool.com/agent-zero).
183
-- [Follow our YouTube channel](https://www.youtube.com/@AgentZeroFW) for hands-on explanations and tutorials
184
-- [Report Issues](https://github.com/frdel/agent-zero/issues) for bug fixes and features
1
+
2
+# Agent Zero Documentation
3
+To begin with Agent Zero, follow the links below for detailed guides on various topics:
4
+
5
+- **[Installation](installation.md):** Set up (or [update](installation.md#how-to-update-agent-zero)) Agent Zero on your system.
6
+- **[Usage Guide](usage.md):** Explore GUI features and usage scenarios.
7
+- **[Architecture Overview](architecture.md):** Understand the internal workings of the framework.
8
+- **[Contributing](contribution.md):** Learn how to contribute to the Agent Zero project.
9
+- **[Troubleshooting and FAQ](troubleshooting.md):** Find answers to common issues and questions.
10
+
11
+### Your experience with Agent Zero starts now!
12
+
13
+- **Download Agent Zero:** Follow the [installation guide](installation.md) to download and run Agent Zero.
14
+- **Join the Community:** Join the Agent Zero [Skool](https://www.skool.com/agent-zero) or [Discord](https://discord.gg/Z2tun2N3) community to discuss ideas, ask questions, and collaborate with other contributors.
15
+- **Share your Work:** Share your Agent Zero creations, workflows and discoverings on our [Show and Tell](https://github.com/agent0ai/agent-zero/discussions/categories/show-and-tell) area on GitHub.
16
+- **Report Issues:** Use the [GitHub issue tracker](https://github.com/agent0ai/agent-zero/issues) to report framework-relative bugs or suggest new features.
17
+
18
+## Table of Contents
19
+
20
+- [Welcome to the Agent Zero Documentation](#agent-zero-documentation)
21
+ - [Your Experience with Agent Zero](#your-experience-with-agent-zero-starts-now)
22
+ - [Table of Contents](#table-of-contents)
23
+- [Installation Guide](installation.md)
24
+ - [Windows, macOS and Linux Setup](installation.md#windows-macos-and-linux-setup-guide)
25
+ - [Settings Configuration](installation.md#settings-configuration)
26
+ - [Choosing Your LLMs](installation.md#choosing-your-llms)
27
+ - [Installing and Using Ollama](installation.md#installing-and-using-ollama-local-models)
28
+ - [Using Agent Zero on Mobile](installation.md#using-agent-zero-on-your-mobile-device)
29
+ - [How to Update Agent Zero](installation.md#how-to-update-agent-zero)
30
+ - [Full Binaries Installation](installation.md#in-depth-guide-for-full-binaries-installation)
31
+- [Usage Guide](usage.md)
32
+ - [Basic Operations](usage.md#basic-operations)
33
+ - [Restart Framework](usage.md#restart-framework)
34
+ - [Action Buttons](usage.md#action-buttons)
35
+ - [File Attachments](usage.md#file-attachments)
36
+ - [Tool Usage](usage.md#tool-usage)
37
+ - [Example of Tools Usage](usage.md#example-of-tools-usage-web-search-and-code-execution)
38
+ - [Multi-Agent Cooperation](usage.md#multi-agent-cooperation)
39
+ - [Prompt Engineering](usage.md#prompt-engineering)
40
+ - [Voice Interface](usage.md#voice-interface)
41
+ - [Mathematical Expressions](usage.md#mathematical-expressions)
42
+ - [File Browser](usage.md#file-browser)
43
+ - [Backup & Restore](usage.md#backup--restore)
44
+- [Architecture Overview](architecture.md)
45
+ - [System Architecture](architecture.md#system-architecture)
46
+ - [Runtime Architecture](architecture.md#runtime-architecture)
47
+ - [Implementation Details](architecture.md#implementation-details)
48
+ - [Core Components](architecture.md#core-components)
49
+ - [Agents](architecture.md#1-agents)
50
+ - [Tools](architecture.md#2-tools)
51
+ - [SearXNG Integration](architecture.md#searxng-integration)
52
+ - [Memory System](architecture.md#3-memory-system)
53
+ - [Messages History and Summarization](archicture.md#messages-history-and-summarization)
54
+ - [Prompts](architecture.md#4-prompts)
55
+ - [Knowledge](architecture.md#5-knowledge)
56
+ - [Instruments](architecture.md#6-instruments)
57
+ - [Extensions](architecture.md#7-extensions)
58
+ - [Contributing](contribution.md)
59
+ - [Getting Started](contribution.md#getting-started)
60
+ - [Making Changes](contribution.md#making-changes)
61
+ - [Submitting a Pull Request](contribution.md#submitting-a-pull-request)
62
+ - [Documentation Stack](contribution.md#documentation-stack)
63
+- [Troubleshooting and FAQ](troubleshooting.md)
64
+ - [Frequently Asked Questions](troubleshooting.md#frequently-asked-questions)
65
+ - [Troubleshooting](troubleshooting.md#troubleshooting)
knowledge/default/main/about/installation.md
+24
-38
@@ -1,24 +1,14 @@
1
# Users installation guide for Windows, macOS and Linux
2
3
-[](https://www.youtube.com/watch?v=wWAqJpl3uQE)
3
+Click to open a video to learn how to install Agent Zero:
4
+
5
+[](https://www.youtube.com/watch?v=L1_peV8szf8)
6
7
The following 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](#in-depth-guide-for-full-binaries-installation).
8
7
-### Need updates from v0.7? 👉[How to update Agent Zero](#how-to-update-agent-zero)
9
10
## Windows, macOS and Linux Setup Guide
11
11
-### Prerequisites
12
-
13
-| Component | Minimum | Recommended |
14
-|-----------|---------|-------------|
15
-| RAM | 4GB | 8GB |
16
-| Storage | 10GB | 10GB |
17
-| CPU | 2 cores | 4 cores |
18
-| Docker | Required | Required |
19
-| Internet | Optional* | Required |
20
-
21
-Note*: Offline operation requires prompt adjustments
12
13
1. **Install Docker Desktop:**
14
- Docker Desktop provides the runtime environment for Agent Zero, ensuring consistent behavior and security across platforms
@@ -60,8 +50,6 @@ Note*: Offline operation requires prompt adjustments
50
<img src="res/setup/image-13.png" alt="docker installed" height="100"/>
51
<br><br>
52
63
-1.5. Create a Docker Hub account when prompted and sign in. This is required to pull the Agent Zero container image.
64
-
53
> [!IMPORTANT]
54
> **macOS Configuration:** In Docker Desktop's preferences (Docker menu) → Settings →
55
> Advanced, enable "Allow the default Docker socket to be used (requires password)."
@@ -70,8 +58,10 @@ Note*: Offline operation requires prompt adjustments
58
59
2. **Run Agent Zero:**
60
61
+- Note: Agent Zero also offers a Hacking Edition based on Kali linux with modified prompts for cybersecurity tasks. The setup is the same as the regular version, just use the agent0ai/agent-zero:hacking image instead of agent0ai/agent-zero.
62
+
63
2.1. Pull the Agent Zero Docker image:
74
-- Search for `frdel/agent-zero-run` in Docker Desktop
64
+- Search for `agent0ai/agent-zero` in Docker Desktop
65
- Click the `Pull` button
66
- The image will be downloaded to your machine in a few minutes
67
@@ -81,7 +71,7 @@ Note*: Offline operation requires prompt adjustments
71
> Alternatively, run the following command in your terminal:
72
>
73
> ```bash
84
-> docker pull frdel/agent-zero-run
74
+> docker pull agent0ai/agent-zero
75
> ```
76
77
2.2. Create a data directory for persistence:
@@ -102,9 +92,11 @@ Note*: Offline operation requires prompt adjustments
92
93
2.3. Run the container:
94
- In Docker Desktop, go back to the "Images" tab
105
-- Click the `Run` button next to the `frdel/agent-zero-run` image
95
+- Click the `Run` button next to the `agent0ai/agent-zero` image
96
- Open the "Optional settings" menu
97
- Set the port to `0` in the second "Host port" field (for automatic port assignment)
98
+
99
+Optionally you can map local folders for file persistence:
100
- Under "Volumes", configure:
101
- Host path: Your chosen directory (e.g., `C:\agent-zero-data`)
102
- Container path: `/a0`
@@ -119,7 +111,7 @@ Note*: Offline operation requires prompt adjustments
111
> [!TIP]
112
> Alternatively, run the following command in your terminal:
113
> ```bash
122
-> docker run -p $PORT:80 -v /path/to/your/data:/a0 frdel/agent-zero-run
114
+> docker run -p $PORT:80 -v /path/to/your/data:/a0 agent0ai/agent-zero
115
> ```
116
> - Replace `$PORT` with the port you want to use (e.g., `50080`)
117
> - Replace `/path/to/your/data` with your chosen directory path
@@ -304,32 +296,26 @@ For developers or users who need to run Agent Zero directly on their system,see
296
297
# How to update Agent Zero
298
307
-1. **If you come from the previous version of Agent Zero (pre-0.7.1):**
299
+1. **If you come from the previous version of Agent Zero:**
300
- Your data is safely stored across various directories and files inside the Agent Zero folder.
309
-- To update to the new Docker runtime version, you need to save the following files and directories:
301
+- To update to the new Docker runtime version, you might want to backup the following files and directories:
302
- `/memory` - Agent's memory
311
- - `/knowledge` - Custom knowledge base
312
- - `/instruments` - Custom instruments and functions
313
- - `/prompts` - Custom prompts files (if any has been created)
314
- - `/work_dir` - Working directory
315
- - `.env` - Your API keys
303
+ - `/knowledge` - Custom knowledge base (if you imported any custom knowledge files)
304
+ - `/instruments` - Custom instruments and functions (if you created any custom)
305
- `/tmp/settings.json` - Your Agent Zero settings
306
+ - `/tmp/chats/` - Your chat history
307
- Once you have saved these files and directories, you can proceed with the Docker runtime [installation instructions above](#windows-macos-and-linux-setup-guide) setup guide.
308
- Reach for the folder where you saved your data and copy it to the new Agent Zero folder set during the installation process.
309
- Agent Zero will automatically detect your saved data and use it across memory, knowledge, instruments, prompts and settings.
310
311
> [!IMPORTANT]
322
-> Make sure to use the same embedding model you were using before, otherwise
323
-> you will have to re-index all of Agent Zero's memory, therefore deleting all
324
-> your custom knowledge and memory.
325
->
326
-> If you have issues loading your settings, you can try to delete the `/tmp/settings.json`
327
-> file and let Agent Zero generate a new one.
312
+> If you have issues loading your settings, you can try to delete the `/tmp/settings.json` file and let Agent Zero generate a new one.
313
+> The same goes for chats in `/tmp/chats/`, they might be incompatible with the new version
314
315
2. **Update Process (Docker Desktop)**
316
- Go to Docker Desktop and stop the container from the "Containers" tab
317
- Right-click and select "Remove" to remove the container
332
-- Go to "Images" tab and remove the `frdel/agent-zero-run` image or click the three dots to pull the difference and update the Docker image.
318
+- Go to "Images" tab and remove the `agent0ai/agent-zero` image or click the three dots to pull the difference and update the Docker image.
319
320
321
@@ -352,13 +338,13 @@ For developers or users who need to run Agent Zero directly on their system,see
338
> docker rm agent-zero
339
>
340
> # Remove the old image
355
-> docker rmi frdel/agent-zero-run
341
+> docker rmi agent0ai/agent-zero
342
>
343
> # Pull the latest image
358
-> docker pull frdel/agent-zero-run
344
+> docker pull agent0ai/agent-zero
345
>
346
> # Run new container with the same volume mount
361
-> docker run -p $PORT:80 -v /path/to/your/data:/a0 frdel/agent-zero-run
347
+> docker run -p $PORT:80 -v /path/to/your/data:/a0 agent0ai/agent-zero
348
> ```
349
350
3. **Full Binaries**
@@ -417,9 +403,9 @@ For developers or users who need to run Agent Zero directly on their system,see
403
404
405
## 2. Download Agent Zero
420
-- You can clone the Agent Zero repository (https://github.com/frdel/agent-zero) from GitHub if you know how to use Git. In this tutorial I will just show how to download the files.
406
+- You can clone the Agent Zero repository (https://github.com/agent0ai/agent-zero) from GitHub if you know how to use Git. In this tutorial I will just show how to download the files.
407
422
-1. Go to the Agent Zero releases [here](https://github.com/frdel/agent-zero/releases).
408
+1. Go to the Agent Zero releases [here](https://github.com/agent0ai/agent-zero/releases).
409
2. The latest release is on the top of the list, click the "Source Code (zip)" button under "Assets" to download it.
410
411
<img src="res/setup/image-14-u.png" alt="agent zero download" width="500"/>
webui/index.html
+1
-1
@@ -147,7 +147,7 @@
147
</button>
148
149
<div id="logo-container">
150
- <a href="https://github.com/frdel/agent-zero" target="_blank" rel="noopener noreferrer">
150
+ <a href="https://github.com/agent0ai/agent-zero" target="_blank" rel="noopener noreferrer">
151
<img src="./public/splash.jpg" alt="a0" width="22" height="22">
152
</a>
153
</div>