| name | flow-router |
| description | Entry point for flow_router — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch. Use when the user mentions flow_router, FLOW_ROUTER_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills. |
flow_router
Local/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback. Pure-Go, multi-OS, portable.
Setup
export FLOW_ROUTER_URL="http://localhost:2402"
export FLOW_ROUTER_KEY="flr_..."
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
curl $FLOW_ROUTER_URL/v1/models
curl $FLOW_ROUTER_URL/v1/models/image
curl $FLOW_ROUTER_URL/v1/models/tts
curl $FLOW_ROUTER_URL/v1/models/embedding
curl $FLOW_ROUTER_URL/v1/models/web
curl $FLOW_ROUTER_URL/v1/models/stt
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/SKILL.md |
| Web fetch | flow-router-web-fetch/SKILL.md |
Errors
- 401 → set/refresh
FLOW_ROUTER_KEY (Dashboard → Keys)
- 400
no active provider supports model X → check model exists in /v1/models[/<kind>]
- 429 → rate-limited (per-key cap reached or global budget exceeded)
- 502
all providers failed → check provider health in Dashboard → Providers
