トークン効率を極める AI Agent

uv --version がすでに動く場合はスキップしてください。

$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ . "$HOME/.local/bin/env"

> powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
> $env:Path = "$env:USERPROFILE\.local\bin;" + $env:Path

どのプラットフォームでも同じコマンドです。

$ uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.2/opensquilla-0.5.2-py3-none-any.whl"

リリース URL から OpenSquilla の wheel をインストールし、選択した extras が宣言する依存関係を uv が取得します。デフォルトの recommended extra には SquillaRouter のランタイム依存（ONNX Runtime、LightGBM、NumPy、tokenizers）が含まれます。

$ git lfs install
$ git clone https://github.com/opensquilla/opensquilla.git
$ cd opensquilla
$ git lfs pull --include="src/opensquilla/squilla_router/models/**"

Git LFS はバンドルされた ML ルーティングモデルを取得します。pull は冪等で、完了済みのチェックアウトに対しては静かに終了します。

# .[recommended] を uv tool install でインストール（uv が無いと pip --user にフォールバック）
$ bash scripts/install_source.sh

# PowerShell で実行
> powershell -ExecutionPolicy Bypass -File ./scripts/install_source.ps1

主要チャネルは基本インストールで動作します。任意の extras: matrix、matrix-e2e、document-extras——OPENSQUILLA_INSTALL_EXTRAS=matrix（bash）または -Extras matrix（PowerShell）で有効化できます。

$ opensquilla onboard

モデルプロバイダ、チャネル、セキュリティポリシーをガイド付きで設定します。インストール済みの opensquilla コマンドをそのまま使ってください。ソースから開発を選んだ場合を除き、uv run を付ける必要はありません。

# ASGI サーバーを起動（デフォルト 127.0.0.1:18791）
$ opensquilla gateway run

起動後、ブラウザで http://127.0.0.1:18791/control/ を開きます。

Windows に Visual C++ Redistributable が無くても Gateway は起動します。バンドルルーターは安全なダイレクトルートにフォールバックします。