Modelos locales con Ollama

Con un modelo local, KomaLens se conecta a tu propio equipo: nada sale de él en ningún modo y no pagas por uso. Necesitas un equipo con memoria suficiente para el modelo que elijas.

1. Instala Ollama

Descárgalo desde ollama.com para Windows, macOS o Linux e instálalo. Ollama queda corriendo en segundo plano y atiende en http://localhost:11434.

2. Descarga un modelo

En una terminal, descarga el modelo con ollama pull. Para Imagen a la API necesitas un modelo con visión; para Híbrido sirve cualquier modelo de texto.

ollama pull qwen3-vl

Algunas familias con visión en la biblioteca de Ollama son Qwen-VL (qwen3-vl), Gemma 3 (gemma3, desde el tamaño 4b) y LLaVA (llava). La lista cambia seguido: revisa los nombres y tamaños actuales en ollama.com/library. Esto no es una recomendación: elige el que funcione mejor en tu equipo.

Para ver los modelos que tienes instalados:

ollama list

3. Configura KomaLens

En Ajustes → Proveedor de API:

Casilla	Valor
URL base	`http://localhost:11434/v1`
API key	Déjala vacía: es opcional y Ollama no la usa.
Modelo	El nombre tal como aparece en `ollama list`, por ejemplo `qwen3-vl:latest`.

Al guardar, KomaLens pide permiso para conectarse a localhost / 127.0.0.1. Acéptalo: es lo que le permite hablar con Ollama.

4. Si da error 403 o de CORS

Por defecto, Ollama solo acepta solicitudes de localhost, 127.0.0.1 y 0.0.0.0, no de extensiones del navegador. Si KomaLens muestra un error 403 o de CORS al conectarse, tienes que permitir el origen de la extensión con la variable de entorno OLLAMA_ORIGINS.

El origen de KomaLens es:

chrome-extension://gfooakgilleljdbbbgnfihfaoflnoejf

Es el mismo en Chrome y en Edge, porque ambos la instalan desde la Chrome Web Store. También puedes usar chrome-extension://* para permitir cualquier extensión, pero es menos restrictivo.

Windows

Cierra Ollama desde su ícono en la barra de tareas.
Abre Configuración y busca «variables de entorno». Elige Editar las variables de entorno de tu cuenta.
Crea una variable llamada OLLAMA_ORIGINS con el valor chrome-extension://gfooakgilleljdbbbgnfihfaoflnoejf.
Guarda y vuelve a abrir Ollama desde el menú Inicio.

macOS

Si usas la app de Ollama, ejecuta esto en la Terminal y luego cierra y vuelve a abrir la app:

launchctl setenv OLLAMA_ORIGINS "chrome-extension://gfooakgilleljdbbbgnfihfaoflnoejf"

Linux

Si Ollama corre como servicio de systemd, edita el servicio:

sudo systemctl edit ollama.service

Agrega estas líneas, guarda y sal:

[Service]
Environment="OLLAMA_ORIGINS=chrome-extension://gfooakgilleljdbbbgnfihfaoflnoejf"

Después recarga y reinicia:

sudo systemctl daemon-reload
sudo systemctl restart ollama

Si lo inicias desde una terminal

Define la variable en el mismo comando:

OLLAMA_ORIGINS="chrome-extension://gfooakgilleljdbbbgnfihfaoflnoejf" ollama serve

Consejo

En todos los casos, la variable tiene que estar definida **antes** de iniciar Ollama. Si ya estaba abierto, ciérralo y vuelve a abrirlo.

LM Studio

LM Studio también ofrece una API compatible con OpenAI:

Descarga un modelo desde la app. Para Imagen a la API, uno con visión.
En la pestaña Developer, inicia el servidor local. Por defecto escucha en el puerto 1234.
En los ajustes del servidor, activa Enable CORS para que la extensión pueda conectarse.
En KomaLens usa la URL base http://localhost:1234/v1, deja la API key vacía y elige el modelo de la lista.

Puedes comprobar que el servidor responde abriendo http://localhost:1234/v1/models en el navegador.