ネイティブパッケージを入れる
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.conf1. インストールする
Section titled “1. インストールする”配布リポジトリ(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 | bashaf 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.gzcd agent-fleet-native-<v>-linux-<arch>./af start # 初回だけ rootfs(約 200MB)を取得・検証・展開する# ブラウザで http://localhost:8099 を開く2. 起動して開く
Section titled “2. 起動して開く”- 初回の
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
Section titled “エージェントの CLI”エージェントの CLI はパッケージに入っていません。
| CLI | 入るとき |
|---|---|
| claude・codex・opencode・cursor・copilot・agy・rtk | ワークスペースの初回の起動で、versions.json で決まったバージョンを仮想の HOME に入れます。ネットワークが要るのはこのときだけです |
| kiro(約 855 MB) | 初めて Kiro のセッションを起動したとき |
| Muse Code | 頼むまで入りません。⚙設定 →「エージェント」のカードの「Muse Code を導入」で、決められたバージョンをホームディレクトリに入れます |
データの置き場所
Section titled “データの置き場所”| 中身 | 場所 |
|---|---|
| すべてのデータ(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で見えます
リポジトリを OAuth でつなぐ
Section titled “リポジトリを OAuth でつなぐ”非公開のリポジトリをクローン・プッシュするには、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 のデバイスフローがいちばん簡単です。
Docker の形態との違い
Section titled “Docker の形態との違い”| 違い | 内容 |
|---|---|
| 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 してください。
任意で足せるもの
Section titled “任意で足せるもの”| やりたいこと | ページ |
|---|---|
| 返信を読み上げる(VOICEVOX) | 読み上げエンジンを動かす |
| 自分のネットワークの ComfyUI で画像を生成する | 自前の ComfyUI で画像を生成する |
| AWS の Agent Fleet の推論エンジンを借りる | 別の配備のエンジンを借りる |
| LAN の llama.cpp でチャットする | LAN の llama.cpp でチャットする |
どれも af start に環境変数を付けるか、systemd unit の Environment= に書きます。af はシェルの環境を Control Plane にそのまま渡します。
うまくいかないとき
Section titled “うまくいかないとき”| 症状 | 見るところ |
|---|---|
af start がユーザー名前空間のエラーで止まる |
Ubuntu 23.10 以降なら AppArmor の設定。カーネルで無効なら Docker の形態を使います |
| ブラウザペインの Chromium が起動しない | Chromium のサンドボックスが動かないとき |
| ポート 8099 が使えない | 別の af start か、systemd のサービスがすでに動いています |
エージェント向け
この指示をエージェントに送ると、このページを読ませられます。
https://agent-fleet.org/docs/ja/operate/native/install/index.md を読んで