config.example.yml

# Minimal standalone Otari configuration.
# See docs/configuration.md for sources, precedence, and advanced settings.

# Docker Compose provides this PostgreSQL service. For a local process without
# Docker, use sqlite:///./otari.db.
database_url: "postgresql://otari:otari@postgres:5432/otari"

host: "0.0.0.0"
port: 8000

# Deployment-wide management credential. Applications should use API keys.
master_key: YOUR_MASTER_KEY_HERE

# Common models use the bundled genai-prices snapshot when no stored price
# exists. Explicit database pricing always wins.
default_pricing: true
require_pricing: true

providers:
  openai:
    api_key: YOUR_OPENAI_API_KEY_HERE
    # api_base: "https://api.openai.com/v1"

  # A named OpenAI-compatible backend. The optional model list supplies
  # discovery when the backend has no /v1/models endpoint.
  # home_lab:
  #   provider_type: openai
  #   api_base: "https://models.example.com/v1"
  #   api_key: ${HOME_LAB_TOKEN}
  #   models: [qwen3-32b]

  # Keyless local backends need an entry only for discovery.
  # ollama:
  #   api_base: "http://host.docker.internal:11434"

# Explicit prices use USD per million tokens. They override default pricing.
# pricing:
#   openai:gpt-5:
#     input_price_per_million: 1.25
#     output_price_per_million: 10.00

# Stable caller-facing model names.
# aliases:
#   fast: openai:gpt-5-mini

# Failover and conditional routing. See docs/routing.md.
# routing:
#   enabled: true
#   policies:
#     fast:
#       select:
#         - default: openai:gpt-5-mini
#       on_failure:
#         - anthropic:claude-haiku-4-5

# Optional server controls.
# rate_limit_rpm: 60
# enable_metrics: true
# cors_allow_origins:
#   - "https://app.example.com"

# Provider and search credentials stored through the dashboard require
# OTARI_SECRET_KEY in the process environment.

# Optional email delivery. public_base_url is also used by passkeys and OAuth.
# public_base_url: "https://otari.example.com"
# mail_transport: smtp
# smtp_host: "smtp.example.com"
# smtp_port: 587
# smtp_user: ${SMTP_USER}
# smtp_password: ${SMTP_PASSWORD}
# smtp_tls: true
# mail_from_email: "otari@example.com"
# mail_from_name: "Otari"

# Passkeys default to the host of public_base_url. Set these only for a parent
# relying-party domain or multiple permitted dashboard origins.
# webauthn_rp_id: "example.com"
# webauthn_allowed_origins:
#   - "https://otari.example.com"

# File and image normalization. See docs/files.md.
# files_enabled: true
# files_local_dir: "./otari-files"
# files_max_bytes: 536870912
# files_retention_hours: 168
# vision_strategy: describe
# vision_describe_model: "ollama:qwen2-vl"
# model_capabilities:
#   "ollama:qwen2-vl":
#     supports_image: true
#     supports_pdf: false

# Direct search tools. Model-initiated web search uses web_search_url instead.
# See docs/tools.md.
# search_tools:
#   local:
#     provider: searxng
#     api_base: "http://searxng:8080"