FAQ
Frequently asked.
Everything you need to evaluate Kazma for production. Can't find an answer? Open an issue.
Deployment
What platforms are supported?
Linux, macOS, Windows, Docker, and WSL. Deploy with a single `docker compose up` — 2 volumes, graceful shutdown, no OS-specific code.
Where is data stored?
All user state lives under `~/.kazma/`; databases in `kazma-data/`. Every path is overridable via config or env vars — no hardcoded paths.
General
What is Kazma?
An open-source framework for building reliable, culturally-aware AI agents. Built on LangGraph with SQLite checkpointing, it survives crashes, remembers across sessions, and enforces safety boundaries — with a multi-platform gateway, RAG memory, and human-in-the-loop safety.
How do I get started?
Clone the repo, run `uv sync`, then launch `kazma-web` (Web UI), `kazma-tui` (Terminal), or `kazma` (CLI). Windows users can run `.\setup.ps1`.
Localization
Does Kazma support Arabic?
Yes — Kazma is built with native Arabic support. It handles MSA and Gulf dialects with a Majlis Mode protocol for Gulf cultural context, plus a full bilingual UI.
Providers
Which LLM providers are supported?
120+ cloud and local models via the LiteLLM router — including OpenAI, Anthropic, DeepSeek, OpenRouter, Google Vertex, and local runtimes.
Security
How are dangerous actions controlled?
Triple-wired human-in-the-loop gates intercept dangerous operations at the graph, swarm bus, and MCP layers. Danger tools require human approval on Web, Telegram, Discord, and Slack, and are fail-closed by default.
Swarm
How does swarm orchestration work?
Seven patterns: dispatch, broadcast, pipeline, fan-out, consult (independent opinions + synthesis), conditional (router-based), and auto (capability-based) — with RetryPolicy, CircuitBreaker, and OutputValidator.
Head to head
Kazma vs. alternative agent frameworks.
A technical comparison of the capabilities that matter in production.
| Capability | Kazma | Generic SDK | Crew-style |
|---|---|---|---|
| Triple-wired HITL safety gates | |||
| Cryptographic skill checksums (HMAC-SHA256) | |||
| Durable execution (SQLite checkpointing) | |||
| Arabic-first + Majlis Mode cultural layer | |||
| Swarm orchestration (7 patterns) | |||
| Multi-platform gateway (TG/Discord/Slack/Web) | |||
| Self-healing circuit breakers | |||
| Dual UI (Web DAG + SSH/TUI) | |||
| Open source — MIT licensed |