النشر
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.
عام
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`.
التعريب
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.
المزوّدون
Which LLM providers are supported?
120+ cloud and local models via the LiteLLM router — including OpenAI, Anthropic, DeepSeek, OpenRouter, Google Vertex, and local runtimes.
الأمان
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.
السرب
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.
وجهاً لوجه
كاظمة مقابل أطر الوكلاء البديلة.
مقارنة تقنية للقدرات التي تهمّ في الإنتاج.
| القدرة | كاظمة | SDK عام | نمط الطاقم |
|---|---|---|---|
| بوابات موافقة بشرية ثلاثية | |||
| توقيعات مهارات مشفّرة (HMAC-SHA256) | |||
| تنفيذ دائم (تخزين نقاط SQLite) | |||
| عربي أولاً + طبقة Majlis الثقافية | |||
| تنسيق السرب (7 أنماط) | |||
| بوابة متعددة المنصات (TG/Discord/Slack/Web) | |||
| قواطع دوائر ذاتية الشفاء | |||
| واجهة مزدوجة (ويب + SSH/TUI) | |||
| مفتوح المصدر — رخصة MIT |