Pular para o conteúdo principal
O Aider é uma ferramenta de programação em par com IA que edita seu repositório git local a partir do terminal. A Venice funciona por meio do suporte à API compatível com OpenAI do Aider — defina a URL base e a chave de API da Venice, e então adicione o prefixo openai/ ao ID do modelo.

Programação em par no terminal

Edite seu repositório git com modelos Venice a partir da CLI

Compatível com OpenAI

Usa o endpoint /chat/completions da Venice

Qualquer modelo de texto

Troque por qualquer ID de modelo de texto Venice

​
Pré-requisitos

  • Uma chave de API Venice em venice.ai/settings/api
  • Python 3.9+ disponível na sua máquina
  • Um repositório git para trabalhar

​
Configuração

1

Instale o Aider

Instale o Aider com o instalador oficial:
Consulte a documentação de instalação do Aider se preferir outro método de instalação.
2

Configure a Venice como endpoint OpenAI

Aponte o Aider para a Venice definindo a URL base compatível com OpenAI e sua chave de API Venice.Mac / Linux:
Windows (PowerShell):
Windows (Prompt de Comando, persistido):
Reinicie o terminal após o setx para que as novas variáveis fiquem disponíveis.
3

Inicie o Aider com um modelo Venice

A partir do diretório do seu projeto, adicione o prefixo openai/ ao ID do modelo Venice:
Outros bons modelos para começar:
Navegue por todos os IDs de modelos de texto no catálogo de modelos.

​
Persista a configuração com .env

Para uma configuração local do projeto, crie um arquivo .env na raiz do seu repositório git:
Depois inicie o Aider normalmente:
O Aider também lê o .env do seu diretório home. Os valores da raiz do repositório têm prioridade sobre os do diretório home. Mantenha este arquivo fora do git — adicione .env ao .gitignore se ele ainda não estiver ignorado.
Você também pode definir AIDER_OPENAI_API_BASE e AIDER_OPENAI_API_KEY. A documentação oficial do Aider ainda documenta OPENAI_API_BASE e OPENAI_API_KEY para provedores compatíveis com OpenAI.

​
Persista a configuração com YAML

Você pode armazenar as mesmas configurações em .aider.conf.yml na raiz do seu repositório ou no diretório home:
Depois execute:

​
Verifique a configuração

Depois que o Aider iniciar, peça algo simples que comprove que o modelo está acessível:
Se o endpoint e a chave estiverem corretos, o Aider fará streaming de uma resposta do modelo Venice selecionado. Você também pode confirmar a chave de API fora do Aider:

​
Escolhendo modelos

Sempre adicione o prefixo openai/ aos IDs de modelo Venice ao iniciar o Aider. Sem esse prefixo, o Aider não roteará a requisição pelo caminho do provedor compatível com OpenAI. Descubra os IDs de modelo atuais em tempo de execução:
Ou verifique GET /models/traits para padrões como text:default.

​
Notas de configuração

  • Mantenha OPENAI_API_BASE definido como https://api.venice.ai/api/v1. Não anexe /chat/completions; o Aider adiciona o caminho do chat automaticamente.
  • Use uma chave de API Venice em OPENAI_API_KEY. Não use uma chave OpenAI com a URL base da Venice.
  • O Aider pode avisar que o modelo tem janela de contexto ou custo desconhecidos. Esse aviso é esperado para muitos IDs de modelo Venice e geralmente pode ser ignorado. Veja Avisos de modelo do Aider.
  • Prefira modelos capazes de codificação/raciocínio para edições em múltiplos arquivos. Modelos menores ou não voltados a código podem ter dificuldade com os formatos de edição do Aider.
Definir OPENAI_API_BASE e OPENAI_API_KEY no seu shell também afeta outras ferramentas que leem essas variáveis. Prefira um .env do projeto ou .aider.conf.yml se você usa OpenAI em outros lugares no mesmo ambiente.

​
Solução de problemas

Confirme que OPENAI_API_KEY é uma chave Venice de venice.ai/settings/api, sem espaços extras. No Windows, após setx, reinicie o terminal.
Confirme que o ID do modelo existe no catálogo de modelos de texto e que você iniciou o Aider com o prefixo openai/, por exemplo openai/zai-org-glm-5-1.
Verifique se OPENAI_API_BASE está exatamente https://api.venice.ai/api/v1 na mesma sessão de shell. Imprima com echo $OPENAI_API_BASE (ou $env:OPENAI_API_BASE no PowerShell).
Esperado para muitos modelos Venice. O Aider recorre a padrões razoáveis. Para silenciá-lo, adicione metadados do modelo conforme descrito em Configurações avançadas de modelo do Aider.

​
Recursos

Modelos de texto Venice

Navegue pelos IDs de modelo Venice disponíveis

Documentação compatível com OpenAI do Aider

Configuração oficial de provedor do Aider

Configuração do Aider com .env

Persista chaves de API e configurações de modelo

Referência da API Venice

Documentação completa de endpoints e parâmetros