====== Agent Zero ======

[[https://github.com/agent0ai/agent-zero/tree/main|Agent Zero]] je open-source agentický framework pro obecné použití, který běží primárně v Dockeru a staví na tom, že agent používá počítač jako pracovní nástroj. Podle [[https://github.com/agent0ai/agent-zero/blob/main/README.md|README]] a [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/architecture.md|architektury projektu]] nejde o úzce specializovaného chatbota, ale o rozšiřitelné prostředí s webovým UI, persistentní pamětí, projekty, pluginy, MCP integrací a podporou více agentů. Prakticky je to zajímavé hlavně pro self-hosted provoz, automatizaci a experimentování s vlastními agentními workflow.

===== Co je na projektu zajímavé =====

README projektu popisuje Agent Zero jako framework, ne jako jeden pevně naprogramovaný agent. Základní myšlenka je, že agent dostane úkol, sám si rozkládá práci, používá dostupné nástroje, spouští kód, může delegovat podúkoly na podřízené agenty a průběžně si ukládá znalosti do paměti.

Prakticky jsou důležité hlavně tyto vlastnosti:

  * agent používá operační systém jako nástroj, ne jen předem připravené API funkce
  * podporuje hierarchii agentů a delegování podúkolů
  * má persistentní paměť pro řešení, fakta a dlouhodobější kontext
  * umí izolovat práci do projektů s vlastními instrukcemi, proměnnými, tajemstvími a workspace
  * podporuje otevřený standard skillů přes soubory ''SKILL.md''
  * dá se rozšiřovat přes pluginy, MCP servery a vlastní prompty

===== Architektura a způsob provozu =====

Podle [[https://github.com/agent0ai/agent-zero/blob/main/docs/quickstart.md|Quick Startu]] a [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/architecture.md|Architecture Overview]] je doporučený provoz postavený na Dockeru. Hostitelský systém řeší hlavně běh kontejneru a přístup přes prohlížeč, samotný framework běží uvnitř runtime kontejneru.

To má několik praktických dopadů:

  * prostředí je konzistentní napříč platformami
  * nasazení je relativně jednoduché
  * izolace snižuje riziko při práci agenta
  * aktualizace a přenositelnost jsou jednodušší než u čistě host-based instalace

Repozitář je postavený hlavně na Pythonu. V dokumentaci a závislostech je vidět Flask, LiteLLM, Playwright, FAISS, FastMCP a Socket.IO. Frontend tvoří webové UI, backend řeší API, promptovací vrstvu, nástroje, pluginy a práci s pamětí.

===== Klíčové funkce =====

==== Obecný agent s vlastními nástroji ====

README popisuje Agent Zero jako obecného asistenta, který není svázaný jen s jedním use-casem. Umí:

  * spouštět shell, Python a další kód
  * pracovat se soubory
  * vyhledávat informace
  * komunikovat s uživatelem i s podřízenými agenty
  * ukládat výsledky a zkušenosti do paměti

Důležitý detail je, že framework se nespoléhá jen na pevně zadrátované workflow. Velká část chování se řídí promptovou vrstvou v adresáři ''prompts/'' a dá se upravovat.

==== Multi-agent model ====

Podle [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/architecture.md|architektury]] Agent Zero používá hierarchii nadřízených a podřízených agentů. Hlavní agent může rozdělit úkol na podúkoly a delegovat je dál. To dává smysl hlavně u složitější práce, kde je potřeba oddělit průzkum, implementaci, kontrolu nebo specializované kroky.

==== Projekty ====

Podle [[https://github.com/agent0ai/agent-zero/blob/main/docs/guides/projects.md|Working with Projects]] jsou projekty jedna z nejsilnějších funkcí frameworku. Projekt poskytuje:

  * izolovaný workspace
  * vlastní instrukce vkládané do system promptu
  * vlastní nebo sdílenou paměť
  * projektové proměnné a secrets
  * integraci s Git repozitářem
  * znalost struktury souborů v daném projektu

To je praktické hlavně pro oddělení klientů, technologií nebo různých typů práce, aby se nemíchal kontext.

==== Skills a pluginy ====

README explicitně zmiňuje systém skillů založený na otevřeném formátu ''SKILL.md''. Cílem je, aby agent načítal kontextové schopnosti jen tehdy, když jsou potřeba, místo toho aby měl všechno trvale v promptu.

Vedle skillů má framework i pluginy. Ty rozšiřují backend, nástroje, web UI i lifecycle hooky. Pro uživatelské rozšíření je důležitý hlavně adresář ''usr/plugins/''.

==== MCP klient i server ====

Podle [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/mcp-configuration.md|Advanced MCP Configuration]] umí Agent Zero fungovat jako MCP klient a připojovat externí MCP servery. Podle [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/connectivity.md|Connectivity]] zároveň umí vystavit vlastní MCP server pro jiné MCP kompatibilní klienty.

To je zajímavé hlavně tehdy, když chceš:

  * připojit externí nástroje bez úprav core kódu
  * používat Agent Zero jako nástrojový backend pro jiného klienta
  * kombinovat více agentních a nástrojových systémů přes standardní rozhraní

==== Scheduler, hlas a webové UI ====

[[https://github.com/agent0ai/agent-zero/blob/main/docs/guides/usage.md|Usage Guide]] ukazuje, že framework není jen chat okno. Součástí UI je také:

  * správce projektů
  * file browser a editor
  * přehled kontextu a historie
  * plugin hub
  * task scheduler pro plánované úlohy
  * voice interface

Speech-to-text je v dokumentaci popsané přes Whisper a text-to-speech používá hlasové rozhraní prohlížeče. Dokumentace zároveň uvádí, že hlasové funkce běží lokálně v Docker kontejneru.

===== Instalace a první spuštění =====

Nejrychlejší cesta podle README a Quick Startu vypadá takto:

<code bash>
curl -fsSL https://bash.agent-zero.ai | bash
</code>

Na Windows je uveden PowerShell ekvivalent:

<code powershell>
irm https://ps.agent-zero.ai | iex
</code>

Případně jde spustit i přímo Docker image:

<code bash>
docker run -p 80:80 agent0ai/agent-zero
</code>

Pokud má Agent Zero pracovat s reálnými lokálními soubory na hostu, dokumentace doporučuje host-side connector ''a0'':

<code bash>
curl -LsSf https://raw.githubusercontent.com/agent0ai/a0-connector/main/install.sh | sh
a0
</code>

Tady je důležité, že agent může zůstat izolovaný v Dockeru, ale přes connector pracovat s reálnými soubory na hostitelském systému.

===== Kde to dává smysl =====

Agent Zero dává smysl hlavně v situacích, kdy nestačí jednoduchý chat nad LLM a je potřeba agenta napojit na skutečné pracovní prostředí.

Typické scénáře:

  * práce nad lokálními soubory a repozitáři
  * oddělené projekty pro klienty nebo domény
  * automatizace opakovaných úloh přes scheduler
  * napojení externích nástrojů přes MCP
  * experimentování s prompty, pluginy, skills a agentní architekturou
  * vlastní self-hosted agent, kde chce mít uživatel větší kontrolu nad chováním

===== Na co si dát pozor =====

Projekt sám v [[https://github.com/agent0ai/agent-zero/blob/main/README.md|README]] upozorňuje, že může být nebezpečný, pokud dostane příliš široká oprávnění nebo běží bez izolace. To je potřeba brát vážně, protože framework umí spouštět kód, pracovat se soubory, používat síť a napojovat další nástroje.

Praktická omezení nebo rizika:

  * bez dobrých instrukcí a promptů nemusí být chování konzistentní
  * jde spíš o framework pro stavbu vlastního workflow než o úplně bezúdržbový produkt
  * reálná síla systému roste s kvalitou modelů, konfigurace a projektových instrukcí
  * pro bezpečný provoz je vhodné držet se dockerizovaného a izolovaného nasazení

===== Licence =====

Součástí repozitáře je [[https://github.com/agent0ai/agent-zero/blob/main/LICENSE|MIT licence]], takže projekt je možné používat a upravovat i v širších scénářích než jen pro osobní experimenty.

===== Shrnutí =====

Agent Zero je zajímavý hlavně jako otevřený agentní framework pro lidi, kteří chtějí kombinovat LLM, nástroje, projekty, paměť, MCP a vlastní rozšíření v jednom prostředí. Není to nejjednodušší nástroj na rychlé vyzkoušení AI chatu, ale spíš platforma pro praktickou práci a experimentování s agenty nad skutečným systémem.

Pokud někdo hledá self-hosted agenta s Docker provozem, projektovou izolací, podporou skillů a rozšiřitelností přes pluginy a MCP, Agent Zero stojí za vyzkoušení.

===== Zdroje =====

  * [[https://github.com/agent0ai/agent-zero/tree/main|Agent Zero – repozitář]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/README.md|README]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/quickstart.md|Quick Start]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/guides/usage.md|Usage Guide]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/guides/projects.md|Working with Projects]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/architecture.md|Architecture Overview]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/mcp-configuration.md|Advanced MCP Configuration]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/docs/developer/connectivity.md|Connectivity]]
  * [[https://github.com/agent0ai/agent-zero/blob/main/LICENSE|MIT License]]