Rakazo AI Teammates
Run persistent AI teammates with your choice of models, integrations, and sandboxed computers.
Least privilege scores 1: CI uses contents: read and the product claims isolated private computers, but bots also receive browser, terminal, file, desktop, and delegation powers without supplied evidence of runtime privilege minimization. User confirmation scores 0 because no source shows mandatory approval before tool calls, integrations, or consequential actions. Data-flow transparency scores 2: the README identifies model, voice, sandbox, and connector providers and their credentials, but lacks field-level flows and retention rules. Sensitive-data handling scores 2: it requires independent strong secrets and states connector credentials are server-encrypted and never returned by the API, while implementation, rotation, and deletion details are absent. Dependency security scores 2 due to a pinned package manager, frozen-lockfile installs, read-only CI permissions, and private vulnerability reporting, with no shown audit automation, update policy, or SBOM. External effects score 1: external APIs, terminals, computers, and test-machine destruction are disclosed, but approval and containment controls for ordinary agent actions are not shown. Rollback scores 1: backup and upgrade documentation is referenced and desktop server changes preserve the previous selection when cancelled, but the guide is absent and there is no general undo mechanism. Source attribution scores 2 because repository, contributor, maintainer, security, and support identities are stated; the publisher remains unverified and full provenance is therefore not established.
Self-consistency scores 3: README commands, architecture, test layers, package scripts, and CI jobs align without visible contradictions. Dependency availability scores 2: Node, pnpm, Docker, database, and optional-provider requirements are explicit and several providers are supported, but offline guarantees and provider-outage behavior are not documented. Failure messages score 1: health validation, safe skipping of unconfigured canaries, and prerequisite checks are visible, while systematic user-facing diagnostics and recovery guidance are not.
Audience and scenarios score 2: self-hosting, web, desktop, mobile, shared/private computers, and multiple model providers cover ordinary scenarios, but user personas and selection guidance are limited. Capability boundaries score 2: features, test modes, external services, and security-policy exclusions are stated, though detailed bot prohibitions and permission boundaries are missing. Trigger precision scores 1 because routines, calls, delegation, and integrations are named without evidence of exact trigger rules, ambiguity handling, or false-trigger prevention. Environment fit scores 3: versions, full local operation, multiple clients, HTTPS/LAN constraints, and Docker, E2B, Daytona, and local-computer options are documented thoroughly.
Information architecture scores 3: features, setup, clients, development, tests, documentation, contribution paths, and monorepo directories are clearly organized. Install notes score 3 with exact prerequisites, environment setup, required secrets, migration, sandbox build, and launch commands. Naming stability scores 2: product, packages, and scripts are consistent and versioned 0.1.0, but beta status and absent compatibility commitments prevent full marks. Examples and FAQ score 2: runnable setup and provider-test examples plus desktop connection behavior are present, but there is no full FAQ or task-oriented usage catalog. Known limitations score 2: beta status, security exclusions, secret-gated live tests, and lack of a bounty are disclosed, though product limitations are incomplete. License scores 3 because metadata, README, and the complete Apache-2.0 text agree. Versioning and changelog score 1: a package version and latest-beta support concept exist, but no changelog or migration history is supplied. Maintenance responsibility scores 2: maintainer, security and support contacts, and supported branches/releases are stated; registry verification, response targets, and long-term commitments are absent.
Output usability scores 2: persistent conversations, memory, voice, history, and multiple clients suggest reusable results, but output schemas, export paths, and representative quality examples are not shown. Marginal value scores 2: selectable models and sandboxes, persistent bots, multi-client access, and broad integrations form a useful combination, without comparative evidence against alternatives. Cost-benefit scores 2: a fully local stack and optional managed catalogs are offered, and Treg metering is disclosed, but resource benchmarks, cost estimates, and default spending limits are absent.
Claim traceability scores 2: many operational claims map to named documents, commands, scripts, or workflows, but implementation files supporting key runtime-security claims are not included. Cross-source corroboration scores 3: README, license, package metadata, and workflows independently agree on licensing, versions, dependencies, scripts, and test structure. Fact-inference separation scores 2: required versus optional components, beta status, and third-party exclusions are generally explicit, but assertions such as isolation and credentials never being returned lack supplied implementation evidence and cannot receive full marks.
- Bots can access browsers, terminals, files, and graphical desktops; independently review runtime permissions, network egress, mounts, and action-confirmation controls before granting production access or real credentials.
- Claims that connector credentials are encrypted and never returned by the API, and that computers are isolated, are not verified by the supplied implementation code; review key management, encryption boundaries, and sandbox-escape defenses before deployment.
- The project is beta and promises fixes only for current main and the latest release; confirm backup, database migration, and rollback procedures before upgrading.
- Composio, Pipedream, model, voice, and sandbox providers add data flows, availability dependencies, and costs; review each provider's terms, retention policy, and budget controls.
- Unknown publisher identity is not evidence of malice, but enterprise adopters should independently verify maintainer identity, release signatures, and update channels.
What does this agent do, and when should you use it?
Rakazo is a beta-stage open-source platform for creating persistent AI teammates with separate conversations, memory, routines, and history. Users reach the same Rakazo API through a React 19 and Vite web interface, an Electron desktop client, or an Expo mobile app. Bots can work through browsers, terminals, files, and graphical desktops, then delegate tasks to peer bots or short-lived subagents. Its server stack includes Hono, oRPC, PostgreSQL, Prisma, and Graphile Worker, while computer execution can use Docker, E2B, Daytona, or a trusted local machine. Model credentials are supplied through Pi, and application connections can come from Composio, Pipedream Connect, Treg, remote MCP servers, or OpenAPI documents. The complete stack can be self-hosted locally.
A user creates a bot from the web, Electron, or Expo client and connects a supported model provider. The bot retains its own conversations, memory, routines, and history, and performs work on shared Team Computers or isolated Private computers. During a run it can use a browser, terminal, files, and a graphical desktop, as well as integrations supplied through Composio, Pipedream Connect, Treg, an HTTPS MCP server, or an OpenAPI JSON document. Bots can pass work to peer bots or create short-lived subagents, with services such as Graphile Worker supporting background execution. Voice mode can speak responses, accept dictation, and call a bot using the user's ElevenLabs, OpenAI, or Cartesia key.
- A team that wants control over its data and runtime can self-host Rakazo and assign persistent, history-aware bots to its members.
- An operations user with workflows spanning websites, command-line programs, files, and desktop applications can run a bot on a shared or isolated computer.
- A user who already has OpenRouter or another supported provider account can bring model credentials instead of accepting a single bundled model vendor.
- A multi-role team can create several persistent bots that delegate work to one another or launch temporary subagents.
- A user who prefers spoken interaction can configure ElevenLabs, OpenAI, or Cartesia for speech, dictation, and bot calls.
- A self-hosting operator that needs business-system access can connect Composio, Pipedream Connect, Treg, remote MCP, or OpenAPI tool sources.
What are this agent's strengths and limitations?
- The web, Electron, and Expo clients use the same API, providing multiple interfaces over one backend.
- Computer execution spans Docker, E2B, Daytona, and trusted local machines, with both shared Team Computers and isolated Private computers.
- The integration design avoids a single catalog or model path: Pi handles user-supplied model credentials, while tools can come from Composio, Pipedream, Treg, MCP, or OpenAPI.
- Persistent bots retain conversations, memory, routines, and history and can delegate to peers or temporary subagents.
- The documented test surface includes unit, integration, end-to-end, topology, live canary, and real vision-model desktop acceptance checks.
- Rakazo is explicitly in beta, so adopters should allow for changes to interfaces, deployment procedures, or stored data structures.
- Local setup is not a single-container install: it requires Node.js, pnpm, Docker Desktop, PostgreSQL startup, secret configuration, database generation and migration, and a sandbox build.
- A full deployment may incur separate charges for models, voice services, E2B, Daytona, Box, managed connector catalogs, or usage-metered Treg.
- Public servers used by the desktop client require HTTPS; plain HTTP is limited to loopback and private LAN addresses and excludes link-local addresses.
- Operators embedding Treg in a hosted product must account for integration terms requiring a written agreement for hosted resale.
How do you install or deploy this agent?
Prerequisites are Node.js 22+, pnpm 9, and Docker Desktop. Run:
git clone https://github.com/elie222/rakazo.git
cd rakazo
cp .env.example .envSet BETTER_AUTH_SECRET and ENCRYPTION_KEY in .env to separate long random values. You may also set OPENROUTER_API_KEY or connect a supported model provider during onboarding. Then run:
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 devComposio requires COMPOSIO_API_KEY. Pipedream Connect requires PIPEDREAM_CLIENT_ID, PIPEDREAM_CLIENT_SECRET, and PIPEDREAM_PROJECT_ID. Both managed catalogs are optional.
How do you use this agent?
After starting the development stack, open http://127.0.0.1:5173, create an account, connect a model, and create the first bot. To use the desktop client, keep the stack running and execute pnpm --filter @rakazo/desktop dev. On its first launch, select the local instance at http://127.0.0.1:5173 or an existing server; public servers must use HTTPS. The Integrations screen can accept an HTTPS MCP server, Treg endpoint, or OpenAPI JSON document without either managed catalog. For development automation, RAKAZO_WEB_URL temporarily selects another server, while RAKAZO_FORCE_SETUP=1 reruns desktop setup.
How does this agent compare with similar options?
The repository describes Rakazo as an open-source Grok Bot alternative. Its stated distinction is that users can choose their own model and computer provider and self-host the complete stack; the supplied material does not include benchmark, feature-parity, or cost comparisons.