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 टैब)

टास्कट्रे में व्हेल आइकन _हरे निशान_ के साथ स्थिर हो जाए तो ठीक है।

STEP5. सोर्स प्राप्त करें और Python वर्चुअल एनवायरनमेंट #

cd C:Dev               # अपनी पसंद की कार्य डायरेक्टरी
git clone https://github.com/AgenticSeek/agenticSeek.git
cd agenticSeek
python -m venv .venv
..venvScriptsActivate.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:AgentSeekagenticSeek
..venvScriptsActivate.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:Toolsnssmnssm.exe

8-2 सेवा पंजीकरण (एडमिनिस्ट्रेटर PowerShell) #

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

अतिरिक्त सेटिंग्स #

• I/O टैब

  • Output: C:AgentSeekagenticSeek.logsbackend.log

  • Error: C:AgentSeekagenticSeek.logsbackend-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 को स्थिर रूप से संचालित करने के लिए सेटअप प्रक्रिया पूर्ण है।