STEP1. 概要フロー #

1. WSL 2 + 必須 Windows 機能 を有効化

2. Docker Desktop（WSL 2 バックエンド） をインストール

3. AgentSeek リポジトリをクローンし Python 仮想環境 (venv) を準備

4. Docker Compose で「フロントエンド + Redis + SearxNG」を起動

5. FastAPI バックエンド を手動で確認 → NSSM で Windows サービス化

6. BACKEND_URL を host.docker.internal:8000 に変更してフロントと連携

7. 再起動テスト & 運用確認

STEP2. 前提環境チェック #

推奨: すべて管理者権限の PowerShell で作業すると権限エラーを防げます。

STEP3. WSL 2 & Windows 機能を有効化 #

wsl --install -d Ubuntu          # 22.04 が既定で入る
# 途中でエラーが出たら: 以下を個別実行
# dism /online /enable-feature ...
# wsl --update
# wsl --set-default-version 2

完了後 PC を再起動し、wsl -l -v で Ubuntu が Version 2 で動作することを確認。

STEP4. Docker Desktop の導入 #

winget install -e --id Docker.DockerDesktop

初回起動時の設定 #

• Use the WSL 2 based engine → ON

• Add Docker CLI to the PATH → ON

• Start Docker Desktop when you log in → ON (General タブ)

タスクトレイのクジラアイコンが_緑マーク_で安定すれば OK。

STEP5. ソース取得 & Python 仮想環境 #

cd C:\Dev               # 任意の作業ディレクトリ
git clone https://github.com/AgenticSeek/agenticSeek.git
cd agenticSeek
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

config.ini を編集し、GPUStack などバックエンド LLM のエンドポイントを指定:

[PROVIDER]
provider_name = gpustack
provider_server_address = http://<GPUStack_IP>:<port>/v1

[BROWSER]
headless_browser = True  ; ブラウザを非表示にしたい場合

STEP6. Docker Compose でフロントエンドを起動 #

docker-compose.yml の frontend.environment を修正し、ホスト FastAPI を参照させます。

environment:
  - NODE_ENV=development
  - CHOKIDAR_USEPOLLING=true
  - BACKEND_URL=http://host.docker.internal:8000
  - VITE_BACKEND_URL=http://host.docker.internal:8000

# 反映
docker compose down
docker compose up -d --build   # 初回は --build 推奨

状態確認:

docker compose ps

frontend | Up, redis | Up, searxng | Up になれば準備完了。

STEP7. FastAPI バックエンドの手動起動テスト #

cd C:\AgentSeek\agenticSeek
.\.venv\Scripts\Activate.ps1
python api.py --host 0.0.0.0 --port 8000

• ブラウザで http://localhost:8000/docs が開けば成功。

• Ctrl + C で停止。

STEP8. バックエンドを NSSM で Windows サービス化 #

8-1 NSSM ダウンロード #

https://nssm.cc/download から nssm-2.24.zip を展開: 例 C:\Tools\nssm\nssm.exe

8-2 サービス登録（管理者 PowerShell） #

& "C:\Tools\nssm\nssm.exe" install AgentSeekBackend ^
  "C:\AgentSeek\agenticSeek\.venv\Scripts\python.exe" ^
  "api.py --host 0.0.0.0 --port 8000" ^
  -d "C:\AgentSeek\agenticSeek"

追加設定 #

• I/O タブ

  • Output: C:\AgentSeek\agenticSeek\.logs\backend.log

  • Error: C:\AgentSeek\agenticSeek\.logs\backend-err.log

• Service タブ

  • Start type: Automatic (Delayed Start)

Start-Service AgentSeekBackend
Get-Service AgentSeekBackend   # Status: Running

STEP9. 動作検証 #

1. ブラウザ → http://localhost:3000 → 右上が Connected

2. Swagger UI → http://localhost:8000/docs が開く

3. 再起動テスト後も①②が維持されれば自動起動設定は完了

STEP10. エージェント利用 TIPS #

• GUI は自動ルーターでエージェントを振り分け

• 特定エージェントを指名

  • @FileAgent zip *.csv into files.zip

  • JSON 指示形式も可: @FileAgent {"action":"zip","pattern":"*.csv"}

• 100% 固定したい場合は CLI:

  python cli.py --agent FileAgent "zip *.csv"

STEP11. トラブルシューティング早見表 #

STEP12. 参考リンク #

• Docker Desktop Documentation https://docs.docker.com/desktop/windows/

• NSSM – the Non‑Sucking Service Manager https://nssm.cc/

• AgentSeek GitHub (開発ブランチ) https://github.com/AgenticSeek/agenticSeek

以上で、Windows 11 上で AgentSeek WebGUI を安定運用するためのセットアップ手順は完了です。