# Open Next Router

> A lightweight, DSL-driven LLM gateway for routing, compatibility transforms, and streaming normalization across providers.

## Docs

- [Gemini Native API (v1beta)](https://onr.mintlify.app/api/gemini-native.md): Subset of Gemini native endpoints supported by ONR.
- [OpenAI-Compatible Endpoints](https://onr.mintlify.app/api/openai-compatible.md): OpenAI-style API paths supported by ONR.
- [API Overview](https://onr.mintlify.app/api/overview.md): Interface specifications and routing conventions for ONR.
- [Token Key (onr:v1?)](https://onr.mintlify.app/api/token-key.md): Single-key auth format for clients that cannot set custom headers.
- [Architecture](https://onr.mintlify.app/concepts/architecture.md): High-level request pipeline and provider selection.
- [Dashboards](https://onr.mintlify.app/concepts/dashboards.md): Grafana dashboards for ONR access logs (Promtail + Loki).
- [Observability](https://onr.mintlify.app/concepts/observability.md): Logs, traffic dump, and usage/cost extraction.
- [Request Lifecycle](https://onr.mintlify.app/concepts/request-lifecycle.md): In-depth look at how requests are processed by ONR.
- [Why ONR](https://onr.mintlify.app/concepts/why-onr.md): What ONR is and why the DSL-first approach matters.
- [keys.yaml](https://onr.mintlify.app/configuration/keys-yaml.md): Managing proxy upstream credential fleets and client access control.
- [models.yaml](https://onr.mintlify.app/configuration/models-yaml.md): Model routing, aliasing, and load balancing across upstream providers.
- [onr.yaml](https://onr.mintlify.app/configuration/onr-yaml.md): Core runtime server configuration.
- [Reload](https://onr.mintlify.app/configuration/reload.md): Reload ONR configs with SIGHUP (nginx-like).
- [Development Guide](https://onr.mintlify.app/contributing/development-guide.md): How to compile and modify Open Next Router locally.
- [Release Process](https://onr.mintlify.app/contributing/release-process.md): How new Open Next Router versions are tagged and published.
- [Testing Guide](https://onr.mintlify.app/contributing/testing-guide.md): How to run Unit, E2E Mock, and Integration tests for Open Next Router.
- [Writing Providers](https://onr.mintlify.app/contributing/writing-providers.md): Add a new Native Provider adapter.
- [Auth Block](https://onr.mintlify.app/dsl/blocks/auth.md): Defining upstream authentication injection.
- [Balance Block](https://onr.mintlify.app/dsl/blocks/balance.md): Querying account balances from upstream APIs.
- [Error Block](https://onr.mintlify.app/dsl/blocks/error.md): Handling and normalizing provider failures.
- [Metrics Block](https://onr.mintlify.app/dsl/blocks/metrics.md): Extracting tokens and finish reasons for pricing.
- [Models Block](https://onr.mintlify.app/dsl/blocks/models.md): Configuring dynamic model listings.
- [Request Block](https://onr.mintlify.app/dsl/blocks/request.md): Mutating logic for inflight headers and JSON bodies.
- [Response Block](https://onr.mintlify.app/dsl/blocks/response.md): Transforming the upstream payload back to the client.
- [Upstream Block](https://onr.mintlify.app/dsl/blocks/upstream.md): Configuring the egress path and query parameters.
- [Upstream Config Block](https://onr.mintlify.app/dsl/blocks/upstream-config.md): Setting the base destination.
- [Conventions](https://onr.mintlify.app/dsl/conventions.md): Punctuation, naming rules, and basic syntax.
- [Expressions & Variables](https://onr.mintlify.app/dsl/expressions.md): Using built-in variables and simple expressions.
- [Include Directive](https://onr.mintlify.app/dsl/include.md): Reusing configuration fragments.
- [Match Rules](https://onr.mintlify.app/dsl/match.md): Conditional routing based on API endpoints.
- [DSL Overview](https://onr.mintlify.app/dsl/overview.md): Introduction to the Open Next Router syntax
- [Top-Level Structure](https://onr.mintlify.app/dsl/top-level.md): How a provider file is laid out.
- [ONR Admin & CLI Tools](https://onr.mintlify.app/ecosystem/admin-panel.md): The official web dashboard and command-line companion for Open Next Router.
- [Observability Stack](https://onr.mintlify.app/ecosystem/observability.md): Ready-to-use Grafana dashboards for metrics and tracing.
- [ONR Language Server (LSP)](https://onr.mintlify.app/ecosystem/onr-lsp.md): Rich DSL IDE support for VSCode & Neovim.
- [Installation](https://onr.mintlify.app/getting-started/install.md): Deploy Open Next Router natively, with Docker, Docker Compose, or Kubernetes.
- [Quickstart](https://onr.mintlify.app/getting-started/quickstart.md): From zero to a fully functional Open Next Router gateway in under 2 minutes.
- [Run From Source](https://onr.mintlify.app/getting-started/run-from-source.md): Run ONR locally for development.
- [Authentication Setup](https://onr.mintlify.app/guides/auth-setup.md): Securely route traffic and exchange tokens across various upstream providers.
- [Client Attribution](https://onr.mintlify.app/guides/client-attribution.md): Segmenting traffic and identifying upstream clients via the appname field.
- [Load Balancing & Fallbacks](https://onr.mintlify.app/guides/load-balancing.md): How to configure resilient clusters of LLM providers.
- [Logging and Masking](https://onr.mintlify.app/guides/logging-masking.md): Redacting sensitive user data in production.
- [Request/Response Rewriting](https://onr.mintlify.app/guides/request-response-rewriting.md): Modify headers, parameters, and JSON payloads inflight.
- [Open Next Router](https://onr.mintlify.app/index.md): Nginx-like, atomic DSL routing for modern AI providers.
- [Access Log Fields](https://onr.mintlify.app/reference/access-log-fields.md): All supported variables for logging.access_log_format.
- [CLI Reference](https://onr.mintlify.app/reference/cli.md): Main ONR CLI commands and usage.

## OpenAPI Specs

- [openapi](https://onr.mintlify.app/api-reference/openapi.json)