Skip to content
v0.4.0 · Production ready · Open source

Deploy Agent Swarms with Zero-Trust Security.

Kazma is the multi-agent coordinator engineered for production. Secure your workspace with cryptographic skill signatures, triple-wired human-in-the-loop gates, and real-time telemetry across Web, Telegram, Slack, and Discord.

114,010 (77%)
Lines of code
pure code, verified
3,464
Test functions
across 201 files
695
Commits
git history
12
Contributors
and growing
Lines of code by package
kazma-core 45,275
kazma-gateway 12,241
kazma-ui 11,473
kazma-tui 9,037
kazma-memory 777
kazma-skills 1,590
kazma-cli 2,926

Verified 2026-07-10 · 77858fb fix: add all 15 slash commands to TUI autocomplete + help (2026-07-10) — figures derived from git-tracked files via scripts/generate_metrics.py

Kazma dashboard — live telemetry, swarm workers, and circuit breakers
Swarm researcher 92% writer 78% reviewer 100% 14,800 tok/s

The Kazma Web UI — FastAPI dashboard with live SSE telemetry.

Built on a production stack

LangGraph ChromaDB FastAPI SQLite Docker LiteLLM OpenTelemetry NetworkX Pagefind LangGraph ChromaDB FastAPI SQLite Docker LiteLLM OpenTelemetry NetworkX Pagefind

Secured by design

Guarded by humans, hardened by cryptography.

Never let an LLM run unsafe code or modify production files unsupervised. Kazma intercepts dangerous operations fail-closed at three layers.

Triple-Wired HITL Safety Gates

Three-tier approval gates — graph interrupt, swarm bus, and MCP classification. Danger tools require human approval across Web, Telegram, Discord, and Slack. State is tracked atomically; operations resume exactly where they paused.

Cryptographic Skill Checksums

Every downloaded skill and plugin is validated against a timing-safe HMAC-SHA256 checksum matching your secret. Altered signatures trigger an immediate fail-closed abort.

Authenticated MCP Servers

Bearer tokens, custom headers, and configurable trust tiers. Every MCP tool is classified by risk for appropriate gating.

Self-Healing Circuit Breakers

Real-time status badges — red, yellow, hidden. Automatic recovery with configurable thresholds. Start, stop, cancel, retry with lineage tracking.

Multi-Platform Approvals

Interactive sliding cards over live SSE in the Web client. Inline buttons in Telegram, Discord, and Slack. Approve or deny from any surface.

Idempotent DB Sync & WAL

SQLite WAL mode with a 5000ms busy timeout ensures concurrent multi-user TUI/Web write safety. reconcile_from_yaml() seeds keys without clobbering overrides.

Live telemetry · mock stream
Token throughput
0 tok/s
Active agents
0
p95 response
0 ms
Swarm patterns
0

SSH command console

The dual-command center.

Monitor and command your swarm directly over lightweight SSH sessions or terminal panels. Track multi-step workflows without screen corruption — Kazma isolates complex Mermaid.js rendering to explicit DOM nodes, neutralizing style leakage.

  • Scrolling metrics sparklines. Real-time CPU, Memory, and VRAM history inside your terminal.
  • Vim-style console bar. Activate with : to jump tabs, reload themes, clear caches.
  • ASCII NOC topology map. Inter-node comms and live handoff paths across the swarm.
  • Bi-lingual RTL mirroring. Perfect layout alignment for Arabic-first environments.
kazma-tui · ssh connected
Kazma TUI dashboard — live metrics, swarm topology, and sparklines in the terminal
Kazma TUI Chat view
Kazma TUI Files view
Kazma TUI Settings view
Kazma TUI Swarms view
Kazma TUI Traces view

Zero to autonomous in three steps.

Clone, configure, deploy — three entry points for every workflow.

01

Install & configure

Clone the repo, run uv sync, point at your LLM provider. Web UI, TUI, or CLI — your choice.

02

Connect channels

Plug in Telegram, Discord, or Slack via the headless gateway. One backend, many adapters.

03

Deploy & monitor

Pick a persona, enable RAG, set safety gates, spawn swarm workers. Watch it live via SSE.

The product

One brain, every surface.

A single LangGraph supervisor drives the dashboard, chat, swarm playground, skills, and MCP servers — bilingual, RTL-ready, live.

Kazma Workspace

Workspace

Projects, rules, and context per workspace.

Kazma Chat

Chat

Streaming agent chat with HITL approval cards.

Kazma Swarm Playground

Swarm Playground

Dispatch patterns with live aggregation.

Kazma Skills

Skills

Signed, validated skill registry.

Kazma MCP Servers

MCP Servers

Authenticated external tool servers.

Kazma LLM Providers

LLM Providers

120+ models via one OpenAI-compatible layer.

The origin

What does “Kazma” mean?

A name rooted in Kuwaiti history — and engineered into architecture.

Kazma (كاظمة) was an ancient coastal region in Kuwait — famed as a vital oasis network of water wells and a strategic trade gateway connecting distinct civilizations. It was also the site of the legendary Battle of Chains (Dhat al-Salasil, 633 CE), where strict, unified coordination broke a rigid defensive line through precise, decentralized maneuvering.

We engineered Kazma.ai on these same legacy pillars — not as metaphor, but as architecture:

The Wells

Deep memory that holds context across sessions — the agent draws from it when it needs to remember, like caravans drawing from oasis wells.

The Gateway

One LangGraph supervisor routed out to many channels — Telegram, Discord, Slack, Web — the way Kazma routed trade between regions.

The Chains

Every skill is HMAC-signed and every dangerous action passes through three human-in-the-loop gates — coordination chains that can’t be quietly broken.

Architecture

Three pillars of production-grade orchestration.

Immutable security, triple-wired HITL gates, and self-healing dual-UI telemetry — layered, decoupled, and independently replaceable.

kazma-ui

Web DAG · SSE telemetry

FastAPI dashboard — chat, swarm panel, circuit breakers, lineage, bilingual RTL.

kazma-tui

Terminal UI · dual-palette

Lightweight SSH console. Scrolling metrics sparklines and ASCII NOC topology.

kazma-cli

Command line · scriptable

Unified control plane — banner, status, hub, gateway, and swarm management.

kazma-core ReAct supervisor · SQLite checkpointing · safety · MCP bridge gateway TG · Discord · Slack · memory FTS5 · vectors · providers LiteLLM router

Ship in under a minute.

Initialize, start the coordinator, launch the corporate terminal console.

~/kazma — bash
# Clone & install
$git clone https://github.com/Mubder/kazma && cd kazma
$uv sync --all-extras
# Web coordinator
$kazma serve
# Terminal UI
$kazma-tui

Ready to ship reliable agents?

Clone, install, and deploy in under a minute. Free, open-source, MIT licensed.