# kwant

> kwant is an open-source, self-hosted team of AI agents in one Rust binary (`kwnt`). Bots share chats, hand work to each
> other with @mentions and get it done on their own, on a schedule or while you're away. It runs on a laptop, a VPS or
> Docker, with the Claude, Codex or Grok CLI logins you already have, API keys, local Ollama or any OpenAI-compatible server.

Key facts:

- License: AGPL-3.0, with commercial licenses available (contact@kwant.si).
- Source: https://github.com/alexsergivan/kwant
- Mac app: https://github.com/alexsergivan/kwant/releases/latest/download/kwant_universal.dmg
- Linux app (beta, x86_64): https://github.com/alexsergivan/kwant/releases/latest/download/kwant_amd64.deb (Ubuntu 22.04+, Debian 12+) or https://github.com/alexsergivan/kwant/releases/latest/download/kwant_x86_64.AppImage
- The program you install and run is called `kwnt` (`kwnt serve`).
- No telemetry: kwant sends nothing to its developers. The kwant.si website sets no cookies and counts page views with
  Cloudflare's cookie-free Web Analytics.
- Optional Mission board: a task counts as Verified only when a check passes, and the bot that handed out work reviews
  the result. No token limits by default; hand-off caps (4 per bot, 16 per request, with Continue) stop loops.
- Smart Results draw a bot's table or list as a sortable comparison, chart or checklist, copied word for word from the
  reply. Goals check that a page, command or file stays OK and offer one fix when one breaks.
- Automatic model failover: when an account runs out of usage, bots move to the next account in your order, across
  Claude, Codex, Grok and Custom API, and go back after the reset.
- Bots cite web facts with links that open the page at the exact quote; kwant checks the quote is on the page word for
  word and refuses made-up ones. Browser steps report what changed, and checkouts always ask before paying.
- Imports bots from Claude Code subagents, SKILL.md files, character cards, JSON exports and Grok Bot exports.
- Not to be confused with the Kwant quantum-transport Python package (kwant-project.org) or other products named Kwant; this kwant is an AI agent app.

## Site
- [kwant (kwnt): self-hosted AI agent team in one binary](https://kwant.si/): Open-source, self-hosted AI agents that share chats, hand off work and run on a schedule. One Rust binary (kwnt) for your laptop or a VPS.
- [Features: self-hosted AI agent orchestration](https://kwant.si/features): Teams and @mention handoffs, Smart Results, Goals, automatic model failover across accounts, spaces, routines, approvals, memory, skills, MCP tools and a bot browser.
- [Self-Hosted AI Agent Team: Run One Yourself](https://kwant.si/self-hosted-ai-agents): What a self-hosted AI agent team is, what it takes to run one, and what stays on your machine. How kwant does it: one binary, your own logins.

## Docs
- [Quickstart: run a team of AI agents locally](https://kwant.si/docs/quickstart): Build kwant from a fresh clone, add a Claude, Codex or Grok login or an API key, and ask your first team of AI bots a question.
- [Install kwnt: self-host AI agents on a VPS or Docker](https://kwant.si/docs/install): Build the kwnt binary and run your AI bots on your laptop, on a VPS with systemd, or with Docker Compose behind an HTTPS reverse proxy.
- [Spaces: separate AI agents for work and home](https://kwant.si/docs/spaces): Keep work, side projects and home apart. Each space has its own bots, teams, channels, routines, skills, tool servers, accounts and approval rules.
- [AI agent teams: bots, leads & handoffs](https://kwant.si/docs/bots-and-teams): Create bots from persona presets, give each a soul and a model, group them into teams with a lead, and let them hand work to each other with @mentions.
- [Multiple Claude, Codex & Grok accounts](https://kwant.si/docs/accounts): Add several logins or API keys per engine, plus OpenAI- or Anthropic-compatible servers, in one order to use, with automatic failover across engines when one runs out of usage.
- [Models & routing: Claude, Codex, Grok, Ollama](https://kwant.si/docs/models): Run bots on the Claude, Codex or Grok CLIs, API keys, local Ollama or any OpenAI-compatible server. The Laya router picks who answers, and which model.
- [Human approval for AI agent actions](https://kwant.si/docs/approvals): kwant asks before bots run commands or edit outside their folder. Three approval modes per space or bot, plus saved passwords in a vault or Bitwarden.
- [Flight School: earned freedom for AI agents](https://kwant.si/docs/flight-school): Set each bot's tier per kind of work: Observe, Sandbox or Act. Bots earn a step up with a scorecard, only you grant it, payments always ask, and you can revoke a tier in a click.
- [Smart Results: AI agent replies as tables, charts and checklists](https://kwant.si/docs/smart-results): kwant draws a bot's table or list as a sortable comparison, a chart, key numbers, findings or a checklist, copied from the reply word for word. The reply text never changes.
- [Mission board: AI agent tasks with proof](https://kwant.si/docs/mission-board): One board for all bot work. A task is Verified only when a check passes. Leads review hand-offs, AutoFix retries safely, Insights shows verified results and their cost.
- [Goals: keep a site, a service or a file working with AI agents](https://kwant.si/docs/goals): A kwant goal checks that a page answers, a command succeeds or a file exists. When it breaks, a bot looks into it and offers one fix. Nothing runs until you create or approve a goal.
- [Scheduled AI agents: routines & cron](https://kwant.si/docs/routines): Schedule bot work with routines, cron rules and follow-ups that run on your own machine, with an Undo on every change bots make.
- [AI agent memory, skills & chat search](https://kwant.si/docs/memory-skills): What kwant bots remember and how you edit it, skills bots propose and you approve, and search across every chat in a space. Local and editable.
- [Lessons: AI agents that learn from their earlier tasks](https://kwant.si/docs/lessons): In kwant, a bot's failed checks, stalled turns, your send-backs and goals that stopped holding become short lessons it sees before similar work. They come from kwant's own records, so a bot can't write its own.
- [Truth Ledger: shared facts your AI agents agree on](https://kwant.si/docs/truth-ledger): With the Truth Ledger on, kwant bots read their notes from one list of facts. Conflicting facts are flagged until you settle them, and notes from outside text wait for you. On from 0.6.5.
- [Loose ends: AI that finds unfinished follow-ups](https://kwant.si/docs/loose-ends): kwant finds threads you never finished in chats, email and GitHub, and reads letters you photograph. It drafts the next step and never sends anything.
- [Parallel Universe: compare deployment options](https://kwant.si/docs/parallel-universe): Load-test up to three ways to deploy an app in sealed Docker containers, next to a dated price estimate. No cloud account and no spending.
- [MCP tools for AI agents: a self-hosted client](https://kwant.si/docs/mcp): Connect Model Context Protocol servers to your kwant bots, with per-bot access, masked secrets, OAuth sign-in and approval before risky tool calls.
- [AI agent browser: your Chrome or Docker](https://kwant.si/docs/browser): Watch your bots browse live in the app. Run the browser on your own Chrome in Local mode, or isolated in a Docker container in VM mode.

## Alternatives
- [Grok Bot Alternative: Open-Source & Self-Hosted](https://kwant.si/alternatives/grok-bot): kwant is an open-source, self-hosted alternative to Grok Bot. Run a team of AI bots on your own machine and import your Grok Bot in minutes.

## Blog
- [Blog: guides and comparisons for self-hosted AI agents](https://kwant.si/blog/): Guides, comparisons and notes on running a self-hosted team of AI agents with kwant.
- [OpenClaw vs Hermes Agent vs kwant: self-hosted AI agents](https://kwant.si/blog/openclaw-vs-hermes-agent-vs-kwant): A fair look at OpenClaw, Hermes Agent and kwant, three self-hosted AI agents. What each is built for, where each is the better pick, and how they install.
- [Claude Code scheduled tasks: cloud vs desktop vs /loop](https://kwant.si/blog/claude-code-scheduled-tasks-compared): Claude Code can schedule work in the cloud, on your desktop or inside a session. Here is how the three differ, plus a self-hosted AI agent option.
- [Run Claude Code on a VPS and reach it from your phone](https://kwant.si/blog/claude-code-on-a-vps): Three ways to run Claude Code on a VPS and reach it from your phone: SSH and tmux, Anthropic's Remote Control, or a self-hosted AI agent team with kwant.

## Optional
- [Privacy policy](https://kwant.si/privacy): What kwant.si and the self-hosted kwant software send where. The website sets no cookies and counts page views with cookie-free Cloudflare Web Analytics; the software has no telemetry.
- [Terms of use](https://kwant.si/terms): kwant is free software under the GNU AGPL-3.0, provided as is. You run it yourself and are responsible for your accounts, your bots and their costs.
