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；其收錄條件包含穩定版本。