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 架构。运行前可查看发布说明和签名文件。
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，使用 Go 1.23 或更新版本运行 make build，产物位于 bin/soyaos。
2. 启动 Solo
./soyaos start保持终端运行。Solo 在 127.0.0.1:7474 提供兼容 OpenAI 的接口，启动时会打印本地开发用 API Key。
3. 试用 echo Agent
在另一个终端进入二进制所在目录，执行：
./soyaos agent run echo "hello"也可以调用本地 API：
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 获得信任。使用完整 formula 名称可以省去单独执行 brew trust，但当前 formula 必须先修正校验值并通过测试。要让用户无需信任 tap 就能执行 brew install soyaos，还需进入 homebrew/core；其收录条件包括稳定版本。