Nanocoder

A Custom Provider entry under nanocoder.providers in agents.config.json — name, baseUrl, apiKey, models — with no sdkProvider line needed, since it defaults to openai-compatible.

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

Step by step

1. Create a key at /app/keys and copy it — it is shown once. Export it as KUNAVO_API_KEY rather than pasting it into the file: Nanocoder substitutes $VAR, ${VAR} and ${VAR:-default} recursively through every string in a provider entry, and reads .env from the working directory.
2. Run /settings providers inside Nanocoder and pick Custom Provider. The wizard asks, in its own order, for Provider name, Base URL, API key (optional), Model names and Request timeout, and it offers to fetch the model list from the endpoint — Kunavo answers GET /v1/models, so that fetch populates itself.
3. Or skip the wizard and write agents.config.json yourself with the block above. Note that settings resolve file by file: a project-level file that defines nanocoder.providers supplies that whole block, so entries in your global config are not merged in beside it.
4. Set a context window. Nanocoder resolves the limit from /context-max, then contextWindows[model], then contextWindow, then NANOCODER_CONTEXT_LIMIT, then models.dev — and Kunavo is not a models.dev provider, so without one of the first four it budgets against a fallback that is not your model's. The numbers are on /models.
5. Open /model, choose one of the ids you listed — the picker shows them under the name you gave — and run something small that has to call a tool. If tool calls come back malformed on a particular model, disableToolModels narrows that off per model rather than per provider.

Checked against Nanocoder's Custom Provider page on September 21, 2026. Third-party settings move; if a field name here no longer matches what you see, that page is the authority, not this one.

Verify before you debug the client

One request settles whether a failure is the endpoint, the key, or the configuration file. If this returns JSON, the same base URL and key work in Nanocoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Which model id to put in the field

Every text model is reachable as a model id — the live list is GET /v1/models, and the catalog with prices is on the models page. Rates are USD per 1M tokens, input / output.