One LangGraph brain. Human approval before writes and shell. When the model dies you see ⚠️ — not a made-up answer. Web, TUI, CLI, Telegram, Discord, Slack. Full English and Arabic UI; Gulf greetings are a short-circuit, not a dialect model.
HITL pause — one interrupt, one approval card
Agent requested dangerous tool: file_write(path="src/router.py").
Turn Execution Steps
Project Age counts from the first line of code; the public repos begin later — kazma's first commit is June 20, 2026 — because early development was local and on since-archived repos.
Swarms, bi-temporal chat memory, and three-path human approval. When the model dies you see a warning, not a made-up answer.
Beliefs are stored with two clocks: when they were asserted, and the interval they are valid for (valid_from / valid_until).
Every mutating action is intercepted across 3 execution paths and arbitrated by a central SQLite gate registry (hitl_gates.db):
A strict policy gate between the LLM and durable state. Intent is resolved against stored memory before executing actions, preventing hallucinated overwrites.
The kazma_core/ide subsystem provides a unified engine for file trees, CodeMirror editing, git diffing, and pytest execution across the Web dashboard, Terminal UI (TUI), and chat channels.
A failed LLM call sets turn_failed and skips synthesis. Transient errors retry; permanent ones fail fast. Provider failover is a chain you configure, not magic.
Every surface ships in English and Arabic — UI, docs, and generated documents — with per-request RTL. Gulf greetings short-circuit; they are not a dialect model.
Six dispatch patterns (dispatch, broadcast, pipeline, fan-out, consult, conditional). A worker autoscaler fires only when a task asks for workers=["auto"] and no capable worker is registered.
6 battle-tested dispatch patterns built directly into the LangGraph supervisor core.
Dispatches identical or partitioned tasks across multiple isolated workers simultaneously, aggregating outputs via weighted voting or consensus deduplication.
Execution Flow Nodes
These aren't products “powered by” Kazma as a runtime stack — they grew up next to it. Each one taught us something about agents, trust, and real interfaces, and that craft shaped the framework in return.
A portable personal vault for secrets, API keys, tokens, and notes. Auto-extracts multiple values from a single paste, organizes scattered credentials, and answers queries in English and Arabic. Works fully offline (Ollama) or cloud (Gemini).
A conversational commerce intelligence engine — unifies entire commerce operations across WhatsApp, Instagram, Email, and Web. Catalog browsing, price bargaining, payment links, courier dispatch, order tracking, returns, and fraud screening — all in Khaleeji Arabic with full GCC data sovereignty.
A unified executive command center — a real-time dashboard that brings multi-departmental operations, smart task delegation, company metrics, and integration bridges into one cockpit. Auto-converts business events into assigned tasks with progress tracking and a bidirectional Arabic/English interface.
One path below. On Windows, .\setup.ps1 then kazma serve is the operator path. No cloud account required.
git clone https://github.com/Mubder/kazma && cd kazma uv sync --all-extras kazma serve kazma-tui