mini-SWE-agent

mini-SWE-agent hat keine Umgebungsvariable für die Basis-URL — der Endpunkt steht unter model.model_kwargs.api_base in einer YAML-Konfiguration, die mini direkt an litellm.completion übergibt.

# mini has no base-URL environment variable and no settings UI. The endpoint
# goes in an agent config file, under model.model_kwargs — which mini's docs
# describe as "directly passed to litellm.completion".
model:
  model_name: "openai/claude-sonnet-5"
  model_kwargs:
    custom_llm_provider: "openai"
    api_base: "https://api.kunavo.com/v1"   # keep the /v1
  litellm_model_registry: "kunavo-registry.json"   # see "Cost tracking" below

# The key does not live in this file. With custom_llm_provider: "openai",
# litellm reads OPENAI_API_KEY, and mini documents two ways to set it:
#
#   export OPENAI_API_KEY=sk-kn-...          # environment, wins over .env
#   mini-extra config set OPENAI_API_KEY sk-kn-...   # mini's own .env
#
# Then run it:  mini -c kunavo.yaml
# Or make it the default:  mini-extra config set MSWEA_MINI_CONFIG_PATH kunavo.yaml

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
2. Installieren Sie mini und führen Sie es einmal aus, damit die Pfade angelegt werden: zuerst pip install mini-swe-agent, dann mini. Beim ersten Start wird angezeigt, wo sich die Dateien .env und die Agentenkonfiguration befinden; außerdem wird mini-extra config setup angeboten.
3. Legen Sie den Schlüssel dort ab, wo litellm danach sucht: unter export OPENAI_API_KEY=sk-kn-... oder dauerhaft mit mini-extra config set OPENAI_API_KEY sk-kn-.... mini weist darauf hin: „Umgebungsvariablen haben Vorrang vor Variablen in der Datei .env“. Deshalb scheint ein gerade geänderter Schlüssel häufig unverändert zu sein.
4. Speichern Sie das obige YAML unter kunavo.yaml neben Ihren anderen Agentenkonfigurationen und fügen Sie das Preisregister aus dem folgenden Abschnitt hinzu. Ohne dieses Register bricht die Ausführung wegen eines Fehlers bei der Kostenberechnung ab, nicht wegen einer schlechten Antwort.
5. Starten Sie mini mit mini -c kunavo.yaml oder verwenden Sie mini -c kunavo.yaml -m openai/claude-haiku-4-5, um die ID für einen einzelnen Lauf zu überschreiben. mini startet standardmäßig im Modus confirm, in dem Sie jeden Befehl bestätigen müssen – eine gute Standardeinstellung für den ersten Lauf über einen neuen Endpunkt.
6. Geben Sie mini eine Aufgabe, bei der tatsächlich ein Befehl ausgeführt wird, keinen Gruß. Die Standardeinstellung in mini v2 ist native Tool-Aufruffunktionalität, und die mitgelieferte Prompt-Vorlage besteht darauf: „Jede Antwort muss mindestens einmal das Tool 'bash' verwenden, um Befehle auszuführen.“ Ein tatsächlicher Tool-Aufruf mit anschließender Antwort zeigt daher, ob die Kombination funktioniert. Falls Tool-Aufrufe leer oder fehlerhaft zurückkommen, bietet mini weiterhin den älteren Pfad zur Textauswertung: mini -c mini_textbased.yaml oder model_class: litellm_textbased in Ihrer eigenen Datei.

Abgeglichen mit Leitfaden für lokale Modelle von mini-SWE-agent am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in mini-SWE-agent.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Kostenverfolgung, die hier unverzichtbar ist

Die ausgelieferte Version von mini enthält mini.yaml mit cost_limit: 3. – einer Obergrenze pro Ausführung in Dollar. Diese Grenze wird vom Kostenrechner von litellm durchgesetzt, der die Kosten einer Ausführung anhand der Modell-ID im eigenen Register berechnet. Kunavo-IDs sind dort nicht enthalten. Deshalb sehen die meisten zuerst keinen schlechten Antworten, sondern eine Fehlermeldung: Auf der mini-eigenen Seite zur Fehlerbehebung wird sie als Exception: This model isn't mapped yet. model=…, custom_llm_provider=… angezeigt.

Es gibt zwei Möglichkeiten, das Problem zu beheben, und sie sind nicht gleichwertig. Der globale Schalter MSWEA_COST_TRACKING="ignore_errors" (oder cost_tracking: "ignore_errors" in der Datei) entfernt die Schutzvorkehrung, statt sie zu reparieren. mini bezeichnet dies als „VORSICHT: Dies kann zu unkontrollierten Ausgaben führen!“ Die andere Möglichkeit ist, litellm die Preise mitzuteilen. Darauf verweist litellm_model_registry im Konfigurationsblock. Die folgenden Preise stammen aus dem aktuellen Live-Katalog dieser Website und wurden in das Format von litellm pro Token umgerechnet:

{
  "claude-sonnet-5": {
    "input_cost_per_token": 0.0000014,
    "output_cost_per_token": 0.000007,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-opus-5": {
    "input_cost_per_token": 0.0000035,
    "output_cost_per_token": 0.0000175,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-haiku-4-5": {
    "input_cost_per_token": 0.0000007,
    "output_cost_per_token": 0.0000035,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

1. Modellnamen werden exakt und unter Beachtung der Groß- und Kleinschreibung abgeglichen. Im Beispiel von mini wird der Eintrag unter dem Namen ohne Provider-Präfix angelegt. Deshalb steht hier claude-sonnet-5, obwohl in der Konfiguration openai/claude-sonnet-5 angegeben ist.
2. litellm_provider muss mit dem Präfix und mit custom_llm_provider übereinstimmen. mini warnt ausdrücklich: „Wenn Sie custom_llm_provider verwenden oder dem Modellnamen ein Provider-Präfix voranstellen (z. B. openai/…), muss dies auch mit litellm_provider in der Konfiguration übereinstimmen!“
3. Der Pfad kann statt über den Konfigurationsschlüssel auch über LITELLM_MODEL_REGISTRY_PATH festgelegt werden – nützlich für Batch-Ausführungen, zum Beispiel LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Diese Preise dienen als Budgeteingabe, nicht als Abrechnung. Tatsächlich berechnet wird der Betrag, den Ihr Kunavo-Guthaben ausweist. Übernehmen Sie die Preise erneut, wenn sich der Katalog ändert, oder lesen Sie sie unter GET /v1/models ab.