mini-SWE-agent

mini-SWE-agent no tiene una variable de entorno para la URL base — el endpoint se configura en model.model_kwargs.api_base dentro de un archivo YAML, que mini entrega directamente 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

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. Instálalo y ejecútalo una vez para crear las rutas: pip install mini-swe-agent y después mini. La primera ejecución indica dónde están .env y la configuración del agente, y ofrece mini-extra config setup.
3. Guarda la clave donde litellm la buscará: export OPENAI_API_KEY=sk-kn-... o de forma persistente con mini-extra config set OPENAI_API_KEY sk-kn-.... mini señala que “Las variables de entorno tienen prioridad sobre las variables definidas en el archivo .env”. Por eso, si acabas de cambiar una clave y parece que no ha cambiado, normalmente se debe a que hay una variable de entorno definida.
4. Guarda el YAML anterior como kunavo.yaml, junto a las demás configuraciones de tus agentes, y añade el registro de precios de la sección siguiente. Sin él, la ejecución se detendrá por un error de cálculo de costes, no por una respuesta incorrecta.
5. Inícialo con mini -c kunavo.yaml o usa mini -c kunavo.yaml -m openai/claude-haiku-4-5 para cambiar el ID en una sola ejecución. mini se inicia en el modo confirm, en el que apruebas cada comando; es una buena opción predeterminada para la primera ejecución con un endpoint nuevo.
6. Asígnale una tarea que realmente ejecute un comando, no un saludo. La opción predeterminada de mini v2 es el uso nativo de herramientas, y el prompt incluido exige que “Cada respuesta use la herramienta 'bash' al menos una vez para ejecutar comandos”. Por eso, un intercambio real con una herramienta es lo que confirma que la configuración funciona. Si las llamadas a herramientas devuelven resultados vacíos o mal formados, mini sigue incluyendo la ruta anterior de análisis de texto: mini -c mini_textbased.yaml o model_class: litellm_textbased en tu propio archivo.

Comprobado con Guía de modelos locales de mini-SWE-agent el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en 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-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

Seguimiento de costes, que aquí es obligatorio

La versión publicada de mini incluye mini.yaml, que establece cost_limit: 3. —un límite por ejecución expresado en dólares—. Ese límite se aplica mediante la calculadora de costes de litellm, que calcula el precio de una ejecución buscando el ID del modelo en su registro. Los ID de Kunavo no figuran en ese registro, así que lo primero que ve la mayoría no es una respuesta incorrecta, sino un error: la propia página de solución de problemas de mini lo muestra como Exception: This model isn't mapped yet. model=…, custom_llm_provider=….

Hay dos formas de resolverlo y no son equivalentes. El interruptor global MSWEA_COST_TRACKING="ignore_errors" (o cost_tracking: "ignore_errors" en el archivo) elimina la protección en lugar de corregir el problema; mini lo describe así: “PRECAUCIÓN: ¡Esto puede llevar a un gasto sin control!”. La otra opción es indicar las tarifas a litellm; eso es lo que señala litellm_model_registry en el bloque de configuración. Las tarifas siguientes corresponden al catálogo vigente de este sitio, convertidas al formato por token 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. Los nombres de modelo deben coincidir exactamente, incluidas mayúsculas y minúsculas. Además, el ejemplo de mini define la entrada con el nombre sin el prefijo del proveedor; por eso, aquí se usa claude-sonnet-5, aunque la configuración indique openai/claude-sonnet-5.
2. litellm_provider debe coincidir con el prefijo y con custom_llm_provider. La advertencia de mini es explícita: “Si usas custom_llm_provider o añades un prefijo de proveedor al nombre del modelo (p. ej., openai/…), también debe coincidir con litellm_provider en la configuración”.
3. La ruta también puede indicarse mediante LITELLM_MODEL_REGISTRY_PATH en lugar de la clave de configuración; resulta útil para los ejecutores por lotes, por ejemplo, LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. Estas tarifas sirven para calcular el presupuesto, no son una factura. El importe real que se te cobra es el que registra tu saldo de Kunavo. Vuelve a copiarlas si cambia el catálogo o consúltalas en GET /v1/models.