mini-SWE-agent

mini-SWE-agent ne possède aucune variable d’environnement pour l’URL de base — l’endpoint va sous model.model_kwargs.api_base dans une configuration YAML, que mini transmet directement à litellm.completion.

# 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

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Installez et exécutez le programme une fois pour créer les chemins nécessaires : pip install mini-swe-agent, puis mini. Au premier lancement, les emplacements de son .env et de sa configuration d’agent s’affichent, et l’option mini-extra config setup est proposée.
3. Placez la clé à l’endroit où litellm la cherchera : export OPENAI_API_KEY=sk-kn-..., ou conservez-la avec mini-extra config set OPENAI_API_KEY sk-kn-.... mini précise que « les variables d’environnement ont priorité sur celles définies dans le fichier .env », ce qui explique généralement pourquoi une clé que vous venez de modifier semble ne pas avoir changé.
4. Enregistrez le YAML ci-dessus sous le nom kunavo.yaml à côté de vos autres configurations d’agent, puis ajoutez le registre de tarifs de la section ci-dessous. Sans cela, l’exécution s’arrêtera sur une erreur de calcul des coûts, et non à cause d’une mauvaise réponse.
5. Lancez le programme avec mini -c kunavo.yaml, ou utilisez mini -c kunavo.yaml -m openai/claude-haiku-4-5 pour remplacer l’identifiant le temps d’une exécution. mini démarre en mode confirm, où vous approuvez chaque commande — un bon réglage par défaut pour un premier essai avec un nouveau point de terminaison.
6. Donnez-lui une tâche qui exécute réellement une commande, pas une salutation. L’appel natif d’outils est le réglage par défaut de mini v2, et son prompt fourni impose que « chaque réponse utilise l’outil 'bash' au moins une fois pour exécuter des commandes ». Un véritable aller-retour d’appel d’outil permet donc de vérifier que l’association fonctionne. Si les appels d’outils sont vides ou mal formés, mini inclut toujours l’ancienne méthode d’analyse du texte : mini -c mini_textbased.yaml, ou model_class: litellm_textbased dans votre propre fichier.

Vérifié avec Guide des modèles locaux de mini-SWE-agent le 21 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans 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-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Suivi des coûts, indispensable dans ce cas

La configuration livrée avec mini inclut mini.yaml, qui porte cost_limit: 3. — un plafond en dollars par exécution. Ce plafond est appliqué par le calculateur de coûts de litellm, qui évalue le coût d’une exécution en recherchant l’identifiant du modèle dans son registre. Les identifiants de Kunavo ne figurent pas dans ce registre ; la plupart des utilisateurs voient donc d’abord une erreur, et non une mauvaise réponse : la page de dépannage de mini l’affiche sous la forme Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Il existe deux solutions, qui ne sont pas équivalentes. Le commutateur global MSWEA_COST_TRACKING="ignore_errors" (ou cost_tracking: "ignore_errors" dans le fichier) supprime la protection au lieu de la corriger, et mini le qualifie ainsi : « ATTENTION : cela peut entraîner des dépenses non maîtrisées ! » L’autre solution consiste à communiquer les tarifs à litellm, ce à quoi renvoie litellm_model_registry dans le bloc de configuration. Les tarifs ci-dessous sont ceux du catalogue en direct de ce site, convertis au format par jeton de litellm :

{
  "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. Les noms de modèles sont comparés exactement, en respectant la casse. Dans l’exemple de mini, la clé de l’entrée est le nom sans son préfixe fournisseur — donc claude-sonnet-5 ici, même si la configuration indique openai/claude-sonnet-5.
2. litellm_provider doit correspondre au préfixe et à custom_llm_provider. L’avertissement de mini est explicite : « Si vous utilisez custom_llm_provider ou si le nom du modèle est précédé d’un fournisseur (par exemple openai/…), cela doit également correspondre à litellm_provider dans la configuration ! »
3. Le chemin peut également être défini par LITELLM_MODEL_REGISTRY_PATH plutôt que par la clé de configuration — pratique pour les exécutants de lots, par exemple LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Ces tarifs servent à établir un budget, ce ne sont pas une facture. Le montant réellement facturé est celui enregistré sur votre solde Kunavo. Recopiez-les si le catalogue évolue, ou consultez-les dans GET /v1/models.