Passer au contenu principal
Aider est un outil de pair-programming IA qui édite votre dépôt git local depuis le terminal. Venice fonctionne grâce à la prise en charge de l’API compatible OpenAI d’Aider — définissez l’URL de base et la clé API Venice, puis préfixez l’ID du modèle avec openai/.

Pair programming en terminal

Éditez votre dépôt git avec les modèles Venice depuis la CLI

Compatible OpenAI

Utilise l’endpoint /chat/completions de Venice

N'importe quel modèle de texte

Permutez avec n’importe quel ID de modèle de texte Venice

​
Prérequis

  • Une clé API Venice depuis venice.ai/settings/api
  • Python 3.9+ disponible sur votre machine
  • Un dépôt git dans lequel travailler

​
Configuration

1

Installez Aider

Installez Aider avec l’installateur officiel :
Consultez la documentation d’installation d’Aider si vous préférez une autre méthode d’installation.
2

Configurez Venice comme endpoint OpenAI

Pointez Aider vers Venice en définissant l’URL de base compatible OpenAI et votre clé API Venice.Mac / Linux :
Windows (PowerShell) :
Windows (invite de commandes, persisté) :
Redémarrez le terminal après setx pour que les nouvelles variables soient disponibles.
3

Démarrez Aider avec un modèle Venice

Depuis le répertoire de votre projet, préfixez l’ID de modèle Venice avec openai/ :
Autres bons modèles de départ :
Parcourez tous les ID de modèles de texte dans le catalogue de modèles.

​
Persister la configuration avec .env

Pour une configuration locale au projet, créez un fichier .env à la racine de votre dépôt git :
Puis démarrez Aider normalement :
Aider lit également .env depuis votre répertoire personnel. Les valeurs à la racine du dépôt ont priorité sur celles du répertoire personnel. Gardez ce fichier hors de git — ajoutez .env à .gitignore s’il n’est pas déjà ignoré.
Vous pouvez également définir AIDER_OPENAI_API_BASE et AIDER_OPENAI_API_KEY. La documentation officielle d’Aider documente toujours OPENAI_API_BASE et OPENAI_API_KEY pour les fournisseurs compatibles OpenAI.

​
Persister la configuration avec YAML

Vous pouvez stocker les mêmes paramètres dans .aider.conf.yml à la racine de votre dépôt ou dans votre répertoire personnel :
Puis exécutez :

​
Vérifier la configuration

Une fois Aider démarré, demandez-lui quelque chose de simple qui prouve que le modèle est joignable :
Si l’endpoint et la clé sont corrects, Aider stream une réponse depuis le modèle Venice sélectionné. Vous pouvez aussi confirmer la clé API en dehors d’Aider :

​
Choisir des modèles

Cas d’usageExemple d’ID de modèleFlag Aider
Codage / refactoring performantzai-org-glm-5-1--model openai/zai-org-glm-5-1
Itération rapideminimax-m25--model openai/minimax-m25
Codage à long contextekimi-k2-5--model openai/kimi-k2-5
Chat non censurévenice-uncensored--model openai/venice-uncensored
Préfixez toujours les ID de modèles Venice avec openai/ lors du lancement d’Aider. Sans ce préfixe, Aider ne routera pas la requête via le chemin du fournisseur compatible OpenAI. Découvrez les ID de modèles actuels à l’exécution :
Ou consultez GET /models/traits pour les valeurs par défaut telles que text:default.

​
Notes de configuration

  • Gardez OPENAI_API_BASE défini à https://api.venice.ai/api/v1. N’ajoutez pas /chat/completions ; Aider ajoute lui-même le chemin de chat.
  • Utilisez une clé API Venice dans OPENAI_API_KEY. N’utilisez pas de clé OpenAI avec l’URL de base Venice.
  • Aider peut avertir que le modèle a une fenêtre de contexte ou un coût inconnu. Cet avertissement est attendu pour de nombreux ID de modèles Venice et peut généralement être ignoré. Voir avertissements de modèle Aider.
  • Préférez des modèles de codage/raisonnement performants pour les éditions multi-fichiers. Les modèles plus petits ou non spécialisés en codage peuvent avoir des difficultés avec les formats d’édition d’Aider.
Définir OPENAI_API_BASE et OPENAI_API_KEY dans votre shell affecte aussi d’autres outils qui lisent ces variables. Préférez un .env de projet ou un .aider.conf.yml si vous utilisez OpenAI ailleurs dans le même environnement.

​
Dépannage

Vérifiez que OPENAI_API_KEY est une clé Venice provenant de venice.ai/settings/api, sans espace superflu. Sur Windows après setx, redémarrez le terminal.
Vérifiez que l’ID de modèle existe dans le catalogue de modèles de texte et que vous avez lancé Aider avec le préfixe openai/, par exemple openai/zai-org-glm-5-1.
Vérifiez que OPENAI_API_BASE vaut exactement https://api.venice.ai/api/v1 dans la même session shell. Affichez-le avec echo $OPENAI_API_BASE (ou $env:OPENAI_API_BASE dans PowerShell).
Attendu pour de nombreux modèles Venice. Aider retombe sur des valeurs par défaut raisonnables. Pour le faire taire, ajoutez des métadonnées de modèle comme décrit dans les paramètres avancés de modèles Aider.

​
Ressources

Modèles de texte Venice

Parcourez les ID de modèles Venice disponibles

Documentation compatible OpenAI d'Aider

Configuration officielle du fournisseur Aider

Configuration Aider avec .env

Persistez les clés API et les paramètres de modèle

Référence API Venice

Documentation complète des endpoints et paramètres