コンテンツにスキップ

ネイティブパッケージを入れる

Docker のない 1 人用の Linux(WSL2 を含む)に Agent Fleet を入れ、ブラウザから使い始めます。 ホストに何もインストールせずに動きます。tmux・git・node・エージェントの CLI をホストに入れる必要はありません。

あなたがやること 起きること
インストーラーを実行するか、tar を展開する af コマンドが使えるようになる
af start を実行する 初回だけ rootfs(約 200 MB)を取得・検証・展開し、Control Plane と Console がホストのプロセスとして動き出す
ブラウザで http://localhost:8099 を開く サインインなしで Console が開く。ワークスペースは bubblewrap のサンドボックスで動く
ワークスペースを初めて起動する エージェントの CLI を、決められたバージョンで仮想の HOME に入れる

複数の人で使うときや、コンテナの隔離と CPU・メモリの上限が要るときは、Docker を使う形態(Docker Compose で構築する など)を選びます。

要るもの 補足
Linux のカーネル(特権のないユーザー名前空間) WSL2 の標準カーネルは AppArmor が無効なので、そのまま動くはずです。Ubuntu 23.10 以降は下の設定が要ることがあります
bash・coreutils・tar 標準のものだけです。zstd は bin/zstd として同梱しているので、ホストには要りません
curl か wget 初回の rootfs の取得にだけ使います(手で持ち込む も参照)
(agy を使うなら)RDRAND を出す CPU agy(Antigravity CLI)の FIPS のビルドは、RDRAND がないと止まります。カーネルが命令を取り下げているときは、Agent が OpenSSL の CPU 検出から RDRAND を外して動かし、乱数はカーネルから取ります。AF_AGY_RDRAND_MASK=0 にするとこの回避を行わず、Console は agy を隠します

ユーザー名前空間がまったく無効なカーネルでは、ネイティブパッケージは動きません。Docker の形態(agent-fleet-<v>.tar.gz)を使います。 macOS には、ネイティブパッケージはありません。Apple Silicon の Mac では Linux の VM の中で動かします(macOS(Apple Silicon)で動かす)。

Ubuntu 23.10 以降で AppArmor が止めるとき

Section titled “Ubuntu 23.10 以降で AppArmor が止めるとき”

WSL ではないふつうの Ubuntu 23.10 以降では、AppArmor が特権のないユーザー名前空間を制限していることがあります。そのときは 1 回だけ実行します。

ターミナルウィンドウ
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
# 再起動後も有効にする:
echo 'kernel.apparmor_restrict_unprivileged_userns=0' | sudo tee /etc/sysctl.d/60-agent-fleet.conf

配布リポジトリ(k-k1/agent-fleet-dist)のインストーラーを使うと、~/.local/opt/agent-fleet/<v>/ に展開し、~/.local/bin/af にリンクを張ります。

ターミナルウィンドウ
curl -fsSL https://raw.githubusercontent.com/k-k1/agent-fleet-dist/main/install.sh | bash
af start # 初回だけ rootfs(約 200MB)を取得・検証・展開する
# ブラウザで http://localhost:8099 を開く
環境変数 意味
AF_VERSION 入れるバージョン。既定は最新のリリースです
AF_PREFIX インストール先の接頭辞。既定は ~/.local です
AF_NO_AUTOUPDATE 1 にすると、毎日の自動更新のタイマーを有効にしません(ネイティブパッケージを更新する)

tar を直接受け取ったときは、展開してその中の af を使います。<arch> は amd64 か arm64 で、uname -m の x86_64・aarch64 に合わせます。

ターミナルウィンドウ
tar xzf agent-fleet-native-<v>-linux-<arch>.tar.gz
cd agent-fleet-native-<v>-linux-<arch>
./af start # 初回だけ rootfs(約 200MB)を取得・検証・展開する
# ブラウザで http://localhost:8099 を開く
  • 初回の af start は、rootfs.json に書かれた rootfs を URL と sha256 で取得します。2 回目からはオフラインで起動できます(展開した rootfs を使い回します)
  • af start はフォアグラウンドで動きます。止めるときは Ctrl-C です。サービスとして動かすときは systemd でサービスとして動かす を参照してください
  • ブラウザで http://localhost:8099 を開きます。WSL2 なら、Windows の側のブラウザからそのまま開けます
  • af status で、Control Plane とワークスペースが動いているかを確かめられます

サインインの画面はありません。AUTH=dev の固定のユーザー 1 人で動き、そのユーザーは配備管理者(super_admin)です。 テナント設定の画面にも、af start の直後から入れます。

エージェントの CLI はパッケージに入っていません。

CLI 入るとき
claude・codex・opencode・cursor・copilot・agy・rtk ワークスペースの初回の起動で、versions.json で決まったバージョンを仮想の HOME に入れます。ネットワークが要るのはこのときだけです
kiro(約 855 MB) 初めて Kiro のセッションを起動したとき
Muse Code 頼むまで入りません。⚙設定 →「エージェント」のカードの「Muse Code を導入」で、決められたバージョンをホームディレクトリに入れます
中身 場所
すべてのデータ(DB・ワークスペースの home・claude-config・展開した rootfs) ~/.local/share/agent-fleet。WS_DATA で変えられます
パッケージそのもの 展開したディレクトリ。データは持たないので、消してもかまいません
  • 配置は Docker の形態と同じなので、同じ WS_DATA を docker と native の間で移せます
  • Windows のエクスプローラーからは \\wsl.localhost\<distro>\home\<user>\.local\share\agent-fleet で見えます

非公開のリポジトリをクローン・プッシュするには、Console の 設定 → Git ホスティング から GitHub か Bitbucket をつなぎます。 トークンを貼り付けるだけなら、何も設定しなくても動きます。

ワンクリックの「OAuth で接続」も使いたいときは、OAuth アプリを Console のテナントの設定で登録します(連携に使う OAuth アプリを選ぶ)。環境変数はありません。

プロバイダー 入れるもの 用意のしかた
GitHub(デバイスフロー) client_id だけ GitHub → Settings → Developer settings → OAuth Apps で、Enable Device Flow をオンにした OAuth App を作ります。client_id はシークレットではありません。デバイスフローはコールバックの URL が要らないので、localhost でもそのまま動きます
Bitbucket(認可コード) Key と Secret Callback URL が <PUBLIC_BASE_URL>/api/oauth/bitbucket/callback と完全に一致する OAuth consumer を作ります。PUBLIC_BASE_URL は Console を開く URL(http://localhost:8099 など)にします。貼り付ける URL は画面に出ます

1 人で使うネイティブの配備では、コールバックの要らない GitHub のデバイスフローがいちばん簡単です。

違い 内容
1 人だけ AUTH=dev に固定です。コンテナの隔離はなく、すべてのワークスペースが同じ OS ユーザーのまま、bubblewrap のサンドボックスで動きます
メモリの上限がない cgroup を使わないので、WS_MEMORY は効きません。重いビルドでホストごと落ちることがあります
ブラウザペインの Chromium は初回に取得する 決められたバージョンを約 200 MB 取得します。下の「Chromium のサンドボックスが動かないとき」

Chromium のサンドボックスが動かないとき

Section titled “Chromium のサンドボックスが動かないとき”

bubblewrap の下では SUID のサンドボックスを使えず、環境によっては Chromium の名前空間のサンドボックスも動きません。そのときは次のように起動します。

ターミナルウィンドウ
WS_ENV=AF_CHROMIUM_NO_SANDBOX=1 af start
  • この変数は WS_ENV(カンマ区切りの KEY=VAL の並び)でワークスペースに渡します。af start にそのまま付けると、Control Plane にしか届きません
  • ブラウザペインは localhost にしかつながないので、この用途なら許容できるトレードオフです。信頼できないサイトを見るのには使わないでください

worktree 間で Go のビルドキャッシュを共有する

Section titled “worktree 間で Go のビルドキャッシュを共有する”

ワークスペースのイメージには GOFLAGS=-trimpath が設定されており、パスの違う worktree でも ~/.cache/go-build のエントリを共有できます(worktree ごとにコピーが増えません)。この設定がネイティブのワークスペースに届くかどうかは、Control Plane がワークスペースをどう起動するかで変わります。

  • rootfs あり(AF_NATIVE_ROOTFS。af start は常にこちら): セッションはイメージの環境変数を引き継いで起動します。この設定を含むリリースへ更新して Control Plane を再起動し、動いていたワークスペースを停止してから起動し直すと反映されます。更新前に有効にしたい場合は WS_ENV で渡せます
  • rootfs なし(deploy/local/run-dev.sh native など、ホストの workspace-agent とホストの Go を使う形): イメージの環境変数は使われず、ワークスペースの環境変数は一から組み立てられます。Control Plane を起動するシェルで GOFLAGS を export してもセッションには届かないので、WS_ENV で渡してください
ターミナルウィンドウ
WS_ENV=GOFLAGS=-trimpath af start # rootfs あり: 更新前に有効にする/上書きする場合
WS_ENV=GOFLAGS=-trimpath deploy/local/run-dev.sh native # rootfs なし

どちらの形でも WS_ENV が優先されます(rootfs ありではイメージの値を上書きします)。~/.cache/go-build にすでにあるエントリは -trimpath なしで作られたものなので新しいビルドとは共有されず、Go 自身の掃除(5 日間使われなかったものの削除)まで残ります。ホストのシェルから直接動かすビルドはこの仕組みの影響を受けず、ワークスペースとは別のホスト自身の ~/.cache/go-build を使います。ホスト側の worktree どうしで共有したいときは、そちらでも GOFLAGS=-trimpath を export してください。

やりたいこと ページ
返信を読み上げる(VOICEVOX) 読み上げエンジンを動かす
自分のネットワークの ComfyUI で画像を生成する 自前の ComfyUI で画像を生成する
AWS の Agent Fleet の推論エンジンを借りる 別の配備のエンジンを借りる
LAN の llama.cpp でチャットする LAN の llama.cpp でチャットする

どれも af start に環境変数を付けるか、systemd unit の Environment= に書きます。af はシェルの環境を Control Plane にそのまま渡します。

症状 見るところ
af start がユーザー名前空間のエラーで止まる Ubuntu 23.10 以降なら AppArmor の設定。カーネルで無効なら Docker の形態を使います
ブラウザペインの Chromium が起動しない Chromium のサンドボックスが動かないとき
ポート 8099 が使えない 別の af start か、systemd のサービスがすでに動いています

エージェント向け

この指示をエージェントに送ると、このページを読ませられます。

https://agent-fleet.org/docs/ja/operate/native/install/index.md を読んで