# AgentOrchestrator – Easy Windows Setup

## Snelle start (aanbevolen)
1. Dubbelklik op `launch_agent.bat`
2. Bij de eerste keer wordt automatisch alles geïnstalleerd (5-15 minuten)
3. Na installatie opent de app in je browser op `http://127.0.0.1:8001`
4. De setup-wizard in de browser begeleidt je door de configuratie
5. Er wordt een **bureaublad-snelkoppeling** en **Start Menu-vermelding** aangemaakt

## Online install (geen handmatig unzip)
1. Open PowerShell
2. Run:
```powershell
iwr https://www.hetphoenixproject.nl/AgentOrchestrator/install_agentorchestrator.bat -OutFile install_agentorchestrator.bat
.\install_agentorchestrator.bat
```

Fallback (direct PowerShell script):
```powershell
iwr https://www.hetphoenixproject.nl/AgentOrchestrator/install_latest_windows.ps1 -OutFile install_latest_windows.ps1
powershell -ExecutionPolicy Bypass -File .\install_latest_windows.ps1
```

Clean install (instellingen resetten):
```powershell
powershell -ExecutionPolicy Bypass -File .\install_latest_windows.ps1 -CleanInstall
```

Unattended (voor automatisering, behoudt bestaande instellingen):
```powershell
powershell -ExecutionPolicy Bypass -File .\install_latest_windows.ps1 -Unattended
```

Of met de bootstrap batch:
```powershell
.\install_agentorchestrator.bat clean
```

## Handmatig via PowerShell
```powershell
cd "D:\Coding Projects\Agent"
powershell -ExecutionPolicy Bypass -File .\install_windows.ps1
.\.venv\Scripts\python.exe .\start.py
```

## Wat de installer doet
De installer toont voortgang met stappen [1/9] t/m [9/9]:

1. **Python controleren** – installeert Python 3.11 via winget als dat ontbreekt
2. **Virtual environment** – maakt `.venv` aan
3. **Python packages** – installeert vereiste packages uit `requirements.txt`
4. **Browser engine** – installeert Playwright Chromium voor web-skills
5. **Node.js / npx** – installeert Node.js LTS voor MCP-servers die via `npx` draaien, zoals Filesystem
6. **Backend validatie** – controleert of de code correct is
7. **Ollama** – installeert Ollama voor lokale AI-modellen (optioneel)
8. **Configuratie** – maakt `settings.json` aan op basis van template
9. **Snelkoppelingen** – bureaublad-icoon en Start Menu-vermelding

Als een stap faalt, toont de installer een duidelijke foutmelding met oplossing.
Model pulls worden overgeslagen als de modellen al gedownload zijn.

## Na installatie: Setup Wizard
Bij de eerste keer openen begeleidt de app je door:
- AI model configuratie (Ollama, cloud modellen)
- API keys (optioneel: OpenAI, Gemini, NVIDIA, Brave Search)
- Integraties (Outlook, Google, Slack, WhatsApp, Telegram)

Alles is optioneel — je kunt stappen overslaan en later via **Settings** configureren.

## System Check
In **Settings → Server → Server Control** vind je de knop **Run System Check**.
Deze test alle geconfigureerde integraties tegelijk en toont een overzicht met groene/rode statussen.

## Home Assistant MCP toevoegen
- Open **Settings → Integrations → MCP**
- Kies preset **Home Assistant**
- Vul in:
  - `HOMEASSISTANT_URL` (bijv. `http://homeassistant.local:8123`)
  - `HOMEASSISTANT_TOKEN` (Long-Lived Access Token uit Home Assistant)
- Op Windows moet `uvx` beschikbaar zijn (aanrader: `winget install astral-sh.uv -e`)

## Filesystem MCP toevoegen
- De Windows-installer installeert nu automatisch Node.js LTS als `node`/`npm`/`npx` nog ontbreken.
- Daardoor werken `npx`-gebaseerde MCP-servers zoals **Filesystem** direct na installatie meestal zonder extra handwerk.
- Als Node.js niet automatisch geïnstalleerd kon worden, gebruik dan: `winget install OpenJS.NodeJS.LTS -e`

## Belangrijk
- De app draait op: `http://127.0.0.1:8001` (launcher) en `http://127.0.0.1:8000` (backend)
- Alle instellingen zijn instelbaar via de Settings-pagina in de browser
- Stoppen: gebruik de Stop-knop in Settings, of run `kill_agent_server.bat`

## Problemen oplossen
| Probleem | Oplossing |
|----------|-----------|
| PowerShell geeft rode fout over "execution policy" | Run: `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned` |
| Poort 8001 is bezet | Sluit andere AgentOrchestrator-instanties of run `kill_agent_server.bat` |
| Python niet gevonden | Installeer Python 3.11+ van https://python.org/downloads |
| Antivirus blokkeert | Voeg de installatiemap toe als uitzondering in je antivirussoftware |
| Playwright Chromium faalt | Run handmatig: `.venv\Scripts\python.exe -m playwright install chromium` |
| Ollama modellen downloaden niet | Start Ollama eerst handmatig en probeer opnieuw |
- Je hoeft de frontend niet apart te starten; die wordt door de backend geserveerd.
- `settings.json` met persoonlijke tokens wordt niet meegekopieerd door installer/release.
- Vul je eigen tokens na installatie in via de app-Settings.
