elie222/rakazo

# Rakazo

[](https://github.com/elie222/rakazo/stargazers)

[](https://discord.gg/RWwKa2Sn7h)

Rakazo is an open-source platform for running persistent AI teammates. It is available on the web,

as an Electron desktop app, and through an Expo mobile app. Bring your own model and computer

provider, or run the complete stack locally.

Rakazo is in beta. Learn more at [rakazo.com](https://rakazo.com).

## Features

## Demo

https://github.com/user-attachments/assets/dccdeddb-2134-4a56-8eed-b2e591736b1c

## Stack

## Quick start (published images)

You need Docker Engine, the Compose plugin, curl, and OpenSSL. No clone or Node install.

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](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, or box

with the matching API key.

Default image tag is edge (main builds, linux/amd64 + linux/arm64). Details and tags:

[self-hosting guide](./docs/self-host.md#published-images-no-checkout).

On restricted networks, override the installer download base (RAKAZO_DOWNLOAD_BASE), skip

existing Compose files (--local / RAKAZO_DOWNLOAD_SKIP_EXISTING), or mirror the bootstrap

script URL — see

[Restricted networks / mirror downloads](./docs/self-host.md#restricted-networks--mirror-downloads).

For an agent-assisted install, use [SETUP_PROMPT.md](./SETUP_PROMPT.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 install-images.sh --prepare-only
# edit .env: SANDBOX_PROVIDER=box (or e2b / daytona) with its API key, RAKAZO_HOST=your.domain
bash install-images.sh

Put HTTPS in front of port 5173; [docs/self-host.md](./docs/self-host.md#public-single-vm-deployment)

covers the Caddy setup and host hardening. In the desktop app choose Existing instance and enter

the https:// address.

## 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.

git clone https://github.com/elie222/rakazo.git
cd rakazo
cp .env.example .env

Set BETTER_AUTH_SECRET, ENCRYPTION_KEY, and SCREEN_PROXY_SECRET in .env to independent

long random values. Docker sandboxes also need a dedicated SANDBOX_SUPERVISOR_TOKEN. You can

also set OPENROUTER_API_KEY, or connect a supported model provider during onboarding.

Managed app catalogs are optional. Set COMPOSIO_API_KEY for Composio, or the

PIPEDREAM_CLIENT_ID, PIPEDREAM_CLIENT_SECRET, and PIPEDREAM_PROJECT_ID trio for Pipedream

Connect. Users can add an HTTPS MCP server, Treg endpoint, or OpenAPI JSON document from

Integrations without enabling either managed catalog. Connector credentials are encrypted on the

server and are never returned by the API.

Treg is usage-metered. Self-hosters supply their own Treg token; operators embedding Treg in a

hosted product should review [Treg's integration terms](https://treg.to/integrate.md), which require

a written agreement for hosted resale.

docker compose --env-file .env -f infra/compose/docker-compose.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:build
pnpm dev

Open [http://127.0.0.1:5173](http://127.0.0.1:5173), create an account, connect a model, and create

your first bot.

For deployment, provider selection, backups, and upgrades, see the

[self-hosting guide](./docs/self-host.md).

## Desktop and mobile

The Electron and Expo apps are clients of the same Rakazo API used by the web app.

With the development stack running, launch Electron with:

pnpm --filter @rakazo/desktop dev