Nakama

Deploy your own AI Agent platform as easily as spinning up WordPress.

Documentation · Demo · Managed hosting

Nakama is a small, self-hosted Bun + TypeScript monorepo for running AI agents. Inspired by OpenClaw and Hermes Agent — same self-hosted agent idea (tools, channels, soul, automations) — but multi-tenant by design. Those projects target one operator on one machine; Nakama is one server, many orgs, with isolated profiles, sessions, member invites, and roles built in.

See ARCHITECTURE.md for system design, or the docs site for the full guide.

Open the live demo at https://demo.getnakama.cloud.

• Username: demo@getnakama.cloud
• Password: demo1234

The fastest way to try Nakama is Nakama Cloud. Create an account, provision an instance, complete the first-time setup wizard in the browser, and you are live — no Bun, Docker, or VPS required.

Requires Bun.

# Install dependencies
bun install

# Start the web (starts the server automatically if needed)
bun run dev:web

Visit web dashboard: http://localhost:3000

Or run the server on its own:

bun run dev:server

You can also run Nakama with Docker.

Prebuilt image (quickest):

# Pull and run the latest image
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

Build from source:

./scripts/docker-build-run.sh

Fresh start:

./scripts/docker-destroy.sh
./scripts/docker-build-run.sh

The dashboard will be available at http://localhost:4310.

Nakama integrates with Telegram, WhatsApp, and Composio (SaaS app connections). Enable them in the web app under Integrations.

For Composio, save your API key under Integrations → Composio (stored in ~/.nakama/composio/config.ini). Org admins connect OAuth apps on Integrations; assign toolkits per profile on Profiles.

On first run, the server prompts for a provider and API key if none is configured. Settings are saved to ~/.nakama/config.ini.

The server listens on http://127.0.0.1:4310 by default. Interactive API docs are available at http://127.0.0.1:4310/docs.

MIT