Rakazo：可自托管的 AI 队友

项目简介

Rakazo 是一个开源 AI Agent，定位是「真正属于你自己的 AI 队友」。它既能作为自托管 AI 助手跑在自己的机器上，也可以使用托管服务。你可以自带模型与电脑（沙箱）提供商，或在本地运行完整技术栈。

它提供 Web、Electron 桌面应用，以及 iPhone 和 Android 客户端，被作者描述为 Grok Bot、Meta Muse、OpenAI Dots、Instinct、OpenClaw、Hermes Agent、Claude Duet 的开源自托管替代品。项目目前处于 beta 阶段，官网为 rakazo.com。

主要功能

• 持久化 bot：每个 bot 拥有自己的对话、记忆、例程与历史
• 语音模式：朗读回复、听写、呼叫 bot；可自带 ElevenLabs、OpenAI、Cartesia、Fish Audio 的 key，或使用 Mac 服务器上已安装的声音
• 共享的 Team Computers 与相互隔离的 Private computers
• 浏览器、终端、文件与图形桌面访问能力
• bot 可以委派给同级 bot 或短生命周期的子代理
• 通过 Pi 接入自带的模型凭据
• 通过 Composio 或 Pipedream Connect 集成应用，也支持用户自行安装 Treg、远程 MCP 与 OpenAPI 工具源
• 支持 Docker、E2B、Daytona、CreateOS、Boat 以及可信本地电脑

安装与使用

使用已发布镜像快速启动，需要 Docker Engine、Compose 插件、curl 和 OpenSSL，无需克隆仓库或安装 Node：

mkdir -p rakazo && cd rakazo && curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh && bash install-images.sh

安装脚本会下载 Compose 文件、生成带随机密钥的 .env 并启动 Rakazo；重复运行时保留已有的 .env。随后打开 http://127.0.0.1:5173，创建账户并连接模型。默认镜像标签为 edge（main 构建，支持 linux/amd64 与 linux/arm64）。本地 Docker 电脑默认开启，也可选用远程提供商：e2b、novita、daytona、createos、boat、boxd 或 railway。

部署到服务器时，先运行 bash install-images.sh --prepare-only，编辑 .env 设置 SANDBOX_PROVIDER（如 boat、e2b、daytona、createos）及其 API key，以及 RAKAZO_HOST=your.domain，再运行 bash install-images.sh。请在 5173 端口前加上 HTTPS；桌面应用中选择 Existing instance 并填入 https:// 地址即可连接。也可以按官方模板部署到 Railway。

从源码开发需要 Node.js 22.22.2 及以上（22.x 系列）、Node.js 24.x 或 26+，pnpm 9 与 Docker：

git clone https://github.com/elie222/rakazo.git
cd rakazo
pnpm install
pnpm sandbox:build
pnpm dev

在开发栈运行时，可用 pnpm --filter @rakazo/desktop dev 启动 Electron 桌面端。

注意事项

• 项目处于 beta 阶段，自托管前请阅读官方 self-hosting 文档与生产部署文档。
• 源码开发不支持 Node.js 23.x 与 25.x。
• Linux 上的桌面版以 AppImage 分发，需要 FUSE 2（libfuse.so.2）；只有 FUSE 3 的发行版需安装 fuse-libs / libfuse2t64 等库，或使用 --appimage-extract-and-run 运行。
• 桌面端选择在本机运行时，需要已安装 Docker Desktop、OrbStack 或 Docker Engine。
• Treg 按用量计费，自托管者需自备 token。
• 模型、沙箱与第三方集成所需的 API key 均需自行准备。

本作品整理自 GitHub 开源项目 elie222/rakazo，原作者 @elie222，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。