Info:: aider: utilisation d'une LLM en mode CLI (comme Claude code)

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: AIDER, CLAUDE CODE

Le 03/06/2026:

Aider + Ollama — Assistant de développement CLI local

{{#if:Aider + Ollama|

Aider + Ollama

{{#if:aider-chat (dernière stable), Ollama ≥ 0.3|

Version aider-chat (dernière stable), Ollama ≥ 0.3

}}{{#if:Debian 13 (Trixie)|

OS Debian 13 (Trixie)

}}{{#if:NVIDIA RTX 3060 12 GB (srv18)|

Matériel NVIDIA RTX 3060 12 GB (srv18)

}}{{#if:PCStreet|

Auteur PCStreet

}}{{#if:Juin 2026|

Date Juin 2026

}}{{#if:|

{{{description}}}

}}

}}

Présentation

Aider est un assistant de développement en ligne de commande (CLI) open-source, similaire à Claude Code, mais conçu pour fonctionner avec n'importe quel LLM, y compris les modèles locaux via Ollama.

Il permet d'éditer des fichiers sources directement depuis le terminal, avec :

  • Lecture et modification multi-fichiers automatique (diff/apply)
  • Intégration Git optionnelle (commits automatiques ou manuels)
  • Exécution de commandes shell en cours de session
  • Support natif d'Ollama via l'API REST locale

Dans la configuration PCStreet, Aider utilise le modèle qwen3:14b déjà déployé pour Open-WebUI, sans conflit VRAM (un seul processus GPU partagé).

Architecture du système

┌─────────────────────────────────────────────────────┐
│                      srv18                          │
│                                                     │
│  ┌──────────┐   HTTP      ┌─────────────────────┐   │
│  │  Aider   │────────────►│  Ollama :11434      │   │
│  │  (CLI)   │             │  qwen3-aider (14b)  │   │
│  └──────────┘             └──────────┬──────────┘   │
│                                      │ CUDA          │
│  ┌──────────┐   HTTP                 ▼               │
│  │Open-WebUI│────────────►  RTX 3060 12 GB VRAM      │
│  └──────────┘             (modèle chargé une fois)   │
└─────────────────────────────────────────────────────┘

Open-WebUI et Aider partagent le même modèle en VRAM. Ollama sérialise les requêtes : pas de conflit, pas de swap.

Installation

Prérequis

apt install python3-pip python3-venv git

Environnement Python isolé

python3 -m venv /opt/aider
source /opt/aider/bin/activate
pip install aider-chat

Exposer l'exécutable globalement :

ln -s /opt/aider/bin/aider /usr/local/bin/aider

Vérification :

aider --version

Configuration

Fichier de configuration global

Chemin : ~/.aider.conf.yml

# Modèle Ollama dédié Aider
model: ollama/qwen3-aider

# URL de l'API Ollama
ollama-api-base: http://127.0.0.1:11434

# Pas de commit automatique (contrôle manuel)
auto-commits: false
dirty-commits: false

# Éditeur de messages
vim: true

# Thème terminal sombre
dark-mode: true

# Limite la repo-map pour préserver la VRAM
map-tokens: 1024

# Désactiver la télémétrie
analytics: false

# Historique des sessions
chat-history-file: ~/.aider/.aider.chat.history.md

Modèle Ollama dédié

Un Modelfile spécifique optimise les paramètres pour l'usage Aider.

mkdir -p /root/Modelfiles
vim /root/Modelfiles/qwen3-aider.Modelfile
FROM qwen3:14b

# Contexte réduit pour préserver la VRAM résiduelle
PARAMETER num_ctx 8192

# Maintien en VRAM entre les requêtes (évite les rechargements)
PARAMETER keep_alive -1

# Mode thinking désactivé pour les tâches de code (plus rapide)
PARAMETER think false

Création du modèle :

ollama create qwen3-aider -f /root/Modelfiles/qwen3-aider.Modelfile

Vérification :

ollama list | grep qwen3-aider

Script de lancement

Chemin : /usr/local/bin/aider-start

#!/bin/bash
set -euo pipefail

# Vérifie qu'Ollama répond
if ! curl -sf http://127.0.0.1:11434/api/tags > /dev/null; then
    echo "[ERR] Ollama ne répond pas sur :11434" >&2
    exit 1
fi

# Active le venv
source /opt/aider/bin/activate

# Répertoire projet passé en argument, ou répertoire courant
PROJECT_DIR="${1:-$(pwd)}"
cd "$PROJECT_DIR"

echo "[INFO] Aider démarré dans : $PROJECT_DIR"
echo "[INFO] Modèle : qwen3-aider (Ollama local)"

aider
chmod +x /usr/local/bin/aider-start

Utilisation

Démarrage d'une session

# Démarrage dans le répertoire courant
cd /root/monprojet
aider-start

# Avec des fichiers préchargés en contexte
aider src/ClassDatabase.cpp include/ClassDatabase.h

# Question ponctuelle sans modifier de fichier (mode one-shot)
aider --message "Explique le rôle de ClassFileIndexer::sync()"

Commandes internes (dans la session)

Commande Description
/add fichier.cpp Ajouter un fichier au contexte
/drop fichier.cpp Retirer un fichier du contexte (libère le contexte)
/files Lister les fichiers actuellement en contexte
/run make -j4 Exécuter une commande shell sans quitter Aider
/clear Vider l'historique de la session en cours
/diff Afficher les modifications effectuées depuis le début
/undo Annuler le dernier commit Aider (si auto-commits activé)
/help Afficher l'aide complète
/exit ou Ctrl+D Quitter la session

Exemple de workflow C++

cd /root/pcFsWithPostgres
aider src/ClassDatabase.cpp include/ClassDatabase.h

Exemples de prompts dans la session :

> Ajoute une méthode getFileCount() qui retourne le nombre de fichiers indexés

> Écris la déclaration correspondante dans le header

> /run cmake --build build/ -j4

> Corrige l'erreur de compilation affichée ci-dessus

> /drop src/ClassAuditLogParser.cpp

Gestion de la VRAM (RTX 3060 12 GB)

Composant VRAM utilisée
qwen3:14b (ou qwen3-aider) ~9–10 GB
Contexte Ollama (num_ctx 8192) ~1–1.5 GB
Marge disponible ~0.5–1.5 GB

Points de vigilance :

  • Ne pas charger un second modèle lourd simultanément
  • Si la session Aider devient lente, réduire le contexte avec /drop
  • Le paramètre map-tokens: 1024 dans la config limite la repo-map automatique
  • keep_alive -1 maintient le modèle en VRAM : ne pas oublier qu'il occupe
 de la mémoire même quand Aider est fermé

Vérification de l'état VRAM :

nvidia-smi --query-gpu=memory.used,memory.free --format=csv

Pièges courants

Contexte saturé
Si les fichiers en contexte sont trop volumineux, le modèle tronque les réponses.
 Utiliser /drop pour retirer les fichiers non nécessaires.
Modèle non chargé au démarrage
Aider démarre la requête avant qu'Ollama ait fini de charger le modèle.
 Le script aider-start vérifie la disponibilité de l'API avant de lancer.
Modifications non souhaitées
Avec auto-commits: false, Aider modifie les fichiers sur disque mais ne commite pas.
 Toujours vérifier le diff avant d'accepter (/diff).
keep_alive et consommation mémoire
keep_alive -1 signifie que le modèle ne se décharge jamais automatiquement.
 Pour le décharger manuellement :
curl -X POST http://127.0.0.1:11434/api/generate \
     -d '{"model":"qwen3-aider","keep_alive":0}'

Références