mini-SWE-agent

mini-SWE-agent non ha una variabile d'ambiente per l'URL di base — l'endpoint va in model.model_kwargs.api_base in una configurazione YAML, che mini passa direttamente a 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

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Installa ed esegui il programma una volta affinché i percorsi vengano creati: pip install mini-swe-agent, quindi mini. La prima esecuzione indica dove si trovano .env e la configurazione dell’agente, e propone mini-extra config setup.
3. Inserisci la chiave dove litellm la cercherà: export OPENAI_API_KEY=sk-kn-... oppure salvala in modo persistente con mini-extra config set OPENAI_API_KEY sk-kn-.... mini precisa che «le variabili d’ambiente hanno la precedenza sulle variabili impostate nel file .env»: questo è il motivo più comune per cui una chiave appena modificata sembra non essere cambiata.
4. Salva lo YAML qui sopra come kunavo.yaml accanto alle altre configurazioni degli agenti e aggiungi il registro dei prezzi della sezione seguente. Senza di esso, l’esecuzione si interrompe con un errore di calcolo dei costi, non con una risposta errata.
5. Avvialo con mini -c kunavo.yaml oppure usa mini -c kunavo.yaml -m openai/claude-haiku-4-5 per sostituire l’ID per una singola esecuzione. mini si apre in modalità confirm, in cui approvi ogni comando: una buona impostazione predefinita per la prima esecuzione su un nuovo endpoint.
6. Assegnagli un’attività che esegua davvero un comando, non un semplice saluto. La modalità predefinita di mini v2 è la chiamata nativa degli strumenti e il prompt distribuito specifica che «ogni risposta deve usare almeno una volta lo strumento 'bash' per eseguire comandi». È quindi un vero scambio con lo strumento a verificare che la configurazione funzioni. Se le chiamate agli strumenti restituiscono contenuti vuoti o malformati, mini include ancora il precedente metodo basato sull’analisi del testo: mini -c mini_textbased.yaml oppure model_class: litellm_textbased nel tuo file.

Verificato rispetto a Guida ai modelli locali di mini-SWE-agent il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano 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-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

Monitoraggio dei costi: qui è necessario

La configurazione distribuita di mini include mini.yaml con cost_limit: 3.: un limite per esecuzione espresso in dollari. Questo limite è applicato dal calcolatore dei costi di litellm, che determina il costo di un’esecuzione cercando l’ID del modello nel proprio registro. Gli ID di Kunavo non sono presenti in quel registro, perciò il primo problema che si presenta alla maggior parte degli utenti non è una risposta errata, ma un errore: la pagina di risoluzione dei problemi di mini lo mostra come Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Ci sono due modi per risolvere il problema, e non sono equivalenti. L’opzione globale MSWEA_COST_TRACKING="ignore_errors" (o cost_tracking: "ignore_errors" nel file) rimuove la protezione, senza correggere il problema; mini la definisce «ATTENZIONE: può comportare spese non controllate!». L’altro modo consiste nel fornire a litellm le tariffe, come indicato da litellm_model_registry nel blocco di configurazione. Le tariffe riportate sotto sono quelle attuali del catalogo di questo sito, convertite nel formato per token di 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. I nomi dei modelli vengono confrontati esattamente, distinguendo maiuscole e minuscole. Nell’esempio di mini, la chiave della voce è il nome senza il prefisso del provider: quindi, qui claude-sonnet-5, anche se la configurazione indica openai/claude-sonnet-5.
2. litellm_provider deve corrispondere al prefisso e a custom_llm_provider. L’avviso di mini è esplicito: «Se usi custom_llm_provider oppure aggiungi un prefisso del provider al nome del modello (ad esempio openai/…), anche questo deve corrispondere a litellm_provider nella configurazione!»
3. Il percorso può essere specificato anche tramite LITELLM_MODEL_REGISTRY_PATH invece che con la chiave di configurazione: è utile per i runner batch, ad esempio LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Queste tariffe servono come riferimento per il budget, non costituiscono una fattura. L’importo effettivo addebitato è quello registrato nel saldo Kunavo. Se il catalogo cambia, copiale di nuovo oppure ricavale da GET /v1/models.