Aider

Aider est un assistant de programmation en ligne de commande qui travaille directement dans votre dépôt Git. Il se branche sur CloudZIR via son mode « OpenAI compatible ».

Installation#

python -m pip install aider-install
aider-install

Configuration#

export OPENAI_API_BASE="https://api.cloudzir.com/v1"
export OPENAI_API_KEY="zir_ai_..."

cd mon-projet
aider --model openai/mina-full

$env:OPENAI_API_BASE = "https://api.cloudzir.com/v1"
$env:OPENAI_API_KEY = "zir_ai_..."

cd mon-projet
aider --model openai/mina-full

Le préfixe openai/ indique à Aider d'utiliser le protocole OpenAI ; le nom réel du modèle reste mina-full.

Configuration permanente#

Dans .aider.conf.yml, à la racine du projet ou dans votre dossier personnel :

openai-api-base: https://api.cloudzir.com/v1
model: openai/mina-full
weak-model: openai/mina-flash
edit-format: diff
show-model-warnings: false

Et la clé dans .env (à exclure de Git) :

OPENAI_API_KEY=zir_ai_...

weak-model

Aider utilise un « petit » modèle pour les messages de commit et les résumés d'historique. Le fixer à mina-flash évite de payer le tarif du modèle principal pour ces tâches secondaires.

Décrire les capacités du modèle#

Aider affiche un avertissement quand il ne connaît pas un modèle. Pour le renseigner, créez .aider.model.settings.yml :

- name: openai/mina-full
  edit_format: diff
  use_repo_map: true
  send_undo_reply: false

- name: openai/mina-flash
  edit_format: whole
  use_repo_map: false

Vérifier#

aider --model openai/mina-flash --message "explique le rôle du fichier README"

La requête doit apparaître dans Usage.

Conseils#

La repo map d'Aider ajoute du contexte à chaque requête : sur un gros dépôt, limitez-la (--map-tokens 1024) pour contenir le coût.
/add uniquement les fichiers nécessaires : chaque fichier ajouté est renvoyé intégralement à chaque tour.
edit-format: diff réduit fortement les jetons de sortie par rapport au mode whole.

Limites connues#

Le mode architect fonctionne : déclarez simplement deux modèles CloudZIR (--architect --model openai/mina-full --editor-model openai/mina-low).