flow-routerlisted
Install: claude install-skill flowork-os/Flowork-OS
# flow_router
Local/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback. Pure-Go, multi-OS, portable.
## Setup
```bash
export FLOW_ROUTER_URL="http://localhost:2402" # or VPS / tunnel URL
export FLOW_ROUTER_KEY="flr_..." # from Dashboard → Keys (only if requireApiKey=true)
```
All requests: `${FLOW_ROUTER_URL}/v1/...` with header `Authorization: Bearer ${FLOW_ROUTER_KEY}` (omit if auth disabled).
Verify: `curl $FLOW_ROUTER_URL/api/health` → `{"status":"ok",...}`
## Discover models
```bash
curl $FLOW_ROUTER_URL/v1/models # chat/LLM (default aggregate)
curl $FLOW_ROUTER_URL/v1/models/image # image-gen
curl $FLOW_ROUTER_URL/v1/models/tts # text-to-speech
curl $FLOW_ROUTER_URL/v1/models/embedding # embeddings
curl $FLOW_ROUTER_URL/v1/models/web # web search + fetch
curl $FLOW_ROUTER_URL/v1/models/stt # speech-to-text
```
Use `data[].id` as `model` in requests. Combos appear with `owned_by:"combo"`. Aliases with `owned_by:"alias"`.
## Capability skills
When the user needs a specific capability, fetch the matching `SKILL.md`:
| Capability | File |
|---|---|
| Chat / code-gen | `flow-router-chat/SKILL.md` |
| Image generation | `flow-router-image/SKILL.md` |
| Text-to-speech | `flow-router-tts/SKILL.md` |
| Speech-to-text | `flow-router-stt/SKILL.md` |
| Embeddings | `flow-router-embeddings/SKILL.md` |
| Web search | `flow-router-web-search