Kernl

Conectar un modelo

Hasta que conectes una IA, el chat y los agentes de Kernl quedan apagados. Todo lo demás funciona. El modelo se conecta desde el dashboard, y podés conectar varios para que uno cubra al otro.

Abrir los ajustes de AI

En la barra de la izquierda, hacé clic en Sistema. Después elegí Configuración en las pestañas de arriba, y AI en la lista de ajustes. También podés ir directo a http://localhost:3086/settings?section=ai.

Configuración, sección AI, todavía sin ninguna IA conectada
Sistema → Configuración → AI

La página se llama Conectá tu IA. Tocá + Conectar proveedor para ver todos los proveedores, o Conectar NVIDIA gratis para ir directo al recomendado.

El selector de proveedores agrupado en Gratis, En tu computadora, Pago por uso y Con tu suscripción
Conectar proveedor: todos los proveedores en dos columnas

Elegir un proveedor

Los proveedores están agrupados por lo que cuestan y por dónde corren. Si no sabés cuál elegir, empezá por NVIDIA: es gratis y no pide tarjeta.

Cerebras, Mistral, Together AI, Fireworks AI, Kimi, Qwen, Z.ai, Xiaomi MiMo y el servidor compatible con OpenAI llegan en la próxima versión de Kernl. Si no los ves, actualizá Kernl.

Proveedor Grupo Cuánto cuesta Dónde sacás la key La key empieza con
NVIDIA ★ Gratis gratis, sin tarjeta build.nvidia.com nvapi-
Google Gemini Gratis gratis, Google usa tus datos aistudio.google.com/apikey AIza o AQ.
Groq Gratis gratis, límites chicos console.groq.com/keys gsk_
OpenRouter Gratis gratis, 50 pedidos por día openrouter.ai/settings/keys sk-or-
Cerebras Gratis prueba gratis, límites chicos cloud.cerebras.ai —
Mistral Gratis gratis, sin tarjeta console.mistral.ai —
Ollama En tu computadora gratis, corre en tu máquina sin key —
LM Studio En tu computadora gratis, corre en tu máquina sin key —
Servidor compatible con OpenAI En tu computadora gratis, tu propio servidor opcional —
Anthropic Pago por uso tu saldo de API platform.claude.com sk-ant-
OpenAI Pago por uso tu saldo de API platform.openai.com/api-keys sk-
DeepSeek Pago por uso tu saldo de API, barato platform.deepseek.com/api_keys sk-
xAI Grok Pago por uso tu saldo de API console.x.ai xai-
MiniMax Pago por uso tu saldo de API, barato platform.minimax.io —
Together AI Pago por uso tu saldo de API, desde USD 15 api.together.ai —
Fireworks AI Pago por uso tu saldo de API, créditos de prueba app.fireworks.ai —
Moonshot (Kimi) Pago por uso tu saldo de API, desde USD 1 platform.kimi.ai —
Qwen (Alibaba Cloud) Pago por uso cuota gratis, después tu saldo Alibaba Cloud Model Studio sk-
Z.ai (GLM) Pago por uso tu saldo de API, algunos modelos gratis z.ai —
Xiaomi MiMo Pago por uso tu saldo de API, barato platform.xiaomimimo.com sk-
Claude Code Con tu suscripción tu plan Claude Pro o Max sin key —

Conectar con una API key

Todos los proveedores de las filas Gratis y Pago por uso se conectan igual:

  1. Tocá la tarjeta del proveedor. El formulario muestra tres pasos para sacar la key, con un enlace al sitio del proveedor al lado del primero.
  2. Creá la key en ese sitio y copiala.
  3. Pegala en API key.
  4. Dejá el Modelo que viene elegido, o elegí otro. La lista marca uno como "recomendado" y otro como "rápido". También podés escribir el id de cualquier modelo que ofrezca el proveedor.
  5. Tocá Conectar.
El formulario de NVIDIA con los pasos para sacar la key y el campo de API key
Conectar NVIDIA con una API key

Kernl prueba la conexión antes de guardar nada: le pide al modelo que use una herramienta, porque los agentes de Kernl lo necesitan. Cuando funciona ves "Conectado · usa herramientas · respondió en … ms" y el proveedor aparece en Tus conexiones.

Si la key no tiene el formato de ese proveedor, Kernl te avisa: "Esta key no tiene el formato habitual de …". Igual te deja probar, así que si la copiaste completa, tocá Conectar de todos modos.

Ya conectado, podés tocar Cargar más modelos en el formulario para ver todos los modelos que el proveedor tiene para vos.

NVIDIA

Gratis y sin tarjeta. Es la primera opción recomendada. NVIDIA no publica sus límites de uso.

  1. Creá tu cuenta gratis en build.nvidia.com.
  2. Abrí cualquier modelo y tocá Get API Key.
  3. Copiá la key (empieza con nvapi-) y pegala en Kernl.

Google Gemini

Gratis. En el plan gratis, Google usa lo que le mandás para mejorar sus productos. No lo uses para nada privado.

  1. Entrá a Google AI Studio (aistudio.google.com/apikey) con tu cuenta de Google.
  2. Tocá Create API key.
  3. Copiá la key y pegala en Kernl.

Groq

Gratis, pero con límites chicos: 8.000 tokens por minuto. Los agentes con muchas herramientas pueden pasarse, así que Groq anda mejor como respaldo.

  1. Creá tu cuenta en console.groq.com.
  2. Abrí API Keys y tocá Create API Key.
  3. Copiá la key (empieza con gsk_) y pegala en Kernl.

OpenRouter

Da acceso a muchos modelos con una sola key. Los modelos gratis permiten 20 pedidos por minuto y 50 por día, o 1.000 por día una vez que compraste USD 10 de saldo.

  1. Creá tu cuenta en openrouter.ai.
  2. Abrí Settings → Keys y tocá Create Key.
  3. Copiá la key (empieza con sk-or-) y pegala en Kernl.

Anthropic

Los modelos Claude por la API de Anthropic, pagando por uso. Es algo aparte de una suscripción Claude Pro o Max. Para eso, mirá Claude Code.

  1. Entrá a platform.claude.com y cargá saldo.
  2. Abrí Settings → API keys y tocá Create key.
  3. Copiá la key (empieza con sk-ant-) y pegala en Kernl.

OpenAI

  1. Entrá a platform.openai.com.
  2. Abrí API keys y tocá Create new secret key.
  3. Copiá la key (empieza con sk-) y pegala en Kernl.

DeepSeek

Pago por uso, y barato.

  1. Entrá a platform.deepseek.com y cargá saldo.
  2. Abrí API keys y creá una.
  3. Copiá la key y pegala en Kernl.

xAI Grok

  1. Entrá a console.x.ai y cargá saldo.
  2. Abrí API Keys y creá una.
  3. Copiá la key (empieza con xai-) y pegala en Kernl.

MiniMax

Pago por uso, y barato. Las keys de MiniMax no tienen un prefijo fijo, así que Kernl nunca avisa por su formato.

  1. Entrá a platform.minimax.io.
  2. Abrí User Center → Interface key y creá una.
  3. Copiá la key y pegala en Kernl.
  4. En Región, elegí Global, o China si tu cuenta es de minimax.cn.

Cerebras

Muy rápido. La prueba gratis permite 5 pedidos por minuto y 1 millón de tokens por día por modelo: alcanza como respaldo, pero queda justo para agentes que trabajan mucho.

  1. Creá tu cuenta en cloud.cerebras.ai.
  2. Abrí API Keys en la barra de la izquierda y creá una.
  3. Copiá la key y pegala en Kernl.

Mistral

El modo gratis no pide tarjeta, pero Mistral puede pedirte un número de teléfono. Mistral puede usar lo que mandás en el modo gratis para entrenar sus modelos, así que no lo uses para nada privado.

  1. Creá tu cuenta en console.mistral.ai.
  2. Abrí API Keys y tocá Create new key. Ponele un nombre y una fecha de vencimiento.
  3. Copiá la key y pegala en Kernl. Mistral la muestra una sola vez.

Together AI

Cientos de modelos abiertos, como GLM, Kimi y gpt-oss, con una sola key. No hay prueba gratis: la primera compra es de USD 15 como mínimo.

  1. Creá tu cuenta en together.ai y cargá saldo.
  2. Abrí Settings → API Keys y tocá Create key.
  3. Copiá la key y pegala en Kernl. Together la muestra una sola vez.

Los ids de modelo llevan adelante el dueño, por ejemplo zai-org/GLM-5.3.

Fireworks AI

Modelos abiertos rápidos y baratos. Sin medio de pago tenés créditos de prueba y 10 pedidos por minuto.

  1. Creá tu cuenta en fireworks.ai.
  2. Abrí Settings → API Keys y tocá Create API key.
  3. Copiá la key y pegala en Kernl.

Los ids de modelo son rutas largas, por ejemplo accounts/fireworks/models/glm-5p3.

Moonshot (Kimi)

Los modelos Kimi, fuertes en agentes y código. Cargás saldo desde USD 1, y el primer nivel permite 3 pedidos por minuto.

  1. Entrá a platform.kimi.ai y cargá saldo.
  2. Abrí API Keys y creá una.
  3. Copiá la key y pegala en Kernl.
  4. En Región, elegí Internacional, o China si tu cuenta es de platform.kimi.com.

Kernl elige kimi-k2.6. Podés elegir kimi-k3 en Modelo, pero siempre razona antes de responder, así que fijate que tus agentes anden con él.

Qwen (Alibaba Cloud)

En la región Singapur tenés 1 millón de tokens gratis por modelo durante 90 días. Después pagás por uso.

  1. Entrá a Alibaba Cloud Model Studio y elegí la región arriba a la derecha.
  2. Abrí API Key y tocá Create API Key. Dejá el workspace por defecto y dale todos los permisos.
  3. Copiá la key (empieza con sk-) y pegala en Kernl. Se muestra una sola vez.
  4. En Región, elegí la misma región donde creaste la key: Internacional (Singapur) o China (Pekín). Una key de otra región se rechaza.

Z.ai (GLM)

Los modelos GLM, buenos para agentes. GLM-4.7-Flash y GLM-4.5-Flash son gratis; el resto se paga por uso.

  1. Creá tu cuenta en z.ai.
  2. Abrí la página de API keys y creá una.
  3. Copiá la key y pegala en Kernl.
  4. En Región, elegí Internacional, o China si tu cuenta es de bigmodel.cn.

Xiaomi MiMo

Los modelos MiMo de Xiaomi: baratos y con lugar para un millón de tokens de contexto. Kernl usa MiMo-V2.6-Pro, y MiMo-V2.6-Flash como modelo rápido.

  1. Creá tu cuenta en platform.xiaomimimo.com y cargá saldo.
  2. Abrí API Keys y creá una.
  3. Copiá la key (empieza con sk-) y pegala en Kernl.

MiMo también vende un Token Plan, un plan mensual cuyas keys empiezan con tp-. Esas keys no sirven acá: usá una key de pago por uso.

Usar un modelo local

Ollama, LM Studio y cualquier servidor compatible con OpenAI corren en tu propia máquina o en tu red. No necesitan key, y nada de lo que mandás sale de tu computadora.

Para Ollama: instalalo desde ollama.com, descargá un modelo con el comando de abajo y dejá Ollama corriendo.

ollama pull qwen3

Para LM Studio: instalalo desde lmstudio.ai, descargá y cargá un modelo, y en Developer activá Start server (LM Studio no tiene esa pantalla en español).

De vuelta en Kernl:

  1. Elegí Ollama o LM Studio en En tu computadora.
  2. Tocá Detectar. Kernl busca en la dirección habitual y muestra "Encontrado en … · N modelos" cuando encuentra tu servidor.
  3. Elegí uno de tus modelos en Modelo.
  4. Tocá Conectar.
El formulario de Ollama con la dirección del servidor, el botón Detectar y un aviso de que no encontró Ollama
El formulario de Ollama. Acá Ollama no está corriendo, así que Kernl no lo encuentra.

La Dirección del servidor viene completa: http://localhost:11434/v1 para Ollama y http://127.0.0.1:1234/v1 para LM Studio. Cambiala solo si los corrés en otro puerto o en otra computadora.

Si corrés Kernl en Docker, Detectar también prueba host.docker.internal, que llega a tu computadora desde adentro del contenedor. Si igual no encuentra tu servidor, escribí la dirección a mano, por ejemplo http://host.docker.internal:11434/v1 para Ollama.

El modelo tiene que saber usar herramientas. Si responde pero no las usa, Kernl te lo dice y los agentes no van a andar con él. Elegí otro modelo.

Cualquier servidor compatible con OpenAI

Usá esta tarjeta para llama.cpp, vLLM, Jan, LocalAI o un proxy como LiteLLM: cualquier servidor que responda la API de OpenAI.

  1. Arrancá tu servidor con su API compatible con OpenAI.
  2. En En tu computadora, elegí OpenAI-compatible server.
  3. Tocá Detectar, o escribí vos la dirección en Dirección del servidor. Normalmente termina en /v1.
  4. Si tu servidor pide una key, pegala en API key (opcional).
  5. Elegí un modelo y tocá Conectar.

Detectar busca en los puertos 8080 (llama.cpp y LocalAI), 8000 (vLLM) y 1337 (Jan), en tu computadora y, con Docker, en host.docker.internal. Un servidor en otra computadora o en otro puerto lo tenés que escribir a mano, por ejemplo http://192.168.0.20:8000/v1.

Usar tu suscripción de Claude Code

Podés dejar que Kernl use tu suscripción Claude Pro o Max como su IA. Es lo contrario de conectar Claude Code a Kernl, donde Claude Code usa las herramientas de Kernl. Las dos cosas no tienen relación y podés hacer ambas.

Si instalaste la app o el paquete de Kernl (no Docker):

  1. En Con tu suscripción, elegí Claude Code.
  2. Tocá Conectar con mi suscripción. Se abre en tu navegador una página de aprobación de Claude.
  3. Aprobala. Kernl se conecta solo.

Si Kernl corre en Docker

En Docker hay un paso más. Cuando aprobás, Claude manda tu navegador a una dirección que solo existe adentro del contenedor, así que tu navegador no la puede abrir. Esa dirección la tenés que copiar y pegar vos en Kernl.

El formulario de Claude Code con Conectar con mi suscripción, O iniciá sesión desde una terminal y Detectar
El formulario de Claude Code, como se ve cuando Kernl corre en Docker
  1. En Con tu suscripción, elegí Claude Code y tocá Conectar con mi suscripción. La página de aprobación de Claude se abre en una pestaña nueva. Si tu navegador bloquea la pestaña nueva, tocá Abrí la página de aprobación.
  2. En la página de Claude, iniciá sesión con tu cuenta de Claude si te lo pide, y aprobá.
  3. Ahora tu navegador muestra una página de error: "No se puede acceder a este sitio" o parecido. Es lo esperado. No la cierres.
  4. Hacé clic en la barra de direcciones de esa pestaña y copiá la dirección completa. Empieza con http://localhost y tiene /callback?code= y &state=. Por ejemplo: http://localhost:…/callback?code=…&state=…
  5. Volvé a la pestaña de Kernl. Pegá la dirección en Dirección de la página que no cargó.
  6. Tocá Conectar. Claude Code aparece en Tus conexiones.

Copiá la dirección tal cual, desde la primera h hasta el final. Un pedazo no alcanza.

Si algo sale mal:

Mensaje Qué hacer
Eso no parece la dirección: tiene que incluir ?code= y &state=. Copiaste solo una parte. Volvé a copiar la dirección completa desde la barra de direcciones.
Esa dirección es de otro intento. Pegaste la dirección de un intento anterior. Tocá Abrir de nuevo la página de aprobación, aprobá y pegá la dirección nueva.
Este inicio de sesión ya no está en curso. Empezá de nuevo. El intento venció o cerraste el formulario. Tocá Conectar con mi suscripción otra vez.
La página de aprobación venció. Probá de nuevo. Pasaron más de 10 minutos. Empezá de nuevo con Conectar con mi suscripción.
Kernl no pudo entregarle la aprobación a Claude Code. Probá de nuevo. Empezá de nuevo. Si sigue fallando, iniciá sesión desde una terminal.

Iniciar sesión desde una terminal

Si el botón no funciona, con Docker o sin Docker, tocá O iniciá sesión desde una terminal:

  1. Tocá Copiar comando y pegá el comando en una terminal. En Windows, usá el Símbolo del sistema (cmd), no PowerShell.
  2. Se abre Claude Code. Si no te pide iniciar sesión, escribí /login y aprobá en el navegador.
  3. Salí de Claude Code con /exit, volvé a Kernl y tocá Detectar.

Usar varios proveedores

Podés conectar todos los proveedores que quieras. Cada uno que conectás va al final de una lista, y Kernl usa el primero que responda. Si falla, porque está caído, sin saldo o muy lento, Kernl pasa solo al siguiente.

La línea de arriba de Tus conexiones muestra el orden: "Kernl piensa con … → si falla: …".

  • Para cambiar el orden, tocá Reordenar, mové los proveedores con las flechas y tocá Guardar. El botón aparece cuando tenés dos o más.
  • Para cambiar el modelo de un proveedor, tocá Editar en su fila, elegí otro Modelo y tocá Conectar. No hace falta volver a pegar la key.
  • Para ver si sigue andando, tocá Probar. La fila muestra cuándo se probó por última vez y qué tan rápido respondió.
  • Para quitarlo, tocá Quitar y confirmá. Kernl borra su key y lo saca de la lista.

Una buena combinación: NVIDIA primero, con Groq o un modelo local de respaldo.

Cuando la conexión falla

Kernl explica el problema y ofrece un botón para resolverlo. Tocá Ver detalle para ver el mensaje del propio proveedor.

El formulario de NVIDIA con el aviso La key no es válida o fue revocada, y los botones Generar otra key y Ver detalle
Una key rechazada
Mensaje Qué hacer
La key no es válida o fue revocada. Tocá Generar otra key y pegá la nueva.
Llegaste al límite gratis o te quedaste sin saldo. Esperá, cargá saldo, o tocá Sumar un proveedor de respaldo.
Ese modelo ya no está disponible. Tocá Elegir otro modelo.
El modelo está saturado y no respondió a tiempo. Tocá Usar el modelo rápido, o probá más tarde.
Responde, pero no usa herramientas: los agentes no van a funcionar. Tocá Elegir otro modelo.
No encuentro Ollama (o LM Studio) en … Fijate que esté corriendo y tocá Volver a detectar.
No hay una sesión de Claude Code en esta máquina. Iniciá sesión con Copiar comando, como en Claude Code.
No hay conexión con … Revisá tu conexión a internet y tocá Reintentar.

Keys en el archivo .env

Kernl guarda las keys cifradas en su base de datos, no en archivos. Si tenías una key en .env (por ejemplo NVIDIA_API_KEY u OPENAI_API_KEY) la primera vez que arrancó Kernl, la importó, conectó ese proveedor y borró la línea del .env. También dejó una copia del archivo llamada .env.bak-….

Después de ese primer arranque, Kernl ignora las keys que agregues al .env. Conectá los proveedores nuevos en Configuración → AI.

Próximo paso

Para usar las herramientas de Kernl desde otra app, leé Conceptos básicos de MCP.