
Nakama is a multi-tenant platform for teams of AI agents. Each profile is a bot with its own role, soul, tools, and memory — exposed through the web dashboard, CLI, Telegram, WhatsApp, or Discord from one deployment.

## Quick start

Pick the fastest path for you:

```bash
# Live demo — no install
# Open https://demo.getnakama.cloud
# Username: demo@getnakama.cloud
# Password: demo1234

# Managed hosting — your own instance (recommended)
# Sign up at https://getnakama.cloud/ and open your instance URL

# Docker — single container
docker pull ghcr.io/ahmadrosid/nakama:latest
docker run -d -p 4310:4310 -v nakama-data:/nakama/data --name nakama ghcr.io/ahmadrosid/nakama:latest

# Local development — from source
git clone https://github.com/ahmadrosid/nakama.git && cd nakama
bun install && bun run dev:web
```

Then open the dashboard, complete the setup wizard, and send your first message. See [Quickstart](/quickstart) for the full first-run flow.

## Start here

- [Quickstart](/quickstart) — try the demo, install, and send your first message
- [Overview](/overview) — organizations, profiles, tools, and channels
- [First-time setup](/first-time-setup) — admin account, org, provider, and profiles
- [Providers](/providers) — LLM API keys and model configuration

## Deploy

- [Quickstart](/quickstart) — demo, managed hosting, Docker, or local Bun
- [Docker](/docker) — production-style single-container deployment
- [Live demo](https://demo.getnakama.cloud) — shared instance (`demo@getnakama.cloud` / `demo1234`)
- [Managed hosting](https://getnakama.cloud/) — sign up and open your dedicated URL
- [Backup and restore](/backup-restore) — export and restore your Nakama data root

## Concepts

- [Multi-tenancy](/multi-tenancy) — organizations, members, roles, and tenant isolation
- [Org memory](/org-memory) — shared, admin-curated facts for the whole organization
- [Self-improving skills](/self-improving-skills) — agents save workflows as skills; optional admin approval
- [Profiles](/profiles) — soul files, memory, tools, and model selection
- [Artifacts and files](/artifacts): browse, preview, edit, and publish what your agent saves
- [Automations and tasks](/automations): scheduled prompts, run history, and channel delivery
- [Agent prompts](/agent-prompt) — how Nakama builds the system prompt each turn

## Channels

- [CLI](/cli) — terminal chat and slash commands
- [Telegram](/telegram) — bot setup, pairing, groups, and troubleshooting
- [WhatsApp](/whatsapp) — direct chat linking, groups, commands, and troubleshooting
- [Discord](/discord) — bot setup, pairing, slash commands, and servers

## Extend

- [Builtin tools](/builtin-tools) — file access, web search, email, bash, and more
- [Skills](/skills) — reusable workflows including memory, artifacts, and automations
- [Self-improving skills](/self-improving-skills) — agents save workflows as skills; optional admin approval
- [Integrations](/integrations) — dashboard settings for channels and external providers
- [Image generation](/image-generation): generate images with OpenAI gpt-image-2
- [Token optimiser](/token-optimiser): shorten long tool output and measure what it saves
- [Coding agent](/coding-agent) — Codex, Claude Code, OpenCode, pi, or Cursor Agent from chat
- [Agent browser](/agent-browser) — interactive browser automation for login-walled sites
- [MCP servers](/mcp) — connect external tool providers
- [Composio](/composio) — SaaS OAuth and toolkit assignment

## Community

- [Contributing](/contributing) — run from source, test, and open a pull request
- [Changelog](/changelog): what changed in each release, and how to read it
- [GitHub repository](https://github.com/ahmadrosid/nakama) — source code and issues

## Reference

- [llms.txt](/llms.txt) — documentation index for AI agents and tooling
- [GitHub repository](https://github.com/ahmadrosid/nakama) — source code and issues
