elie222/rakazo

English | 简体中文 | 日本語
Rakazo is an open source AI agent for persistent teammates, and a self-hosted AI assistant you
can run on your own machine. It is available on the web, as an Electron desktop app, and on
iPhone and Android. Bring your own model
and computer provider, or run the complete stack locally.
It is an open source, self-hosted alternative to Grok Bot, Meta Muse, OpenAI Dots, Instinct,
OpenClaw, Hermes Agent, and Claude Duet.
Rakazo is in beta. Learn more at rakazo.com.
## Features
Persistent bots with their own conversations, memory, routines, and history
Voice mode: speak replies, dictate, and call a bot. Bring your own ElevenLabs, OpenAI, Cartesia, or Fish Audio key
Shared Team Computers and isolated Private computers
Browser, terminal, file, and graphical desktop access
Bots that can delegate to peer bots or short-lived subagents
Bring-your-own model credentials through Pi
App integrations through Composio or Pipedream Connect, plus user-installed Treg, remote MCP, and OpenAPI tool sources
Docker, E2B, Daytona, CreateOS, Boat, and trusted local-computer support
## Demo
https://github.com/user-attachments/assets/dccdeddb-2134-4a56-8eed-b2e591736b1c
## Thanks
PromptLayer
Inbox Zero
CodeRabbit
Greptile
Snyk
## Stack
TypeScript
React 19, Vite, and Tailwind CSS
Electron and Expo
Hono and oRPC
PostgreSQL and Prisma
Better Auth
Graphile Worker
Pi
Docker, E2B, Daytona, CreateOS, and Boat
Composio, Pipedream Connect, MCP, and OpenAPI integrations
## Quick start (published images)
You need Docker Engine, the Compose plugin, curl, and OpenSSL. No clone or Node install.
bash
mkdir -p rakazo && cd rakazo &&
curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh &&
bash install-images.sh
The installer downloads the Compose files, creates .env with random secrets, and starts Rakazo.
It preserves an existing .env when rerun.
Open http://127.0.0.1:5173, create an account, and connect a model.
Local Docker computers are on by default. Optional remote providers: e2b, daytona, createos, boat, or railway
with the matching API key.
Default image tag is edge (main builds, linux/amd64 + linux/arm64). Details and tags:
self-hosting guide.
On restricted networks, override the installer download base (RAKAZODOWNLOADBASE), skip
existing Compose files (--local / RAKAZODOWNLOADSKIPEXISTING), or mirror the bootstrap
script URL — see
Restricted networks / mirror downloads.
For an agent-assisted install, use SETUPPROMPT.md.
## Run on a server
Bots stay on when the backend runs on a server. Use the same installer on a VPS, then connect from
the desktop app, the mobile app, or a browser.
bash
bash install-images.sh --prepare-only
# edit .env: SANDBOXPROVIDER=boat (or e2b / daytona / createos) with its API key, RAKAZOHOST=your.domain
bash install-images.sh
Put HTTPS in front of port 5173; docs/self-host.md
covers the Caddy setup and host hardening. In the desktop app choose Existing instance and enter
the https:// address.
Or deploy on Railway; see the Railway setup guide.
## Local development (source checkout)
You need Node.js 22.22.2 or newer in the 22.x line, Node.js 24.x, or Node.js 26+;
pnpm 9; and Docker. Node.js 23.x and 25.x are not supported.