Vai al contenuto principale
Aider è uno strumento di pair programming AI che modifica il tuo repository git locale dal terminale. Venice funziona tramite il supporto dell’API compatibile con OpenAI di Aider — imposta il base URL e la API key di Venice, poi anteponi openai/ all’ID del modello.

Pair programming nel terminale

Modifica il tuo repo git con i modelli Venice dalla CLI

Compatibile con OpenAI

Usa l’endpoint /chat/completions di Venice

Qualsiasi modello di testo

Sostituisci con qualsiasi ID di modello di testo Venice

​
Prerequisiti

  • Una API key Venice da venice.ai/settings/api
  • Python 3.9+ disponibile sulla tua macchina
  • Un repository git in cui lavorare

​
Configurazione

1

Installa Aider

Installa Aider con l’installer ufficiale:
Consulta la documentazione di installazione di Aider se preferisci un altro metodo di installazione.
2

Configura Venice come endpoint OpenAI

Punta Aider a Venice impostando il base URL compatibile con OpenAI e la tua API key Venice.Mac / Linux:
Windows (PowerShell):
Windows (Prompt dei comandi, persistente):
Riavvia il terminale dopo setx in modo che le nuove variabili siano disponibili.
3

Avvia Aider con un modello Venice

Dalla directory del tuo progetto, anteponi openai/ all’ID del modello Venice:
Altri buoni modelli per iniziare:
Sfoglia tutti gli ID dei modelli di testo nel catalogo dei modelli.

​
Persistere la configurazione con .env

Per una configurazione locale al progetto, crea un file .env nella root del tuo repo git:
Poi avvia Aider normalmente:
Aider legge anche .env dalla tua home directory. I valori nella root del repo hanno priorità su quelli della home directory. Tieni questo file fuori da git — aggiungi .env a .gitignore se non è già ignorato.
Puoi anche impostare AIDER_OPENAI_API_BASE e AIDER_OPENAI_API_KEY. La documentazione ufficiale di Aider continua a documentare OPENAI_API_BASE e OPENAI_API_KEY per i provider compatibili con OpenAI.

​
Persistere la configurazione con YAML

Puoi memorizzare le stesse impostazioni in .aider.conf.yml nella root del repo o nella home directory:
Poi esegui:

​
Verifica la configurazione

Dopo l’avvio di Aider, chiedigli qualcosa di semplice che dimostri che il modello è raggiungibile:
Se l’endpoint e la chiave sono corretti, Aider trasmette in streaming una risposta dal modello Venice selezionato. Puoi anche confermare la API key al di fuori di Aider:

​
Scelta dei modelli

Anteponi sempre openai/ agli ID dei modelli Venice quando avvii Aider. Senza quel prefisso, Aider non instraderà la richiesta attraverso il path del provider compatibile con OpenAI. Scopri gli ID dei modelli attuali a runtime:
Oppure consulta GET /models/traits per i default come text:default.

​
Note di configurazione

  • Mantieni OPENAI_API_BASE impostato su https://api.venice.ai/api/v1. Non aggiungere /chat/completions; Aider aggiunge da sé il path della chat.
  • Usa una API key Venice in OPENAI_API_KEY. Non usare una chiave OpenAI con il base URL di Venice.
  • Aider potrebbe avvisare che il modello ha una context window o un costo sconosciuti. Questo avviso è previsto per molti ID di modelli Venice e di solito può essere ignorato senza problemi. Consulta gli avvisi sui modelli di Aider.
  • Preferisci modelli capaci di coding/reasoning per modifiche multi-file. Modelli più piccoli o non orientati al coding possono avere difficoltà con i formati di edit di Aider.
Impostare OPENAI_API_BASE e OPENAI_API_KEY nella tua shell influisce anche su altri strumenti che leggono queste variabili. Preferisci un .env di progetto o un .aider.conf.yml se usi OpenAI altrove nello stesso ambiente.

​
Risoluzione dei problemi

Verifica che OPENAI_API_KEY sia una chiave Venice da venice.ai/settings/api, senza spazi extra. Su Windows, dopo setx, riavvia il terminale.
Verifica che l’ID del modello esista nel catalogo dei modelli di testo e che tu abbia avviato Aider con il prefisso openai/, per esempio openai/zai-org-glm-5-1.
Controlla che OPENAI_API_BASE sia esattamente https://api.venice.ai/api/v1 nella stessa sessione di shell. Stampalo con echo $OPENAI_API_BASE (o $env:OPENAI_API_BASE in PowerShell).
È previsto per molti modelli Venice. Aider ricade su default ragionevoli. Per silenziarlo, aggiungi i metadata del modello come descritto in Aider advanced model settings.

​
Risorse

Modelli di testo Venice

Sfoglia gli ID dei modelli Venice disponibili

Documentazione Aider compatibile con OpenAI

Configurazione ufficiale del provider Aider

Configurazione Aider con .env

Persisti API key e impostazioni del modello

Riferimento API Venice

Documentazione completa di endpoint e parametri