# 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-hant/docs/quickstart