STEP1. Overview Flow #

1. Enable WSL 2 + Required Windows Features

2. Install Docker Desktop (WSL 2 Backend)

3. Clone AgentSeek repository and prepare Python virtual environment (venv)

4. Start “Frontend + Redis + SearxNG” with Docker Compose

5. Manually verify FastAPI Backend → Convert to Windows Service with NSSM

6. Change BACKEND_URL to host.docker.internal:8000 for frontend integration

7. Restart test & operations confirmation

STEP2. Prerequisites Environment Check #

Recommendation: Perform all tasks in PowerShell with administrator privileges to prevent permission errors.

STEP3. Enable WSL 2 & Windows Features #

wsl --install -d Ubuntu          # 22.04 is installed by default
# If errors occur: run the following individually
# dism /online /enable-feature ...
# wsl --update
# wsl --set-default-version 2

After completion, restart your PC and verify that Ubuntu runs on Version 2 with wsl -l -v.

STEP4. Docker Desktop Installation #

winget install -e --id Docker.DockerDesktop

Initial Startup Configuration #

• Use the WSL 2 based engine → ON

• Add Docker CLI to the PATH → ON

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

Once the whale icon in the system tray shows a _green mark_ and stabilizes, you are ready.

STEP5. Source Code Retrieval & Python Virtual Environment #

cd C:Dev               # Your working directory
git clone https://github.com/AgenticSeek/agenticSeek.git
cd agenticSeek
python -m venv .venv
..venvScriptsActivate.ps1
pip install -r requirements.txt

Edit config.ini and specify the backend LLM endpoint such as GPUStack:

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

[BROWSER]
headless_browser = True  ; Set to True if you want to hide the browser

STEP6. Start Frontend with Docker Compose #

Modify frontend.environment in docker-compose.yml to reference the host FastAPI.

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

# Apply changes
docker compose down
docker compose up -d --build   # --build recommended on first run

Check status:

docker compose ps

When frontend | Up, redis | Up, and searxng | Up are displayed, setup is complete.

STEP7. Manual FastAPI Backend Startup Test #

cd C:AgentSeekagenticSeek
..venvScriptsActivate.ps1
python api.py --host 0.0.0.0 --port 8000

• If you can open http://localhost:8000/docs in your browser, it is successful.

• Stop with Ctrl + C.

STEP8. Convert Backend to Windows Service with NSSM #

8-1 Download NSSM #

Download nssm-2.24.zip from https://nssm.cc/download and extract it. For example: C:Toolsnssmnssm.exe

8-2 Service Registration (Administrator PowerShell) #

& "C:Toolsnssmnssm.exe" install AgentSeekBackend ^
  "C:AgentSeekagenticSeek.venvScriptspython.exe" ^
  "api.py --host 0.0.0.0 --port 8000" ^
  -d "C:AgentSeekagenticSeek"

Additional Configuration #

• I/O Tab

  • Output: C:AgentSeekagenticSeek.logsbackend.log

  • Error: C:AgentSeekagenticSeek.logsbackend-err.log

• Service Tab

  • Start type: Automatic (Delayed Start)

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

STEP9. Operation Verification #

1. Browser → http://localhost:3000 → Top right shows Connected

2. Swagger UI → http://localhost:8000/docs opens

3. If ① and ② are maintained after restart test, autostart configuration is complete

STEP10. Agent Usage TIPS #

• GUI automatically routes agents via auto-router

• Specify a particular agent

  • @FileAgent zip *.csv into files.zip

  • JSON instruction format also supported: @FileAgent {"action":"zip","pattern":"*.csv"}

• For 100% fixed assignment, use CLI:

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

STEP11. Troubleshooting Quick Reference #

STEP12. Reference Links #

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

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

• AgentSeek GitHub (Development Branch) https://github.com/AgenticSeek/agenticSeek

With the above steps, setup for stable operations of AgentSeek WebGUI on Windows 11 is complete.