Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt

Use this file to discover all available pages before exploring further.

Auriko connects to OpenCode as a custom provider, giving you access to models from Anthropic, OpenAI, DeepSeek, Google, and more.

​
Prerequisites

​
Set your API key

export AURIKO_API_KEY="ak_live_..."
Add this line to ~/.zshrc or ~/.bashrc to persist it.

​
Configure OpenCode

Add Auriko as a provider in your opencode.json (at ~/.config/opencode/opencode.json or in your project root): 
{
  "$schema": "https://opencode.ai/config.json",
  "model": "auriko/claude-sonnet-4-6",
  "provider": {
    "auriko": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Auriko",
      "env": ["AURIKO_API_KEY"],
      "options": {
        "baseURL": "https://api.auriko.ai/v1",
        "apiKey": "{env:AURIKO_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "reasoning": true,
          "tool_call": true,
          "temperature": true,
          "limit": { "context": 1000000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "deepseek-v3.2": {
          "name": "DeepSeek V3.2",
          "reasoning": true,
          "tool_call": true,
          "temperature": true,
          "limit": { "context": 163840, "output": 8192 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash",
          "reasoning": true,
          "tool_call": true,
          "temperature": true,
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "audio", "video"], "output": ["text"] }
        }
      }
    }
  }
}
Add more models by inserting entries in the models object. Model IDs must match what Auriko’s /v1/models returns.

​
Verify

opencode run "Say exactly: setup-ok" --model auriko/claude-sonnet-4-6 --pure

​
Use different models

Switch models with the /models command. Notable models available through Auriko:
ModelAuthorContext
claude-sonnet-4-6Anthropic1M
claude-opus-4-7Anthropic1M
gpt-5.4-2026-03-05OpenAI1.05M
deepseek-v3.2DeepSeek164K
gemini-2.5-flashGoogle1M
grok-4.3xAI1M
kimi-k2.6Moonshot262K
qwen-3.6-plusAlibaba1M
To add a model to OpenCode, insert its definition in the models object of your opencode.json. You can find model capabilities and limits via the directory API.

​
Uninstall

Remove the "auriko" key from your opencode.json.

​
Troubleshooting

SymptomCauseFix
AURIKO_API_KEY is not setEnv var not exportedAdd export AURIKO_API_KEY="ak_live_..." to your shell profile, then source ~/.zshrc
Connection errorbaseURL wrong or has trailing slashUse exactly https://api.auriko.ai/v1
Config not taking effectLocal config overriding globalCheck both ~/.config/opencode/opencode.json (global) and ./opencode.json (project root)