安装

大多数人直接安装桌面应用。也可以用 Docker 自行部署后在浏览器里使用，或者从源码构建。

桌面应用

从最新版本下载对应系统的安装包：Windows x64 或 ARM64 用 .exe，Apple 芯片的 macOS 用 .dmg，Linux x64 或 ARM64 用 .AppImage。桌面应用自带 Host，不需要另外安装任何东西，并会自行检查新版本，见更新。

Windows 安装包和 macOS 安装包目前都没有签名，第一次打开时系统可能会要求你确认。

手机请看移动应用与 PWA。

从源码构建的前提条件

• Node.js 22.19 或更新（Node.js 24 是开发基线）
• Bun 1.3.14
• 由 kernel/rust-toolchain.toml 选定的 Rust 工具链（安装 rustup 后，仓库会选择所需版本）
• Git

Varin 会随 Application Host 构建并启动原生 Rust Agent runtime，无需另装 Agent CLI。现有工作区文件与历史对话资产不会自动迁移或改写。

从源码（Web）

git clone https://github.com/Youzini-afk/Varin.git
cd Varin
bun install --frozen-lockfile
bun run dev

打开终端中打印的 Vite URL。Varin 会同时启动 UI 和受信任的 API/运行时服务。

从源码（桌面）

bun run electron:dev

更接近打包构建：

bun run electron:dev:bundled

可以用 bun run electron:build:win 在本地构建 Windows 安装包。在配置签名凭据之前，未签名的安装包是预期情况。

Docker

在 Linux Docker 主机上：

mkdir -p data/varin data/ssh data/cloudflared workspaces
sudo chown -R 1000:1000 data workspaces
umask 077
printf 'VARIN_UI_PASSWORD=%s\n' "$(openssl rand -base64 24)" > .env
docker compose up -d
curl --fail http://127.0.0.1:3000/health

打开 http://127.0.0.1:3000 并使用生成的密码。任何面向互联网的部署前面都应放置 TLS 反向代理或已批准的隧道。生产环境请将 VARIN_IMAGE 固定到已测试的 digest，而不是 :latest。

Compose 默认拉取精简镜像 ghcr.io/youzini-afk/varin-slim:latest（用来跑服务：Bun、Node、Git、SSH、cloudflared）。如果智能体要在容器里编译 Python、Java、Go 或 Rust，叠加工具链覆盖层：

docker compose -f docker-compose.yml -f docker-compose.toolbelt.yml up -d