# Open WebUI Integration

Drop-in configuration to use the PM Factory repo with [Open WebUI](https://github.com/open-webui/open-webui).

## Quick Setup

### 1. Connect Your Model Provider

In Open WebUI → Settings → Connections, add:

| Field | Value |
|-------|-------|
| URL | `http://<your-kiro-gateway>:8000/v1` |
| API Key | Your gateway API key |
| Model | `claude-opus-4.6` |

Any OpenAI-compatible provider works (Kiro Gateway, LiteLLM, Ollama, etc).

### 2. Import the Preset

Go to Workspace → Models → Import, and upload `preset.json`.

This creates a "Reltio PM Factory" model preset with the full system prompt from AGENTS.md baked in.

### 3. Upload Knowledge (Optional)

Go to Workspace → Knowledge → Create Collection called "PM Factory".

Upload these directories as documents:
- `skills/epics-standards/references/`
- `skills/factory-standards/` (after running `manager.py update`)
- `skills/bmad-suite/` (after running `manager.py update`)

Then attach the collection to your preset in Model settings → Knowledge.

### 4. Install Pipelines (Optional)

Pipelines let the model execute tools (Jira, Aha!, Gainsight) directly.

Copy the files from `pipelines/` into your Open WebUI pipelines directory, or upload them via the Pipelines UI.

Required env vars (set in Open WebUI → Settings → Pipelines):
- `AHA_API_KEY`
- `AHA_DOMAIN`
- `GAINSIGHT_PX_API_KEY`
- `MCPORTER_CONFIG` — path to `config/mcporter.json`

---

## Architecture

```
Open WebUI (browser)
    ↕ OpenAI-compatible API
Any LLM Provider (Kiro / Ollama / LiteLLM / OpenAI)
    + System Prompt (preset.json ← AGENTS.md)
    + RAG Knowledge (skills docs)
    + Pipelines (mcporter, aha, gainsight, bmad)
```

The repo remains CLI-agnostic. This is just one frontend option.