Aider einrichten: Eine praktische Anleitung

Zusammenfassung

• Installieren Sie Aider mit pip install aider-chat und richten Sie einen LLM-API-Schlüssel (OpenAI/Anthropic/Ollama) ein.
• Fügen Sie Dateien mit /add <Datei> oder /add --all für vollständige Repository-Kenntnis zum Kontext hinzu.
• Nutzen Sie /diff für präzise Änderungen, /whole für vollständige Datei-Neuschreibungen und /architect für Refactorings über mehrere Dateien.
• Die Git-Integration führt automatisch Commits mit beschreibenden Nachrichten durch.
• Konfigurieren Sie .aider.conf.yml, um Modelleinstellungen und Standardverhalten zu speichern.

1. Installation und Modell-Einrichtung

Aider installieren

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

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

# Installation überprüfen
aider --version
# Erwartete Ausgabe: aider 0.36.0

Hinweis: Falls Sie einen command not found-Fehler erhalten, stellen Sie sicher, dass ~/.local/bin in Ihrem PATH enthalten ist:

export PATH=$PATH:~/.local/bin  # Zu ~/.bashrc oder ~/.zshrc hinzufügen

Ein LLM einrichten

Aider unterstützt OpenAI, Anthropic, Mistral und lokale Modelle über Ollama. Wählen Sie eine Option:

Option 1: OpenAI (GPT-4o)

1. Holen Sie sich einen OpenAI-API-Schlüssel.
2. Setzen Sie den Schlüssel als Umgebungsvariable:

   export OPENAI_API_KEY="Ihr-Schlüssel-hier"
   

   Copy
3. Starten Sie Aider:

   aider
   

   Copy

Option 2: Anthropic (Claude 3.5 Sonnet)

1. Holen Sie sich einen Anthropic-API-Schlüssel.
2. Setzen Sie den Schlüssel und das Modell:

   export ANTHROPIC_API_KEY="Ihr-Schlüssel-hier"
   aider --model claude-3-5-sonnet-20240620
   

   Copy

Option 3: Lokale Modelle (Ollama)

1. Installieren Sie Ollama und laden Sie ein Modell herunter:

   ollama pull llama3
   

   Copy
2. Starten Sie Aider mit dem lokalen Modell:

   aider --model ollama/llama3
   

   Copy

Erwartete Ausgabe:

Aider v0.36.0
Modell: claude-3-5-sonnet-20240620 mit Diff-Edit-Format
Git-Repository: .git mit 12 Dateien
Repo-Map: Nutzung von 1,2 MB von 2,0 MB
Verwenden Sie /help, um In-Chat-Befehle anzuzeigen.

2. Dateien zum Kontext hinzufügen

Aider muss Ihren Code "sehen", um ihn zu bearbeiten. Verwenden Sie diese Befehle im Chat:

Beispiel-Workflow:

# Starten Sie Aider in Ihrem Projektverzeichnis
cd ~/projects/my-app
aider

# Wichtige Dateien zum Kontext hinzufügen
/add src/utils.py
/add tests/test_utils.py

Hinweis: Große Repositories (10.000+ Dateien) können Aider verlangsamen. Verwenden Sie /add selektiv für aufgabenrelevante Dateien.

3. Bearbeitungsmodi

Aider bietet drei Bearbeitungsmodi. Wählen Sie je nach Präzisionsbedarf:

1. /diff (Standard)

• Zeigt einen Diff der vorgeschlagenen Änderungen vor der Anwendung an.
• Ideal für kleine, präzise Änderungen.

Beispiel:

Benutzer: /diff
Aider: Beschreiben Sie die gewünschte Änderung...
Benutzer: Refaktorieren Sie die Funktion `validate_input`, um Early Returns zu verwenden.

Erwartete Ausgabe:

- 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

Geben Sie y ein, um die Änderungen zu übernehmen.

2. /whole

• Schreibt die gesamte Datei neu.
• Verwenden Sie dies für größere Refactorings oder wenn /diff zu restriktiv ist.

Beispiel:

Benutzer: /whole src/utils.py
Aider: Welche Änderungen möchten Sie an dieser Datei vornehmen?
Benutzer: Schreiben Sie die Datei um, um Type Hints zu verwenden und Docstrings hinzuzufügen.

3. /architect

• Refactorings über mehrere Dateien mit hochrangiger Anleitung.
• Ideal für Änderungen über mehrere Dateien hinweg (z. B. "Verschieben Sie die Authentifizierungslogik in ein neues Modul").

Beispiel:

Benutzer: /architect
Aider: Welche architektonische Änderung möchten Sie vornehmen?
Benutzer: Teilen Sie die monolithische `handlers.py` in separate Dateien pro Route auf.

4. Git-Integration und automatische Commits

Aider führt automatisch Commits mit beschreibenden Nachrichten durch. Konfigurieren Sie dies in .aider.conf.yml:

# .aider.conf.yml
git:
  auto_commits: true
  commit_message: "aider: {message}"  # Commit-Nachrichtenformat anpassen

Befehle:

Hinweis: Automatische Commits können Ihr Commit-History unübersichtlich machen. Verwenden Sie /commit für manuelle Kontrolle oder squashen Sie später:

git rebase -i HEAD~5  # Aider-Commits squashen

5. Lokale Modelle über Ollama verwenden

Für Datenschutz oder Kosteneinsparungen können Sie lokale Modelle verwenden:

1. Installieren Sie Ollama und laden Sie ein Modell herunter:

   ollama pull codellama:7b
   

   Copy
2. Starten Sie Aider mit dem lokalen Modell:

   aider --model ollama/codellama:7b
   

   Copy
3. (Optional) Konfigurieren Sie Standardeinstellungen in .aider.conf.yml:

   model: ollama/codellama:7b
   

   Copy

Performance-Tipp: Verwenden Sie kleinere Modelle (z. B. codellama:7b) für schnellere Antworten, aber erwarten Sie eine geringere Genauigkeit als bei GPT-4o.

6. Workflows für die Bearbeitung mehrerer Dateien

Aider glänzt bei Änderungen über mehrere Dateien hinweg. Beispiel:

Aufgabe: Logging zu einem Modul hinzufügen

1. Fügen Sie relevante Dateien zum Kontext hinzu:

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

   Copy
2. Beschreiben Sie die Änderung:

   Fügen Sie Debug-Logging zu allen Funktionen in `app.py` hinzu. Verwenden Sie den Logger aus `utils/logger.py`.
   

   Copy
3. Aider wird:
   • Den Logger in app.py importieren.
   • logger.debug()-Aufrufe zu jeder Funktion hinzufügen.
   • logger.py bei Bedarf aktualisieren (z. B. eine Debug-Methode hinzufügen).

Hinweis: Änderungen über mehrere Dateien können fehlschlagen, wenn das LLM den Kontext verliert. Teilen Sie große Aufgaben in kleinere Schritte auf.

7. Konfiguration und .aider.conf.yml

Speichern Sie Einstellungen in .aider.conf.yml, um das wiederholte Eingeben von Flags zu vermeiden:

# .aider.conf.yml
model: claude-3-5-sonnet-20240620
dark_mode: true
git:
  auto_commits: true
  commit_message: "aider: {message}"
cache:
  enabled: true  # Cache für LLM-Antworten bei ähnlichen Prompts

Wichtige Einstellungen:

Profi-Tipp: Verwenden Sie aider --dump-config, um eine Startkonfigurationsdatei zu generieren.

Alternativen im Überblick

Nächste Schritte

1. Probieren Sie ein kleines Refactoring aus: Verwenden Sie /diff, um eine einzelne Funktion in Ihrem Code zu bearbeiten.
2. Richten Sie automatische Commits ein: Konfigurieren Sie .aider.conf.yml, um automatische Commits mit Ihrem bevorzugten Nachrichtenformat durchzuführen.
3. Erkunden Sie lokale Modelle: Installieren Sie Ollama und testen Sie codellama:7b für kostenlose Code-Unterstützung.

Für Teams, die Aider einführen, bietet Hyperion Consulting Beratung zu KI-Tools an, um es in Ihre CI/CD-Pipelines und Sicherheits-Workflows zu integrieren – ausgerichtet auf das AI Security Posture Framework™ für die Phasen PROTECT (Zugriffskontrollen) und COMPLY (Audit-Logging).