Agent Zero BMAD K8s

Deploy a full AI agile development team on Kubernetes in minutes.

What is BMAD K8s?

Agent Zero BMAD K8s deploys 9 specialized AI agents as a collaborative agile development team, running on Kubernetes (K3s) or Docker Compose. Each agent has a distinct persona, role, and tuned parameters — from a creative Analyst to a precise QA Engineer.

The agents communicate through Agent Zero's A2A protocol and are orchestrated by a central BMAD Orchestrator that tracks project phases, routes tasks, and enforces quality gates.

Key Features

• 9 Specialized Agents — Orchestrator, Analyst, PM, Architect, UX, Product Owner, Scrum Master, Developer, QA
• BMAD Method — Structured 4-phase workflow: Analysis → Planning → Solutioning → Implementation
• GMeet Dashboard (6 Tabs) — Meet, Dashboard, Config, Projects, Diary, Deploy — a full control plane for your agent team
• 🧠 Brain Viewer — Real-time SSE streaming of agent thinking: tool calls, reasoning, code execution, subagent delegation — with snapshot & share
• Markdown Transcript — Agent responses render with full markdown: code blocks, tables, lists, headings
• Live Monitoring — Agent health, response times, container CPU/memory stats, auto-refreshing dashboard
• In-Browser Config — Edit API keys, model settings, per-agent temperature without SSH
• Container Management — Start, stop, restart Docker containers and view logs from the Deploy tab
• Agent Diary — Shared activity feed with ping system, status snapshots, and filterable logs
• One-Line Installer — Deploy on any Linux server with a single curl command
• Kubernetes Native — Full K8s manifests with ConfigMaps, Secrets, PVCs, and Ingress
• OpenRouter Integration — Use any model (Kimi K2.5, Gemini Flash, Claude, GPT-4o, etc.)
• CI/CD — GitHub Actions for linting, validation, and build checks

Architecture Overview

┌──────────────────────────────────────────────────┐
│                 GMeet Frontend                    │
│           (React + Tailwind + Zustand)            │
└──────────────┬────────────────────┬───────────────┘
               │ REST API           │ WebSocket
┌──────────────▼────────────────────▼───────────────┐
│               GMeet Backend                       │
│          (Express + WS on ports 4000/4001)        │
└──┬───────┬───────┬───────┬───────┬────────────────┘
   │       │       │       │       │  X-API-KEY auth
┌──▼──┐ ┌──▼──┐ ┌──▼──┐ ┌──▼──┐ ┌──▼──┐
│BMAD │ │Mary │ │John │ │Fred │ │Dana │  ... (+4 more)
│:5001│ │:5002│ │:5003│ │:5004│ │:5005│
└─────┘ └─────┘ └─────┘ └─────┘ └─────┘
  Agent Zero instances (Docker / K8s pods)

Quick Start

One-Line Install (K3s)

curl -sfL https://k8.virtualgpt.cloud/install.sh | bash

This installs K3s, clones the repo, prompts for your OpenRouter API key, creates Kubernetes secrets, and deploys all 9 agents.

Docker Compose (Local Dev)

git clone https://github.com/t4tarzan/agent0-bmad-k8.git
cd agent0-bmad-k8
cp .env.example .env.live   # add your API keys
docker compose -f docker-compose.live.yml up -d

Next Steps

• Agent Profiles — Learn about each agent's role and capabilities
• BMAD Method — Understand the 4-phase workflow
• Deployment Guide — Detailed K3s and Kubernetes setup
• GMeet Dashboard — 6-tab control plane: Meet, Dashboard, Config, Projects, Diary, Deploy
• 🧠 Brain Viewer — Real-time agent thinking with SSE log streaming, snapshots & sharing
• API Reference — All backend endpoints including Brain, Diary, Deploy, and WebSocket