Hoe Aider op te zetten: Een Praktische Gids

TL;DR

• Installeer Aider met pip install aider-chat en configureer een LLM API-sleutel (OpenAI/Anthropic/Ollama).
• Voeg bestanden toe aan de context met /add <bestand> of /add --all voor volledige repository-bewustzijn.
• Gebruik /diff voor precieze wijzigingen, /whole voor volledige bestandsherschrijvingen en /architect voor multi-bestandsrefactoring.
• Git-integratie voert automatisch commits uit met beschrijvende berichten.
• Configureer .aider.conf.yml om modelinstellingen en standaardgedrag op te slaan.

1. Installatie en Modelconfiguratie

Installeer Aider

# macOS/Linux (Python 3.9+ vereist)
python -m pip install --upgrade aider-chat

# Windows (PowerShell)
python -m pip install --upgrade aider-chat

# Verifieer installatie
aider --version
# Verwachte uitvoer: aider 0.36.0

Let op: Als u een command not found-foutmelding krijgt, zorg er dan voor dat ~/.local/bin in uw PATH staat:

export PATH=$PATH:~/.local/bin  # Voeg toe aan ~/.bashrc of ~/.zshrc

Stel een LLM in

Aider ondersteunt OpenAI, Anthropic, Mistral en lokale modellen via Ollama. Kies één van de volgende opties:

Optie 1: OpenAI (GPT-4o)

1. Verkrijg een OpenAI API-sleutel.
2. Stel de sleutel in als omgevingsvariabele:

   export OPENAI_API_KEY="uw-sleutel-hier"
   

   Copy
3. Start Aider:

   aider
   

   Copy

Optie 2: Anthropic (Claude 3.5 Sonnet)

1. Verkrijg een Anthropic API-sleutel.
2. Stel de sleutel en het model in:

   export ANTHROPIC_API_KEY="uw-sleutel-hier"
   aider --model claude-3-5-sonnet-20240620
   

   Copy

Optie 3: Lokale Modellen (Ollama)

1. Installeer Ollama en download een model:

   ollama pull llama3
   

   Copy
2. Start Aider met het lokale model:

   aider --model ollama/llama3
   

   Copy

Verwachte Uitvoer:

Aider v0.36.0
Model: claude-3-5-sonnet-20240620 met diff-bewerkingsformaat
Git-repo: .git met 12 bestanden
Repo-map: gebruikt 1,2MB van 2,0MB
Gebruik /help om in-chat commando's te zien.

2. Bestanden Toevoegen aan de Context

Aider moet uw code "zien" om deze te kunnen bewerken. Gebruik deze commando's in de chat:

Voorbeeld Workflow:

# Start Aider in uw projectdirectory
cd ~/projects/my-app
aider

# Voeg belangrijke bestanden toe aan de context
/add src/utils.py
/add tests/test_utils.py

Let op: Grote repositories (10K+ bestanden) kunnen Aider vertragen. Gebruik /add selectief voor bestanden die relevant zijn voor uw taak.

3. Bewerkingsmodi

Aider biedt drie bewerkingsmodi. Kies op basis van precisiebehoeften:

1. /diff (Standaard)

• Toont een diff van voorgestelde wijzigingen voordat deze worden toegepast.
• Geschikt voor kleine, precieze bewerkingen.

Voorbeeld:

Gebruiker: /diff
Aider: Beschrijf de wijziging die u wilt...
Gebruiker: Refactor de `validate_input`-functie om vroege returns te gebruiken.

Verwachte Uitvoer:

- def validate_input(data):
-     if not data:
-         return False
-     if len(data) > 100:
-         return False
-     return True
+ def validate_input(data):
+     if not data:
+         return False
+     if len(data) > 100:
+         return False
+     return True

Typ y om de wijzigingen toe te passen.

2. /whole

• Herschrijft het volledige bestand.
• Gebruik voor grote refactoring of wanneer /diff te beperkend is.

Voorbeeld:

Gebruiker: /whole src/utils.py
Aider: Welke wijzigingen wilt u aan dit bestand aanbrengen?
Gebruiker: Herschrijf het bestand om type hints te gebruiken en docstrings toe te voegen.

3. /architect

• Multi-bestandsrefactoring met hoog niveau begeleiding.
• Geschikt voor wijzigingen over meerdere bestanden (bijv. "Verplaats de authenticatielogica naar een nieuwe module").

Voorbeeld:

Gebruiker: /architect
Aider: Welke architectonische wijziging wilt u aanbrengen?
Gebruiker: Splits het monolithische `handlers.py` op in aparte bestanden per route.

4. Git-integratie en Automatische Commits

Aider voert automatisch commits uit met beschrijvende berichten. Configureer dit in .aider.conf.yml:

# .aider.conf.yml
git:
  auto_commits: true
  commit_message: "aider: {message}"  # Pas het commit-berichtformaat aan

Commando's:

Let op: Automatische commits kunnen uw geschiedenis rommelig maken. Gebruik /commit voor handmatige controle of squash later:

git rebase -i HEAD~5  # Squash aider-commits

5. Lokale Modellen Gebruiken via Ollama

Voor privacy of kostenbesparing kunt u lokale modellen gebruiken:

1. Installeer Ollama en download een model:

   ollama pull codellama:7b
   

   Copy
2. Start Aider met het lokale model:

   aider --model ollama/codellama:7b
   

   Copy
3. (Optioneel) Configureer standaardinstellingen in .aider.conf.yml:

   model: ollama/codellama:7b
   

   Copy

Prestatietip: Gebruik kleinere modellen (bijv. codellama:7b) voor snellere reacties, maar verwacht minder nauwkeurigheid dan GPT-4o.

6. Multi-Bestand Bewerkingsworkflows

Aider blinkt uit in wijzigingen over meerdere bestanden. Voorbeeld:

Taak: Logging Toevoegen aan een Module

1. Voeg relevante bestanden toe aan de context:

   /add src/app.py
   /add src/utils/logger.py
   

   Copy
2. Beschrijf de wijziging:

   Voeg debug-logging toe aan alle functies in `app.py`. Gebruik de logger uit `utils/logger.py`.
   

   Copy
3. Aider zal:
   • De logger importeren in app.py.
   • logger.debug()-aanroepen toevoegen aan elke functie.
   • logger.py bijwerken indien nodig (bijv. een debug-methode toevoegen).

Let op: Bewerkingen over meerdere bestanden kunnen mislukken als de LLM de context verliest. Verdeel grote taken in kleinere stappen.

7. Configuratie en .aider.conf.yml

Sla instellingen op in .aider.conf.yml om te voorkomen dat u vlaggen moet herhalen:

# .aider.conf.yml
model: claude-3-5-sonnet-20240620
dark_mode: true
git:
  auto_commits: true
  commit_message: "aider: {message}"
cache:
  enabled: true  # Cache LLM-reacties voor vergelijkbare prompts

Belangrijke Instellingen:

Professionele Tip: Gebruik aider --dump-config om een startconfiguratiebestand te genereren.

Alternatieven in een Oogopslag

Wat Nu?

1. Probeer een kleine refactoring: Gebruik /diff om een enkele functie in uw codebase te bewerken.
2. Stel automatische commits in: Configureer .aider.conf.yml om automatisch te committen met uw voorkeursberichtformaat.
3. Ontdek lokale modellen: Installeer Ollama en test codellama:7b voor kosteloze codeerhulp.

Voor teams die Aider adopteren, biedt Hyperion Consulting AI-tools consulting om het te integreren in uw CI/CD-pipelines en beveiligingsworkflows—afgestemd op het AI-beveiligingskader voor de PROTECT (toegangscontroles) en COMPLY (auditlogging) fasen.