fix: set GIT_PAGER=cat to prevent git pager CPU spin (fixes #1697)

.harness/Build_RemyLoveLogicAI_agent_zero_1782009567517-pr-trigger-input-set-1782009569952.yaml

@@ -0,0 +1,14 @@
+inputSet:
+  name: Build_RemyLoveLogicAI_agent_zero_1782009567517-pr-trigger-input-set
+  identifier: Build_RemyLoveLogicAI_agent_zero_1782009567517prtriggerinputset
+  orgIdentifier: default
+  projectIdentifier: default_project
+  pipeline:
+    identifier: Build_RemyLoveLogicAI_agent_zero_1782009567517
+    properties:
+      ci:
+        codebase:
+          build:
+            type: PR
+            spec:
+              number: <+trigger.prNumber>

.harness/Build_RemyLoveLogicAI_agent_zero_1782009567517-push-trigger-input-set-1782009571141.yaml

@@ -0,0 +1,14 @@
+inputSet:
+  name: Build_RemyLoveLogicAI_agent_zero_1782009567517-push-trigger-input-set
+  identifier: Build_RemyLoveLogicAI_agent_zero_1782009567517pushtriggerinputset
+  orgIdentifier: default
+  projectIdentifier: default_project
+  pipeline:
+    identifier: Build_RemyLoveLogicAI_agent_zero_1782009567517
+    properties:
+      ci:
+        codebase:
+          build:
+            type: branch
+            spec:
+              branch: <+trigger.branch>

.harness/pipelines/agent-zero-1782009563784.yaml

@@ -0,0 +1,48 @@
+pipeline:
+  identifier: Build_RemyLoveLogicAI_agent_zero_1782009567517
+  name: Build agent-zero
+  orgIdentifier: default
+  projectIdentifier: default_project
+  properties:
+    ci:
+      codebase:
+        build: <+input>
+        connectorRef: account.Github_OAuth_1782009530996
+        repoName: RemyLoveLogicAI/agent-zero
+  stages:
+    - stage:
+        identifier: build
+        name: build
+        spec:
+          caching:
+            enabled: true
+          cloneCodebase: true
+          execution:
+            steps:
+              - step:
+                  identifier: runlinter
+                  name: run linter
+                  spec:
+                    command: |-
+                      pip install flake8
+                      flake8 .
+                  timeout: ""
+                  type: Run
+              - step:
+                  identifier: setupvirtualenvironment
+                  name: setup virtual environment
+                  spec:
+                    command: |-
+                      python3 -m venv .venv
+                      . .venv/bin/activate
+                      python3 -m pip install -r requirements.txt
+                      python3 -m pip install -e .
+                  timeout: ""
+                  type: Run
+          platform:
+            arch: Amd64
+            os: Linux
+          runtime:
+            spec: {}
+            type: Cloud
+        type: CI

README.md

@@ -1,215 +0,0 @@
-<div align="center">
-
-# `Agent Zero`
-
-[![Agent Zero Website](https://img.shields.io/badge/Website-agent--zero.ai-0A192F?style=for-the-badge&logo=vercel&logoColor=white)](https://agent-zero.ai) [![Thanks to Sponsors](https://img.shields.io/badge/GitHub%20Sponsors-Thanks%20to%20Sponsors-FF69B4?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/frdel) [![Follow on X](https://img.shields.io/badge/X-Follow-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/Agent0ai) [![Join our Discord](https://img.shields.io/badge/Discord-Join%20our%20server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/B8KZKNsPpj) [![Subscribe on YouTube](https://img.shields.io/badge/YouTube-Subscribe-red?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@AgentZeroFW) [![Connect on LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/jan-tomasek/) [![Follow on Warpcast](https://img.shields.io/badge/Warpcast-Follow-5A32F3?style=for-the-badge)](https://warpcast.com/agent-zero)
-
-[Introduction](#a-personal-organic-agentic-framework-that-grows-and-learns-with-you) •
-[Installation](./docs/installation.md) •
-[Hacking Edition](#hacking-edition) •
-[How to update](./docs/installation.md#how-to-update-agent-zero) •
-[Documentation](./docs/README.md) •
-[Usage](./docs/usage.md)
-
-</div>
-
-
-[![Showcase](/docs/res/showcase-thumb.png)](https://youtu.be/lazLNcEYsiQ)
-
-
-
-
-
-## A personal, organic agentic framework that grows and learns with you
-
-- Agent Zero is not a predefined agentic framework. It is designed to be dynamic, organically growing, and learning as you use it.
-- Agent Zero is fully transparent, readable, comprehensible, customizable, and interactive.
-- Agent Zero uses the computer as a tool to accomplish its (your) tasks.
-
-# 💡 Key Features
-
-1. **General-purpose Assistant**
-
-- 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.
-- 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.
-
-![Agent 0 Working](/docs/res/ui-screen-2.png)
-
-2. **Computer as a Tool**
-
-- 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.
-- 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.
-- Tool usage functionality has been developed from scratch to be the most compatible and reliable, even with very small models.
-- **Default Tools:** Agent Zero includes tools like knowledge, webpage content, code execution, and communication.
-- **Creating Custom Tools:** Extend Agent Zero's functionality by creating your own custom tools.
-- **Instruments:** Instruments are a new type of tool that allow you to create custom functions and procedures that can be called by Agent Zero.
-
-3. **Multi-agent Cooperation**
-
-- Every agent has a superior agent giving it tasks and instructions. Every agent then reports back to its superior.
-- In the case of the first agent in the chain (Agent 0), the superior is the human user; the agent sees no difference.
-- Every agent can create its subordinate agent to help break down and solve subtasks. This helps all agents keep their context clean and focused.
-
-![Multi-agent](docs/res/physics.png)
-![Multi-agent 2](docs/res/physics-2.png)
-
-4. **Completely Customizable and Extensible**
-
-- Almost nothing in this framework is hard-coded. Nothing is hidden. Everything can be extended or changed by the user.
-- 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.
-- The framework does not guide or limit the agent in any way. There are no hard-coded rails that agents have to follow.
-- Every prompt, every small message template sent to the agent in its communication loop can be found in the **prompts/** folder and changed.
-- Every default tool can be found in the **python/tools/** folder and changed or copied to create new predefined tools.
-
-![Prompts](/docs/res/prompts.png)
-
-5. **Communication is Key**
-
-- Give your agent a proper system prompt and instructions, and it can do miracles.
-- 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.
-- 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.
-- 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.
-
-## 🚀 Things you can build with Agent Zero
-
-- **Development Projects** - `"Create a React dashboard with real-time data visualization"`
-
-- **Data Analysis** - `"Analyze last quarter's NVIDIA sales data and create trend reports"`
-
-- **Content Creation** - `"Write a technical blog post about microservices"`
-
-- **System Admin** - `"Set up a monitoring system for our web servers"`
-
-- **Research** - `"Gather and summarize five recent AI papers about CoT prompting"`
-
-# Hacking Edition
-- 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
-
-
-# ⚙️ Installation
-
-Click to open a video to learn how to install Agent Zero:
-
-[![Easy Installation guide](/docs/res/easy_ins_vid.png)](https://www.youtube.com/watch?v=L1_peV8szf8)
-
-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).
-
-### ⚡ Quick Start
-
-```bash
-# Pull and run with Docker
-
-docker pull frdel/agent-zero-run
-docker run -p 50001:80 frdel/agent-zero-run
-
-# Visit http://localhost:50001 to start
-```
-
-## 🐳 Fully Dockerized, with Speech-to-Text and TTS
-
-![Settings](docs/res/settings-page-ui.png)
-
-- Customizable settings allow users to tailor the agent's behavior and responses to their needs.
-- The Web UI output is very clean, fluid, colorful, readable, and interactive; nothing is hidden.
-- You can load or save chats directly within the Web UI.
-- The same output you see in the terminal is automatically saved to an HTML file in **logs/** folder for every session.
-
-![Time example](/docs/res/time_example.jpg)
-
-- Agent output is streamed in real-time, allowing users to read along and intervene at any time.
-- No coding is required; only prompting and communication skills are necessary.
-- With a solid system prompt, the framework is reliable even with small models, including precise tool usage.
-
-## 👀 Keep in Mind
-
-1. **Agent Zero Can Be Dangerous!**
-
-- 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.
-
-2. **Agent Zero Is Prompt-based.**
-
-- The whole framework is guided by the **prompts/** folder. Agent guidelines, tool instructions, messages, utility AI functions, it's all there.
-
-
-## 📚 Read the Documentation
-
-| Page | Description |
-|-------|-------------|
-| [Installation](./docs/installation.md) | Installation, setup and configuration |
-| [Usage](./docs/usage.md) | Basic and advanced usage |
-| [Architecture](./docs/architecture.md) | System design and components |
-| [Contributing](./docs/contribution.md) | How to contribute |
-| [Troubleshooting](./docs/troubleshooting.md) | Common issues and their solutions |
-
-## Coming soon
-
-- **MCP**
-- **Knowledge and RAG Tools**
-
-## 🎯 Changelog
-
-### v0.8.4.1
-- Various bugfixes related to context management
-- Message formatting improvements
-- Scheduler improvements
-- New model provider
-- Input tool fix
-- Compatibility and stability improvements
-
-### v0.8.4
-[Release video](https://youtu.be/QBh_h_D_E24)
-
-- **Remote access (mobile)**
-
-### v0.8.3.1
-[Release video](https://youtu.be/AGNpQ3_GxFQ)
-
-- **Automatic embedding**
-
-
-### v0.8.3
-[Release video](https://youtu.be/bPIZo0poalY)
-
-- ***Planning and scheduling***
-
-### v0.8.2
-[Release video](https://youtu.be/xMUNynQ9x6Y)
-
-- **Multitasking in terminal**
-- **Chat names**
-
-### v0.8.1
-[Release video](https://youtu.be/quv145buW74)
-
-- **Browser Agent**
-- **UX Improvements**
-
-### v0.8
-[Release video](https://youtu.be/cHDCCSr1YRI)
-
-- **Docker Runtime**
-- **New Messages History and Summarization System**
-- **Agent Behavior Change and Management**
-- **Text-to-Speech (TTS) and Speech-to-Text (STT)**
-- **Settings Page in Web UI**
-- **SearXNG Integration Replacing Perplexity + DuckDuckGo**
-- **File Browser Functionality**
-- **KaTeX Math Visualization Support**
-- **In-chat File Attachments**
-
-### v0.7
-[Release video](https://youtu.be/U_Gl0NPalKA)
-
-- **Automatic Memory**
-- **UI Improvements**
-- **Instruments**
-- **Extensions Framework**
-- **Reflection Prompts**
-- **Bug Fixes**
-
-## 🤝 Community and Support
-
-- [Join our Discord](https://discord.gg/B8KZKNsPpj) for live discussions or [visit our Skool Community](https://www.skool.com/agent-zero).
-- [Follow our YouTube channel](https://www.youtube.com/@AgentZeroFW) for hands-on explanations and tutorials
-- [Report Issues](https://github.com/frdel/agent-zero/issues) for bug fixes and features

app_init.py

@@ -0,0 +1,8 @@
+"""Simple entry point to launch the Agent Zero Web UI."""
+from run_ui import run
+from python.helpers import runtime, dotenv
+
+if __name__ == "__main__":
+    runtime.initialize()
+    dotenv.load_dotenv()
+    run()

docs/README.md

@@ -4,6 +4,7 @@ To begin with Agent Zero, follow the links below for detailed guides on various
 
 - **[Installation](installation.md):** Set up (or [update](installation.md#how-to-update-agent-zero)) Agent Zero on your system.
 - **[Usage Guide](usage.md):** Explore GUI features and usage scenarios.
+- **[Hacking Edition](hacking.md):** Run the Kali-based variant.
 - **[Architecture Overview](architecture.md):** Understand the internal workings of the framework.
 - **[Contributing](contribution.md):** Learn how to contribute to the Agent Zero project.
 - **[Troubleshooting and FAQ](troubleshooting.md):** Find answers to common issues and questions.

docs/hacking.md

@@ -0,0 +1,22 @@
+# Hacking Edition
+
+Agent Zero includes a special Docker image based on Kali Linux with additional tools and modified prompts tailored for cybersecurity research.
+
+## Quick Start
+
+```bash
+docker pull frdel/agent-zero-run:hacking
+docker run -p 50001:80 frdel/agent-zero-run:hacking
+```
+
+Open `http://localhost:50001` in your browser after the container starts.
+
+The hacking edition shares the same configuration files as the regular version. Mount a data directory if you want persistent storage:
+
+```bash
+docker run -p 50001:80 -v /path/to/a0-data:/a0 frdel/agent-zero-run:hacking
+```
+
+## Custom Prompts
+
+The hacking image sets `AGENT_PROMPTS_SUBDIR=hacking`, enabling prompts from `prompts/hacking/` to override defaults. You can modify these files to suit your workflow.

docs/installation.md

@@ -58,7 +58,7 @@ The following user guide provides instructions for installing and running Agent
 
 2. **Run Agent Zero:**
 
-- 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.
+  *For the Kali-based variant see [Hacking Edition](hacking.md).*
 
 2.1. Pull the Agent Zero Docker image:
 - Search for `frdel/agent-zero-run` in Docker Desktop

instruments/default/viral_video_experiment/viral_video_experiment.md

@@ -0,0 +1,18 @@
+# Problem
+Run a small viral video experiment by downloading trending clips, adding branding and a CTA, and logging processed files.
+
+# Solution
+1. If a working folder is required, `cd` to it.
+2. Run the shell script with your query, number of clips, branding text, and CTA text:
+
+```bash
+bash /a0/instruments/default/viral_video_experiment/viral_video_experiment.sh "<query>" <count> "<branding>" "<cta>"
+```
+
+Example:
+
+```bash
+bash /a0/instruments/default/viral_video_experiment/viral_video_experiment.sh "morning routines" 5 "MyBrand" "Visit example.com"
+```
+
+3. Processed videos are stored in `tmp/viral_videos/processed` and a CSV log is written to `tmp/viral_videos/experiment_metrics.csv`.