# Nakama

> Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source. AI agents that work with your team.

Nakama is AI agents that work with your team. Each profile is an agent with its own role, soul, tools, and memory. Organizations, skills, MCP servers, and channels like web, CLI, Telegram, WhatsApp, and Discord let you run your nakama from one deployment — self-hosted, in Docker, or on managed hosting at https://getnakama.cloud/.

Maintainer: Ahmad Rosid (Creator and maintainer of Nakama)
Website: https://ahmadrosid.github.io/nakama/
Repository: https://github.com/ahmadrosid/nakama

## For AI agents

This file is the entry point for Nakama product documentation.
When a user asks about Nakama setup, behavior, integrations, or troubleshooting:
1. You are reading the index now, or fetch https://ahmadrosid.github.io/nakama/llms.txt if you do not have it yet.
2. Pick the best page from "Topic routing" or "Docs" below.
3. web_fetch the matching .md page (for example https://ahmadrosid.github.io/nakama/telegram.md).
4. Do not use knowledge_base_search for these URLs — that tool only searches uploaded profile documents.
5. Answer from the fetched page. Do not guess steps that are not in the docs.

Markdown mirrors use a `.md` suffix on the same path as the HTML docs.

## Topic routing

Match the user question to a page:

- install, run locally, dev server, first chat, quickstart, bun install, dev:web → [Quickstart](https://ahmadrosid.github.io/nakama/quickstart.md)
- Docker, docker run, container, production deploy, docker-build-run, NAKAMA_CONFIG_DIR volume → [Docker](https://ahmadrosid.github.io/nakama/docker.md)
- backup, restore, export zip, import zip, data root, NAKAMA_CONFIG_DIR → [Backup and restore](https://ahmadrosid.github.io/nakama/backup-restore.md)
- first-time setup, setup wizard, admin account, first organization, onboarding → [First-time setup](https://ahmadrosid.github.io/nakama/first-time-setup.md)
- LLM provider, API key, OpenAI, Anthropic, OpenRouter, Gemini, Ollama, Fireworks, model setup, config.ini → [Providers](https://ahmadrosid.github.io/nakama/providers.md)
- CLI, terminal, dev:cli, slash commands, bun run dev:cli, launch codex claude opencode → [CLI](https://ahmadrosid.github.io/nakama/cli.md)
- documentation hub, docs index, all pages → [Documentation](https://ahmadrosid.github.io/nakama/docs/index.md)
- getting started (legacy URL) → [Quickstart](https://ahmadrosid.github.io/nakama/quickstart.md)
- connect Telegram, Telegram bot, pairing, BotFather, dev:telegram, group chat → [Telegram](https://ahmadrosid.github.io/nakama/telegram.md)
- connect WhatsApp, WhatsApp linking, QR code, pairing code → [WhatsApp](https://ahmadrosid.github.io/nakama/whatsapp.md)
- connect Discord, Discord bot, pairing, slash commands, server channels → [Discord](https://ahmadrosid.github.io/nakama/discord.md)
- what is Nakama, mental model, organizations, profiles, tools, channels, managed hosting, deployment options → [Overview](https://ahmadrosid.github.io/nakama/overview.md)
- organizations, tenants, roles, members, invites, org admin, multi-tenant → [How Multi-tenancy Works](https://ahmadrosid.github.io/nakama/multi-tenancy.md)
- profiles, soul files, MEMORY.md, knowledge base, artifacts, bot behavior → [Profiles](https://ahmadrosid.github.io/nakama/profiles.md)
- system prompt, SOUL.md, how prompts are built, agent instructions → [How Agent Prompts Work](https://ahmadrosid.github.io/nakama/agent-prompt.md)
- builtin tools, read_file, write_file, write_docx, web_search, knowledge_base_search, email, bash, sub_agent → [Builtin Tools](https://ahmadrosid.github.io/nakama/builtin-tools.md)
- integrations page, channel settings, bridge workers, coding-agent settings, dashboard integrations → [Integrations](https://ahmadrosid.github.io/nakama/integrations.md)
- Composio, SaaS OAuth, external app tools, toolkit assignment → [Composio](https://ahmadrosid.github.io/nakama/composio.md)
- self-improving skills, write approval, skill proposals, agent workflows, manage-skills → [Self-improving Skills](https://ahmadrosid.github.io/nakama/self-improving-skills.md)
- skills, automations, memory skills, save-artifact, manage-skills → [Skills](https://ahmadrosid.github.io/nakama/skills.md)
- MCP servers, external tools, MCP integration → [MCP Servers](https://ahmadrosid.github.io/nakama/mcp.md)
- coding agent, Codex, Claude Code, OpenCode, dev:cli launch → [Coding Agent](https://ahmadrosid.github.io/nakama/coding-agent.md)
- agent-browser, browser automation, login wall, snapshot, bash browser, interactive web → [Agent Browser](https://ahmadrosid.github.io/nakama/agent-browser.md)
- sub-agent, sub_agent, delegation, research, review, planning → [Builtin Tools](https://ahmadrosid.github.io/nakama/builtin-tools.md)

## Docs — Start here

- [Documentation](https://ahmadrosid.github.io/nakama/docs/index.md): Documentation hub for Nakama — quickstart, deployment, concepts, channels, and reference.
- [Quickstart](https://ahmadrosid.github.io/nakama/quickstart.md): Install Nakama with Bun, Docker, or managed hosting and send your first chat message.
- [Overview](https://ahmadrosid.github.io/nakama/overview.md): Understand the Nakama mental model: organizations, profiles, tools, channels, and deployment options including managed hosting.
- [First-time setup](https://ahmadrosid.github.io/nakama/first-time-setup.md): Complete Nakama setup wizard: admin account, organization, provider, and profiles.
- [Providers](https://ahmadrosid.github.io/nakama/providers.md): Configure LLM providers, API keys, and models in Nakama Settings.

## Docs — Deploy

- [Docker](https://ahmadrosid.github.io/nakama/docker.md): Run Nakama in a single Docker container with persistent data volumes.
- [Backup and restore](https://ahmadrosid.github.io/nakama/backup-restore.md): Export and restore your Nakama data root with dashboard ZIP backup.

## Docs — Channels

- [CLI](https://ahmadrosid.github.io/nakama/cli.md): Use Nakama from the terminal — interactive chat, slash commands, and coding-agent launch.
- [WhatsApp](https://ahmadrosid.github.io/nakama/whatsapp.md): Set up Nakama on WhatsApp with linking, commands, and troubleshooting.
- [Discord](https://ahmadrosid.github.io/nakama/discord.md): Set up Nakama as a Discord bot with pairing, slash commands, and server behavior.

## Docs — Concepts

- [How Multi-tenancy Works](https://ahmadrosid.github.io/nakama/multi-tenancy.md): Learn how organizations, roles, and tenant isolation work in Nakama.
- [Org Memory](https://ahmadrosid.github.io/nakama/org-memory.md): Shared, admin-curated facts for an organization — injected into every profile prompt and distinct from per-profile MEMORY.md.
- [Self-improving Skills](https://ahmadrosid.github.io/nakama/self-improving-skills.md): Let agents save successful workflows as reusable skills, with optional org-admin approval before changes go live.
- [Profiles](https://ahmadrosid.github.io/nakama/profiles.md): See how Nakama profiles define bot behavior, soul files, memory, tools, and model selection.
- [How Agent Prompts Work](https://ahmadrosid.github.io/nakama/agent-prompt.md): Understand how Nakama builds the final system prompt from soul files, tools, bundled system skills, and runtime context.

## Docs — Extend

- [Builtin Tools](https://ahmadrosid.github.io/nakama/builtin-tools.md): Review the builtin tools that Nakama profiles can use, how access is controlled, and how memory, artifact, and document workflows use file tools plus bundled skills.
- [Skills](https://ahmadrosid.github.io/nakama/skills.md): Learn how reusable skills extend Nakama profiles, including bundled memory, artifact, automation, and skill-authoring workflows.
- [Self-improving Skills](https://ahmadrosid.github.io/nakama/self-improving-skills.md): Let agents save successful workflows as reusable skills, with optional org-admin approval before changes go live.
- [Integrations](https://ahmadrosid.github.io/nakama/integrations.md): See which dashboard integration sections manage channels, coding-agent harnesses, Composio, and related deployment settings.
- [Coding Agent](https://ahmadrosid.github.io/nakama/coding-agent.md): Launch Codex, Claude Code, or OpenCode from Nakama chat or the CLI, with optional provider passthrough from your Nakama LLM provider.
- [Agent Browser](https://ahmadrosid.github.io/nakama/agent-browser.md): Drive interactive, login-walled websites from Nakama chat or automations with the agent-browser skill and bash.
- [MCP Servers](https://ahmadrosid.github.io/nakama/mcp.md): Connect external MCP servers to Nakama profiles and expose new tools safely.
- [Composio](https://ahmadrosid.github.io/nakama/composio.md): Connect SaaS apps through Composio with org-scoped OAuth and profile toolkit assignment.

## All pages

- [Agent Browser](https://ahmadrosid.github.io/nakama/agent-browser.md): Drive interactive, login-walled websites from Nakama chat or automations with the agent-browser skill and bash.
- [How Agent Prompts Work](https://ahmadrosid.github.io/nakama/agent-prompt.md): Understand how Nakama builds the final system prompt from soul files, tools, bundled system skills, and runtime context.
- [Nakama](https://ahmadrosid.github.io/nakama/artifacts.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/automations.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Backup and restore](https://ahmadrosid.github.io/nakama/backup-restore.md): Export and restore your Nakama data root with dashboard ZIP backup.
- [Builtin Tools](https://ahmadrosid.github.io/nakama/builtin-tools.md): Review the builtin tools that Nakama profiles can use, how access is controlled, and how memory, artifact, and document workflows use file tools plus bundled skills.
- [Nakama](https://ahmadrosid.github.io/nakama/changelog.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [CLI](https://ahmadrosid.github.io/nakama/cli.md): Use Nakama from the terminal — interactive chat, slash commands, and coding-agent launch.
- [Coding Agent](https://ahmadrosid.github.io/nakama/coding-agent.md): Launch Codex, Claude Code, or OpenCode from Nakama chat or the CLI, with optional provider passthrough from your Nakama LLM provider.
- [Composio](https://ahmadrosid.github.io/nakama/composio.md): Connect SaaS apps through Composio with org-scoped OAuth and profile toolkit assignment.
- [Nakama](https://ahmadrosid.github.io/nakama/contributing.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Discord](https://ahmadrosid.github.io/nakama/discord.md): Set up Nakama as a Discord bot with pairing, slash commands, and server behavior.
- [Docker](https://ahmadrosid.github.io/nakama/docker.md): Run Nakama in a single Docker container with persistent data volumes.
- [Documentation](https://ahmadrosid.github.io/nakama/docs/index.md): Documentation hub for Nakama — quickstart, deployment, concepts, channels, and reference.
- [First-time setup](https://ahmadrosid.github.io/nakama/first-time-setup.md): Complete Nakama setup wizard: admin account, organization, provider, and profiles.
- [Nakama](https://ahmadrosid.github.io/nakama/image-generation.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Integrations](https://ahmadrosid.github.io/nakama/integrations.md): See which dashboard integration sections manage channels, coding-agent harnesses, Composio, and related deployment settings.
- [MCP Servers](https://ahmadrosid.github.io/nakama/mcp.md): Connect external MCP servers to Nakama profiles and expose new tools safely.
- [How Multi-tenancy Works](https://ahmadrosid.github.io/nakama/multi-tenancy.md): Learn how organizations, roles, and tenant isolation work in Nakama.
- [Org Memory](https://ahmadrosid.github.io/nakama/org-memory.md): Shared, admin-curated facts for an organization — injected into every profile prompt and distinct from per-profile MEMORY.md.
- [Overview](https://ahmadrosid.github.io/nakama/overview.md): Understand the Nakama mental model: organizations, profiles, tools, channels, and deployment options including managed hosting.
- [Profiles](https://ahmadrosid.github.io/nakama/profiles.md): See how Nakama profiles define bot behavior, soul files, memory, tools, and model selection.
- [Providers](https://ahmadrosid.github.io/nakama/providers.md): Configure LLM providers, API keys, and models in Nakama Settings.
- [Quickstart](https://ahmadrosid.github.io/nakama/quickstart.md): Install Nakama with Bun, Docker, or managed hosting and send your first chat message.
- [Self-improving Skills](https://ahmadrosid.github.io/nakama/self-improving-skills.md): Let agents save successful workflows as reusable skills, with optional org-admin approval before changes go live.
- [Skills](https://ahmadrosid.github.io/nakama/skills.md): Learn how reusable skills extend Nakama profiles, including bundled memory, artifact, automation, and skill-authoring workflows.
- [Nakama](https://ahmadrosid.github.io/nakama/tailscale.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/telegram/chat.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/telegram/index.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/telegram/notifications.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/telegram/troubleshooting.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [Nakama](https://ahmadrosid.github.io/nakama/token-optimiser.md): Nakama is AI agents that work with your team — self-hosted or on managed hosting at getnakama.cloud, multi-tenant, and open source.
- [WhatsApp](https://ahmadrosid.github.io/nakama/whatsapp.md): Set up Nakama on WhatsApp with linking, commands, and troubleshooting.
- [Getting Started](https://ahmadrosid.github.io/nakama/getting-started.md): Redirects to Quickstart — install Nakama and complete first-time setup.