Agent Zero AI framework
v0.9.7 - readme, docs
frdel4c4de7ebca97
diff --git a/README.md b/README.mdindex 7b56d4ff5..99d58ef4f 100644--- a/README.md+++ b/README.md@@ -26,14 +26,8 @@ Or see DeepWiki generated documentation:<div align="center">-> ### π¨ **IMPORTANT ANNOUNCEMENT** π¨--The original GitHub and DockerHub repositories for Agent Zero have been transferred to a new namespace:--- **GitHub & DockerHub:** `agent0ai/agent-zero`--From now on, please use this name for both `git clone` and `docker pull` commands.-+> ### π¨ **PROJECTS!** π¨+Agent Zero now supports **Projects** β isolated workspaces with their own prompts, files, memory, and secrets, so you can create dedicated setups for each use case without mixing contexts.</div>@@ -169,6 +163,26 @@ docker run -p 50001:80 agent0ai/agent-zero## π― Changelog+### v0.9.7 - Projects+[Release video](https://youtu.be/RrTDp_v9V1c)+- Projects management+ - Support for custom instructions+ - Integration with memory, knowledge, files+ - Project specific secrets+- New Welcome screen/Dashboard+- New Wait tool+- Subordinate agent configuration override support+- Support for multiple documents at once in document_query_tool+- Improved context on interventions+- Openrouter embedding support+- Frontend components refactor and polishing+- SSH metadata output fix+- Support for windows powershell in local TTY utility+- More efficient selective streaming for LLMs+- UI output length limit improvements+++### v0.9.6 - Memory Dashboard[Release video](https://youtu.be/sizjAq2-d9s)- Memory Management Dashboarddiff --git a/docs/extensibility.md b/docs/extensibility.mdindex bf70d3897..db10a2a88 100644--- a/docs/extensibility.md+++ b/docs/extensibility.md@@ -213,6 +213,11 @@ Agent Zero supports creating specialized subagents with customized behavior. The- `/agents/{agent_profile}/extensions/` - for custom extensions- `/agents/{agent_profile}/tools/` - for custom tools- `/agents/{agent_profile}/prompts/` - for custom prompts+ - `/agents/{agent_profile}/settings.json` - for agent-specific configuration overrides++The `settings.json` file for an agent uses the same structure as `tmp/settings.json`, but you only need to specify the fields you want to override. Any field omitted from the agent-specific `settings.json` will continue to use the global value.++This allows power users to, for example, change the AI model, context window size, or other settings for a single agent without affecting the rest of the system.### Example Subagent Structure@@ -223,15 +228,71 @@ Agent Zero supports creating specialized subagents with customized behavior. Theβ βββ _10_example_extension.pyβββ prompts/β βββ ...-βββ tools/- βββ example_tool.py- βββ response.py+βββ tools/+β βββ example_tool.py+β βββ response.py+βββ settings.json```In this example:- `_10_example_extension.py` is an extension that renames the agent when initialized- `response.py` overrides the default response tool with custom behavior- `example_tool.py` is a new tool specific to this agent+- `settings.json` overrides any global settings for this specific agent (only for the fields defined in this file)++## Projects++Projects provide isolated workspaces for individual chats, keeping prompts, memory, knowledge, files, and secrets scoped to a specific use case.++### Project Location and Structure++- Projects are located under `/a0/usr/projects/`+- Each project has its own subdirectory, created by users via the UI+- A project can be backed up or restored by copying or downloading its entire directory++Each project directory contains a hidden `.a0proj` folder with project metadata and configuration:++```+/a0/usr/projects/{project_name}/+βββ .a0proj/+ βββ project.json # project metadata and settings+ βββ instructions/ # additional prompt/instruction files+ βββ knowledge/ # files to be imported into memory+ βββ memory/ # project-specific memory storage+ βββ secrets.env # sensitive variables (secrets)+ βββ variables.env # non-sensitive variables+```++### Behavior When a Project Is Active in a Chat++When a project is activated for a chat:++- The agent is instructed to work **inside the project directory**+- Project prompts (instructions) from `.a0proj/instructions/` are **automatically injected** into the context window (all text files are imported)+- Memory can be configured as **project-specific**, meaning:+ - It does not mix with global memory+ - The memory file is stored under `.a0proj/memory/`+- Files created or modified by the agent are located within the project directory++The `.a0proj/knowledge/` folder contains files that are imported into the projectβs memory, enabling project-focused knowledge bases.++### Secrets and Variables++Each project manages its own configuration values via environment files in `.a0proj/`:++- `secrets.env` β **sensitive variables**, such as API keys or passwords+- `variables.env` β **non-sensitive variables**, such as configuration flags or identifiers++These files allow you to keep credentials and configuration tightly scoped to a single project.++### When to Use Projects++Projects are the recommended way to create specialized workflows in Agent Zero when you need to:++- Add specific instructions without affecting global behavior+- Isolate file context, knowledge, and memory for a particular task or client+- Keep passwords and other secrets scoped to a single workspace+- Run multiple independent flows side by side under the same Agent Zero installation## Best Practices- Keep extensions focused on a single responsibility