# Solo 本地快速上手

下载当前 SoyaOS 预览版，在本机运行内置 echo Agent。

SoyaOS 仍处于 alpha 阶段。Homebrew 安装暂不可用：`brew install soyaos` 会触发第三方 tap 信任检查，而当前 formula 的校验值仍是占位值。旧的 `https://soyaos.ai/install` 脚本也返回 404。现阶段请使用已发布的二进制。

## 1. 下载预览版

以下命令将 `v0.1.0-alpha.3` 下载到当前目录，支持 macOS 和 Linux 的 x86-64、ARM64 架构。运行前可查看[发布说明和签名文件](https://github.com/soyaos/soyaos/releases/tag/v0.1.0-alpha.3)。

```bash
case "$(uname -s)-$(uname -m)" in
  Darwin-arm64) asset=soyaos-darwin-arm64 ;;
  Darwin-x86_64) asset=soyaos-darwin-amd64 ;;
  Linux-aarch64|Linux-arm64) asset=soyaos-linux-arm64 ;;
  Linux-x86_64) asset=soyaos-linux-amd64 ;;
  *) echo "不支持的操作系统或架构" >&2; exit 1 ;;
esac
curl -fL "https://github.com/soyaos/soyaos/releases/download/v0.1.0-alpha.3/$asset" -o soyaos &&
  chmod +x soyaos &&
  ./soyaos version
```

版本输出应以 `soyaos v0.1.0-alpha.3` 开头。下文命令都在二进制所在目录执行。Windows 用户可从同一发布页下载 `soyaos-windows-amd64.exe`；目前尚未发布 Scoop bucket。

需要自行编译时，可克隆 [soyaos/soyaos](https://github.com/soyaos/soyaos)，使用 Go 1.23 或更新版本运行 `make build`，产物位于 `bin/soyaos`。

## 2. 启动 Solo

```bash
./soyaos start
```

保持终端运行。Solo 在 `127.0.0.1:7474` 提供兼容 OpenAI 的接口，启动时会打印本地开发用 API Key。

## 3. 试用 echo Agent

在另一个终端进入二进制所在目录，执行：

```bash
./soyaos agent run echo "hello"
```

也可以调用本地 API：

```bash
curl -f http://127.0.0.1:7474/v1/models \
  -H "Authorization: Bearer sk-soya-dev-local"
```

执行 `./soyaos help` 可查看当前二进制支持的命令。alpha CLI 还支持 `agent create <name>` 和 `pack validate <path>`。

## Homebrew 安装状态

Homebrew [要求第三方 tap 获得信任](https://docs.brew.sh/Tap-Trust)。使用完整 formula 名称可以省去单独执行 `brew trust`，但当前 formula 必须先修正校验值并通过测试。要让用户无需信任 tap 就能执行 `brew install soyaos`，还需进入 `homebrew/core`；其[收录条件包括稳定版本](https://docs.brew.sh/Acceptable-Formulae)。

---

Canonical HTML: https://soyaos.ai/zh/docs/quickstart