agent0ai/agent-zero

Agent Zero – 오픈소스 AI 에이전트 워크벤치

정의 – Agent Zero는 언어 모델 기반 에이전트에게 완전한 Linux 데스크톱 환경을 제공하는 Docker 기반 프레임워크입니다. 에이전트는 GUI 앱, 내장 브라우저, LibreOffice 편집기, 터미널을 조작할 수 있으며, Canvas라는 웹 UI를 통해 지켜보고 개입할 수 있습니다.

주요 구성 요소

• Linux 데스크톱(XFCE) 컨테이너 내부 – 에이전트는 모든 GUI 프로그램(예: Blender, VS Code, 터미널)을 열고 인간 사용자처럼 파일을 조작할 수 있습니다.
• DOM 주석이 있는 브라우저 – 요소를 클릭하여 검사, 수정, "리프트"(캡처)하거나 에이전트가 실행할 수 있는 주석을 남길 수 있습니다.
• 실시간 문서 공동 작업 – Markdown, ODT/ODS/ODP 편집기가 사용자와 에이전트 간에 실시간으로 공유됩니다.
• 플러그인 허브 – 스킬, 메모리 백엔드, 개발 프레임워크, UI 조정 등을 위한 100개 이상의 커뮤니티 플러그인.
• 프로젝트 및 메모리 – 작업별로 파일, 비밀, Git 저장소, 모델 사전 설정을 분리하는 격리된 작업 공간.
• A0 CLI 커넥터 – Docker화된 에이전트를 호스트 머신에 연결하는 경량 클라이언트로, 동일한 에이전트가 로컬 저장소를 편집하거나 호스트 측 도구를 실행할 수 있습니다.
• 멀티 에이전트 협력 – 에이전트는 하위 에이전트를 생성하여 전문화(연구, 코딩, 분석)하고 결과를 집계할 수 있습니다.
• 타임 트래블 스냅샷 – /a0/usr 작업 공간의 자동 버전 관리를 통해 쉬운 diff/롤백(Git의 보조).

설치

• A0 런처(GUI) – 플랫폼별 바이너리(macOS, Linux, Windows)를 다운로드하여 Docker 확인, 인스턴스 생성, 포트 관리를 처리합니다.
• A0 설치(스크립트) – 한 줄 curl/PowerShell 명령으로 Docker 컨테이너를 설정하고 선택적으로 빠른 시작 모드로 실행합니다.
• 직접 Docker 실행 – docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero 수동 제어용.

일반적인 워크플로우

1. 런처 또는 스크립트로 인스턴스를 시작합니다.
2. 웹 UI를 열고 LLM 제공자(OpenAI Codex, Gemini, Claude 등)를 구성합니다.
3. 프로젝트를 생성합니다(선택적으로 Git 저장소 복제). 에이전트는 이제 자체 격리된 파일 시스템을 갖습니다.
4. 에이전트에게 작업을 요청합니다 – 예: "Blender에서 3D 로고 디자인", "이 웹 페이지에 주석을 달고 히어로 컴포넌트를 React로 재구현", "예산 스프레드시트 작성".
5. Canvas 데스크톱 또는 브라우저에서 에이전트의 작업을 지켜보고, 입력, 클릭, 파일 직접 편집으로 개입합니다.
6. 플러그인이나 사용자 정의 스킬로 기능을 확장하거나, 더 큰 작업을 위해 하위 에이전트를 생성합니다.
7. 완료되면 작업 공간을 스냅샷하거나 타임 트래블로 롤백합니다.

사용 사례 하이라이트

• 소프트웨어 엔지니어링 – 에이전트는 감독 하에 코드베이스를 열고, 테스트를 실행하고, 파일을 편집하고, 변경 사항을 커밋할 수 있습니다.
• 디자인 및 UI 반복 – 경쟁사 사이트를 탐색하고, 요소에 주석을 달고, 에이전트가 일치하는 구성 요소를 생성하도록 합니다.
• 재무 분석 – 데이터를 수집하고, ODS 스프레드시트를 구축하고, 편집 가능한 차트를 생성합니다.
• 문서 제작 – 채팅을 떠나지 않고 Markdown, ODT 또는 프레젠테이션 파일을 공동 작성합니다.
• 자동화 및 오케스트레이션 – 정기적인 검사를 예약하고, A0 커넥터를 통해 호스트에서 CLI 도구를 실행하거나, 여러 전문 하위 에이전트를 연결합니다.

안전 참고 사항

• Docker(또는 다른 컨테이너) 내에서 실행하여 에이전트를 격리합니다.
• 호스트 디렉토리 마운트를 제한하고 필요한 곳에만 읽기/쓰기를 허용합니다.
• 자격 증명은 프롬프트가 아닌 프로젝트 비밀에 저장합니다.
• 프로덕션 시스템, 금전, 개인 데이터에 영향을 미치는 작업을 검토합니다.

더 알아보기

• 전체 문서: ./docs/(빠른 시작, 브라우저 가이드, 데스크톱 가이드, 플러그인, 메모리, MCP 등)
• 커뮤니티: Discord, YouTube 채널, Skool 커뮤니티, GitHub Issues.
• 오픈소스 코드 및 플러그인 허브는 GitHub의 agent0ai 조직에 있습니다.

결론 – Agent Zero는 LLM 에이전트가 실제 Linux 데스크톱 환경에서 작동할 수 있게 하는 포괄적이고 확장 가능한 플랫폼으로, 순수 텍스트 기반 채팅과 실질적인 소프트웨어 개발, 디자인, 데이터 작업 사이의 격차를 메웁니다.