# labiium/routiium architecture

> Architecture diagram of the GitHub repository labiium/routiium, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/labiium/routiium
- Repository: https://github.com/labiium/routiium

## Overview

Routiium is a self-hosted OpenAI-compatible LLM gateway, with a browser-based admin panel. The main runtime path accepts a client request, applies access controls and limits, prepares and judges it, selects a model route, and proxies to an upstream; the gateway also supports chat history, analytics, MCP tools, Bedrock, and subscription proxying. The admin panel exposes management views through the gateway API. Some links are based on README descriptions or the source index; unsampled implementation details are not inferred as direct calls.

Main entry points: [`src/server.rs`](https://github.com/labiium/routiium/blob/main/src/server.rs) (HTTP gateway), [`src/router_client.rs`](https://github.com/labiium/routiium/blob/main/src/router_client.rs) (Model router), [`apps/admin/src/pages`](https://github.com/labiium/routiium/tree/main/apps/admin/src/pages) (Admin views), [`apps/admin/src/lib/adminApi.ts`](https://github.com/labiium/routiium/blob/main/apps/admin/src/lib/adminApi.ts) (Admin API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["Gateway runtime"]
  node_server["HTTP gateway<br/>[server.rs]"]
  node_auth["API key auth<br/>[auth.rs]"]
  node_limits["Rate limits<br/>[rate_limit.rs]"]
  node_models["API models<br/>[chat.rs]"]
  node_conversion["API conversion<br/>[conversion.rs]"]
end

subgraph group_policy["Routing and safety"]
  node_judge["Safety judge<br/>[safety_judge.rs]"]
  node_decision["Typed decisions<br/>[decision.rs]"]
  node_router["Model router<br/>[router_client.rs]"]
  node_jev["Jev adapter<br/>[jev.rs]"]
end

subgraph group_capabilities["Gateway capabilities"]
  node_bedrock["Bedrock support<br/>[bedrock.rs]"]
  node_mcp["MCP tools<br/>[mcp_client.rs]"]
  node_mcpconfig["MCP configuration<br/>[mcp_config.rs]"]
  node_history["Chat history<br/>[chat_history.rs]"]
  node_historymanager["History manager"]
  node_analytics[("Analytics<br/>[analytics.rs]")]
  node_analyticsmw["Analytics middleware"]
  node_subscription["Subscription proxy"]
end

subgraph group_admin["Administration"]
  node_adminapp["Admin panel<br/>[App.tsx]"]
  node_adminpages["Admin views"]
  node_adminstate["Panel state hook"]
  node_adminapi["Admin API client<br/>[adminApi.ts]"]
end

node_client(("OpenAI client"))
node_upstream(("Model providers"))
node_adminuser(("Admin"))

node_client -->|"sends request"| node_server
node_server -->|"checks credentials"| node_auth
node_server -->|"applies limits"| node_limits
node_server -->|"parses request"| node_models
node_server -->|"converts API"| node_conversion
node_server -->|"judges request"| node_judge
node_server -->|"selects route"| node_router
node_router -->|"requests decision"| node_decision
node_jev -->|"implements provider"| node_decision
node_router -->|"resolves model"| node_upstream
node_server -->|"proxies request"| node_upstream
node_server -->|"supports Bedrock"| node_bedrock
node_server -->|"uses tools"| node_mcp
node_mcp -->|"loads settings"| node_mcpconfig
node_server -->|"records conversations"| node_history
node_historymanager -->|"uses store types"| node_history
node_server -->|"manages history"| node_historymanager
node_server -->|"records requests"| node_analyticsmw
node_analyticsmw -->|"updates analytics"| node_analytics
node_client -.->|"uses proxy"| node_subscription
node_adminuser -->|"uses panel"| node_adminapp
node_adminapp -->|"routes views"| node_adminpages
node_adminpages -->|"loads panel state"| node_adminstate
node_adminstate -->|"fetches state"| node_adminapi
node_adminpages -->|"sends updates"| node_adminapi
node_adminapi -.->|"calls admin API"| node_server

click node_server "https://github.com/labiium/routiium/blob/main/src/server.rs"
click node_auth "https://github.com/labiium/routiium/blob/main/src/auth.rs"
click node_limits "https://github.com/labiium/routiium/blob/main/src/rate_limit.rs"
click node_models "https://github.com/labiium/routiium/blob/main/src/models/chat.rs"
click node_conversion "https://github.com/labiium/routiium/blob/main/src/conversion.rs"
click node_judge "https://github.com/labiium/routiium/blob/main/src/safety_judge.rs"
click node_decision "https://github.com/labiium/routiium/blob/main/src/decision.rs"
click node_router "https://github.com/labiium/routiium/blob/main/src/router_client.rs"
click node_jev "https://github.com/labiium/routiium/blob/main/src/jev.rs"
click node_bedrock "https://github.com/labiium/routiium/blob/main/src/bedrock.rs"
click node_mcp "https://github.com/labiium/routiium/blob/main/src/mcp_client.rs"
click node_mcpconfig "https://github.com/labiium/routiium/blob/main/src/mcp_config.rs"
click node_history "https://github.com/labiium/routiium/blob/main/src/chat_history.rs"
click node_historymanager "https://github.com/labiium/routiium/blob/main/src/chat_history_manager.rs"
click node_analytics "https://github.com/labiium/routiium/blob/main/src/analytics.rs"
click node_analyticsmw "https://github.com/labiium/routiium/blob/main/src/analytics_middleware.rs"
click node_subscription "https://github.com/labiium/routiium/blob/main/src/subscription_proxy.rs"
click node_adminapp "https://github.com/labiium/routiium/blob/main/apps/admin/src/App.tsx"
click node_adminpages "https://github.com/labiium/routiium/tree/main/apps/admin/src/pages"
click node_adminstate "https://github.com/labiium/routiium/blob/main/apps/admin/src/hooks/useAdminPanelState.ts"
click node_adminapi "https://github.com/labiium/routiium/blob/main/apps/admin/src/lib/adminApi.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_auth,node_limits,node_models,node_conversion,node_client toneBlue
class node_judge,node_decision,node_router,node_jev toneAmber
class node_bedrock,node_mcp,node_mcpconfig,node_history,node_historymanager,node_analytics,node_analyticsmw,node_subscription toneMint
class node_adminapp,node_adminpages,node_adminstate,node_adminapi toneRose
class node_upstream,node_adminuser toneIndigo
```

## Components

### Gateway runtime

- [HTTP gateway](https://github.com/labiium/routiium/blob/main/src/server.rs): `src/server.rs`
- [API key auth](https://github.com/labiium/routiium/blob/main/src/auth.rs): `src/auth.rs`
- [Rate limits](https://github.com/labiium/routiium/blob/main/src/rate_limit.rs): `src/rate_limit.rs`
- [API models](https://github.com/labiium/routiium/blob/main/src/models/chat.rs): `src/models/chat.rs`
- [API conversion](https://github.com/labiium/routiium/blob/main/src/conversion.rs): `src/conversion.rs`

### Routing and safety

- [Safety judge](https://github.com/labiium/routiium/blob/main/src/safety_judge.rs): `src/safety_judge.rs`
- [Typed decisions](https://github.com/labiium/routiium/blob/main/src/decision.rs): `src/decision.rs`
- [Model router](https://github.com/labiium/routiium/blob/main/src/router_client.rs): `src/router_client.rs`
- [Jev adapter](https://github.com/labiium/routiium/blob/main/src/jev.rs): `src/jev.rs`

### Gateway capabilities

- [Bedrock support](https://github.com/labiium/routiium/blob/main/src/bedrock.rs): `src/bedrock.rs`
- [MCP tools](https://github.com/labiium/routiium/blob/main/src/mcp_client.rs): `src/mcp_client.rs`
- [MCP configuration](https://github.com/labiium/routiium/blob/main/src/mcp_config.rs): `src/mcp_config.rs`
- [Chat history](https://github.com/labiium/routiium/blob/main/src/chat_history.rs): `src/chat_history.rs`
- [History manager](https://github.com/labiium/routiium/blob/main/src/chat_history_manager.rs): `src/chat_history_manager.rs`
- [Analytics](https://github.com/labiium/routiium/blob/main/src/analytics.rs): `src/analytics.rs`
- [Analytics middleware](https://github.com/labiium/routiium/blob/main/src/analytics_middleware.rs): `src/analytics_middleware.rs`
- [Subscription proxy](https://github.com/labiium/routiium/blob/main/src/subscription_proxy.rs): `src/subscription_proxy.rs`

### Administration

- [Admin panel](https://github.com/labiium/routiium/blob/main/apps/admin/src/App.tsx): `apps/admin/src/App.tsx`
- [Admin views](https://github.com/labiium/routiium/tree/main/apps/admin/src/pages): `apps/admin/src/pages`
- [Panel state hook](https://github.com/labiium/routiium/blob/main/apps/admin/src/hooks/useAdminPanelState.ts): `apps/admin/src/hooks/useAdminPanelState.ts`
- [Admin API client](https://github.com/labiium/routiium/blob/main/apps/admin/src/lib/adminApi.ts): `apps/admin/src/lib/adminApi.ts`

### Other components

- **OpenAI client**
- **Model providers**
- **Admin**

## Connections

- OpenAI client → HTTP gateway: sends request
- HTTP gateway → API key auth: checks credentials (evidence: `src/server.rs`)
- HTTP gateway → Rate limits: applies limits (evidence: `src/server.rs`)
- HTTP gateway → API models: parses request (evidence: `src/server.rs`)
- HTTP gateway → API conversion: converts API (evidence: `src/server.rs`)
- HTTP gateway → Safety judge: judges request (evidence: `src/server.rs`)
- HTTP gateway → Model router: selects route (evidence: `src/server.rs`)
- Model router → Typed decisions: requests decision (evidence: `src/router_client.rs`)
- Jev adapter → Typed decisions: implements provider (evidence: `src/jev.rs`)
- Model router → Model providers: resolves model
- HTTP gateway → Model providers: proxies request
- HTTP gateway → Bedrock support: supports Bedrock (evidence: `src/server.rs`)
- HTTP gateway → MCP tools: uses tools (evidence: `src/server.rs`)
- MCP tools → MCP configuration: loads settings (evidence: `src/mcp_client.rs`)
- HTTP gateway → Chat history: records conversations (evidence: `src/server.rs`)
- History manager → Chat history: uses store types (evidence: `src/chat_history_manager.rs`)
- HTTP gateway → History manager: manages history (evidence: `src/server.rs`)
- HTTP gateway → Analytics middleware: records requests (evidence: `src/server.rs`)
- Analytics middleware → Analytics: updates analytics (evidence: `src/analytics_middleware.rs`)
- OpenAI client → Subscription proxy: uses proxy
- Admin → Admin panel: uses panel (evidence: `apps/admin/src/App.tsx`)
- Admin panel → Admin views: routes views (evidence: `apps/admin/src/App.tsx`)
- Admin views → Panel state hook: loads panel state (evidence: `apps/admin/src/pages/Routing.tsx`)
- Panel state hook → Admin API client: fetches state (evidence: `apps/admin/src/hooks/useAdminPanelState.ts`)
- Admin views → Admin API client: sends updates (evidence: `apps/admin/src/pages/Routing.tsx`)
- Admin API client → HTTP gateway: calls admin API
