Search docs...

Start typing to search documentation

librechat
LibreChat

LibreChat Integration Guide

Connect UnoRouter to LibreChat through a custom OpenAI-compatible endpoint.

Overview

LibreChat exposes any OpenAI-compatible host through endpoints.custom. Add a UnoRouter block, set the env var, and the model picker auto-fills from the catalog.

Quick Config

Drop these values into the client. Your key auto-fills when you are signed in.

text
Base URL: https://api.unorouter.ai/v1
API Key: YOUR_API_KEY

Sign in to auto-fill your API key

Compatibility

Chat CompletionsStreamingTool calling

Step-by-step setup

  1. 1
    Edit librechat.yaml

    In your LibreChat install, add a custom endpoint block under endpoints.custom.

    yaml
    endpoints:
      custom:
        - name: 'UnoRouter'
          apiKey: '${UNOROUTER_API_KEY}'
          baseURL: 'https://api.unorouter.ai/v1'
          models:
            fetch: true
          titleConvo: true
          modelDisplayLabel: 'UnoRouter'

    Sign in to auto-fill your API key

  2. 2
    Add the env var

    Set your UnoRouter API key in the LibreChat .env file.

    bash
    UNOROUTER_API_KEY=YOUR_API_KEY

    Sign in to auto-fill your API key

  3. 3
    Restart LibreChat

    Restart the container or process. The UnoRouter endpoint appears in the chat dropdown.

Recommended models

Free models that work well here. Paste any model id into the client.

c4ai-aya-expanse-32bhermes-3-llama-3.1-405bgemini-2.5-flash-liteglm-4.7mistral-medium-latest

Gotchas

  • Use single-brace syntax for env-var values, not the secrets syntax some other configs use.
  • If a model rejects extra OpenAI params, add them to dropParams (for example frequency_penalty and presence_penalty).
  • fetch: true auto-populates from the UnoRouter catalog. Combine it with default to surface preferred models first.
Generate API KeyModels