Documentation

gateway.docsChoose your pathusers → configure → observe → deploy

OctaFuse is a self-hostable AI capability gateway and operations control plane. The docs follow the workflow: run it locally; configure upstreams, models, image generation, Agent Tools, routes, and keys; use Playground / Simulator and logs when debugging; open the gateway repository reference for API fields, migrations, architecture, and deep operations.

01I want to run itLocal D1 → one-command Cloudflare deploy, Admin login, one test request.02I am integrating a systemProxy vs Admin, user keys vs master keys, portal provisioning flows.03I am going to productionCloudflare Workers (default), Docker self-hosting, data placement, migration order.

Product Tour

OctaFuse Admin Dashboard showing API keys, request count, tokens, cost, model distribution, and usage charts. — Dashboard: start with operations, requests, tokens, spend, and recent errors.

OctaFuse Admin Routes page showing model-to-provider route cards. — Routes: map client model ids to vendors, upstream model names, and route groups.

OctaFuse Admin Playground showing route selection, request body, and response panels. — Playground: probe one upstream route before sending live traffic through it.

Configuration Pipeline

1ProvidersEndpoints and multi-key pools 2ModelsCatalog and pricing 3RoutesSelection, groups, failover 4ImagesGeneration / edit pricing 5ToolsExtensible agent tools 6UsersAccounts, budgets, periods 7API KeysIssue, revoke, authenticate

Common Entry Points

Quick start Local D1 → Cloudflare deploy

Integration Proxy / Admin / key boundaries

Image generation / edit Images with token / per-image billing

Agent Tools Extensible tool APIs; web tools ship today

Playground Probe one route upstream

Simulator Validate the full Proxy path with a real key

Cloudflare deployment Worker + Admin + D1 (recommended)

Docker deployment Self-hosting, Postgres / MySQL, images

Troubleshooting And Governance

I want to…	Go to
Inspect whether a call succeeded	Request logs
Inspect usage and cost trends	Analytics
Inspect budget, key lifecycle, and user-side audit	Audit logs
Configure master key, business timezone, billing currency, alerts	System config
Read APIs, migrations, architecture, billing details	GitHub technical reference