twinny

O twinny não tem campo de URL base — Add provider → OpenAI-compatible server, depois Protocol https, Hostname api.kunavo.com, Port em branco e API path /v1; o painel de chat usa sua chave.

Label          Kunavo
Type           Chat
Provider       OpenAI-compatible server
Hostname       api.kunavo.com
Port           (leave blank — "Blank means the protocol's default")
Protocol       https
API path       /v1
Model name     claude-sonnet-5
FIM template   (Autocomplete only — not part of a Chat provider)
API key        sk-kn-...

Passo a passo

1. Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
2. Abra a aba Providers pelo ícone do robô na parte superior da barra lateral ou execute Manage twinny providers na paleta de comandos.
3. Add provider → em On your machine, escolha OpenAI-compatible server, a predefinição genérica. Ela já vem apontada para localhost:8080.
4. Defina Protocol como https, Hostname como api.kunavo.com, limpe Port e defina API path como /v1. Mantenha Type em Chat.
5. Cole a chave em API key — o twinny a envia como Authorization: Bearer. Em seguida, defina Model name, digitando-o ou usando Choose from the server's models, já que a Kunavo atende GET /v1/models.
6. Pressione Test provider e, em seguida, Use this provider para torná-lo o provedor de chat ativo. Use Copy para duplicar a linha para um segundo modelo, em vez de digitar novamente os quatro campos do endpoint.

Verificado em a página Other local servers do twinny em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em twinny.

# 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-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

O chat funciona. A conclusão automática e o índice, não.

O twinny divide o trabalho entre três tipos de provedor, e cada um é configurado separadamente — portanto, “o twinny funciona com a Kunavo” só é verdade para um deles. Os outros dois não são uma configuração que você ainda não encontrou; as rotas de que precisam não são atendidas pela Kunavo.

Nenhuma dessas lacunas impede a configuração, pois o twinny mantém um provedor ativo por tipo, e eles são independentes entre si. A própria página de APIs hospedadas do twinny chama essa divisão de “uma configuração comum”: um modelo base local pequeno para conclusão, junto com um modelo hospedado para chat, revisão e edição. O índice do espaço de trabalho segue a mesma lógica — a etapa de embeddings não é atendida aqui, e a documentação do twinny recomenda usar para isso um modelo local, como nomic-embed-text no Ollama. Vetores de modelos diferentes não se misturam; portanto, mudar esse modelo exige recriar o índice, e não apenas atualizá-lo.