> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aria Compute ROUTER: OpenAI-compatible inference gateway

> Aria Compute ROUTER is a self-hosted inference gateway with two routing modes: semantic (YAML v0.3 recipe) and agent (builtin tool-loop). Explore data-plane and management-plane endpoints.

Aria Compute ROUTER is a self-hosted OpenAI-compatible inference gateway. It provides two parallel routing engines: a **semantic router** that matches requests against a YAML v0.3 recipe using routing signals, and an **agent router** that runs an in-process builtin tool loop. The router exposes a data plane for inference clients and a management plane for operators.

The data plane implements the standard OpenAI `/v1/models` and `/v1/chat/completions` endpoints, so existing SDKs work without changes. The management plane covers authentication, routing configuration, cost tracking, and key management under `/v1/router/*`.

Shared provider models and hard constraints (cost, latency, capability) are evaluated at request time. You configure entrypoints, providers, and routing rules in a YAML v0.3 config file that the router reloads dynamically.

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/api-reference/router/authentication">
    How to authenticate with the router: Bearer tokens for data plane, sessions or API keys for management.
  </Card>

  <Card title="Chat Completions" icon="message" href="/api-reference/router/openai/chat-completions">
    Send chat requests through the router with standard OpenAI parameters and streaming support.
  </Card>

  <Card title="List Models" icon="list" href="/api-reference/router/openai/list-models">
    Discover available entrypoints and provider models via the OpenAI-compatible models endpoint.
  </Card>

  <Card title="Auth Endpoints" icon="user" href="/api-reference/router/auth/login">
    Register, log in, manage users, and configure OAuth for the router dashboard.
  </Card>
</CardGroup>

## Base URL

```text theme={null}
http://<router-host>:8080
```

The router is self-hosted. Replace `<router-host>` with the host where your router instance is running.


## Related topics

- [POST /v1/chat/completions: OpenAI-compatible chat inference](/api-reference/router/openai/chat-completions.md)
- [aria-engine runtime and FFI](/sdks/engine-runtime.md)
- [GET /v1/models: List router entrypoints and provider models](/api-reference/router/openai/list-models.md)
- [Router Management Plane Models List API](/api-reference/router/management/models.md)
- [Authenticate with Aria Compute ROUTER](/api-reference/router/authentication.md)
