9 min de lectura 7 de junio de 2026

Configurar Odysseus AI con Ollama: conectar modelos locales

Guía centrada en la configuración de Odysseus AI con Ollama para Docker y modo nativo, con endpoints, comprobaciones de modelos y correcciones de proveedores.

Odysseus AI Wiki
Odysseus AI Wiki
Notas editoriales creadas por fans a partir de documentación pública de Odysseus AI y patrones de autoalojamiento local.
Diagrama de configuración de Odysseus AI con Ollama y endpoints de modelos locales

Respuesta rápida: Para conectar Odysseus AI en Docker con Ollama en el host, empieza con http://host.docker.internal:11434/v1. Si ambos se ejecutan de forma nativa en el mismo equipo, prueba http://127.0.0.1:11434/v1. Después confirma que Ollama está activo y que existe un modelo antes de cambiar el proveedor.

En esta guía

Configurar Odysseus AI con Ollama exige comprobar dos capas: el servidor Ollama debe responder y Odysseus AI debe alcanzarlo desde la red de ejecución correcta. Esta guía cubre Docker hacia el host, la instalación nativa en Windows/Linux/macOS, ejemplos de modelos locales y los errores habituales cuando el proveedor conecta pero no muestra modelos.

Elige el endpoint de Ollama según dónde se ejecuta Odysseus AI

El error más común al configurar Odysseus AI con Ollama es copiar una URL localhost nativa dentro de un contenedor Docker. El endpoint debe indicar dónde es accesible Ollama desde el proceso de Odysseus, no solo dónde está instalado.

Usa host.docker.internal:11434/v1 cuando Odysseus AI corre en Docker y Ollama en el equipo host. Usa 127.0.0.1:11434/v1 cuando ambos servicios son nativos. Después prueba Ollama y confirma un modelo antes de depurar prompts o agentes.

Endpoint Docker hacia Ollama en el host
http://host.docker.internal:11434/v1

Configuración Docker hacia Ollama en el host

Una configuración de Odysseus AI con Ollama en Docker cruza una frontera de red. localhost dentro del contenedor apunta al propio contenedor, por lo que el endpoint del host debe ser explícito y Ollama debe escuchar en una dirección alcanzable.

Mantén la primera prueba en local: demuestra una sola ruta entre el contenedor y Ollama antes de publicar puertos o cambiar etiquetas de modelos.

1. Arranca Ollama con una dirección alcanzable

Si Docker no puede llegar a Ollama, inicia Ollama con un binding explícito y úsalo solo en redes de confianza.

OLLAMA_HOST=0.0.0.0:11434 ollama serve

2. Comprueba que hay al menos un modelo

El endpoint puede responder aunque no haya modelos útiles. Descarga un modelo pequeño antes de probar agentes o documentos.

ollama list
ollama pull llama3.2:3b

3. Guarda el endpoint en Settings

Usa la URL compatible con OpenAI en el área de modelos o servicios. No uses localhost para Docker hacia host salvo que tu red Docker sea distinta.

http://host.docker.internal:11434/v1

4. Revisa la salud del contenedor

Si Odysseus está degradado, corrige eso antes de depurar prompts o modelos.

docker compose ps
docker compose logs --tail=120 odysseus

Configuración nativa de Ollama en Windows, Linux y macOS

Cuando Odysseus AI y Ollama son nativos y están en la misma sesión del sistema, localhost suele apuntar al equipo esperado. El puerto de la aplicación puede variar, pero Ollama suele usar 11434 salvo que hayas cambiado OLLAMA_HOST.

Para una decisión específica de Mac, continúa con la guía de macOS; para Windows o requisitos de hardware, usa las páginas existentes como siguientes pasos separados.

Configuración Endpoint inicial Qué vigilar
Odysseus nativo en Windows + Ollama en Windows http://127.0.0.1:11434/v1 Usa localhost cuando ambos servicios se ejecuten de forma nativa en el mismo equipo Windows.
Odysseus nativo en Linux + Ollama http://127.0.0.1:11434/v1 Comprueba los permisos del servicio si alguno de los procesos se ejecuta como servicio en segundo plano.
Ruta nativa de macOS o Apple Silicon http://127.0.0.1:11434/v1 El puerto de la interfaz de Odysseus puede variar, pero Ollama suele mantenerse en 11434.
Odysseus en Docker + Ollama en el host http://host.docker.internal:11434/v1 Usa el nombre del host de Docker porque el localhost del contenedor no es la máquina host.

Corregir errores de proveedor y endpoint entre Odysseus AI y Ollama

Lee los errores por capas: proceso de Ollama, endpoint accesible, modelo listado, configuración del proveedor y, por último, prompts. Así no confundes un problema de red con un problema del modelo.

Síntoma Causa probable Solución
Conexión rechazada Ollama no está activo o solo escucha en una dirección que Odysseus no puede alcanzar. Inicia Ollama, confirma el puerto 11434 y usa un binding OLLAMA_HOST explícito para probar Docker-host.
El navegador del host funciona, pero Docker falla El endpoint usa localhost dentro del contenedor. Cambia el endpoint a http://host.docker.internal:11434/v1.
No aparece ningún modelo No se ha descargado ningún modelo o la etiqueta es incorrecta. Ejecuta ollama list, descarga un modelo pequeño y selecciona la etiqueta exacta.
Primera respuesta lenta El modelo se está cargando o es demasiado grande para el equipo. Prueba un modelo más pequeño antes de usar agentes, herramientas o documentos.
Exposición inesperada a la LAN Un servicio se vinculó a todas las interfaces sin un límite de confianza. Vuelve al binding exclusivo de localhost salvo que firewall, VPN y autenticación sean intencionados.

Checklist final antes de confiar en la configuración

Un setup correcto debería superar estas comprobaciones en orden.

  1. Ollama responde en el host y ollama list muestra un modelo.
  2. El servicio de Odysseus está sano en Docker o en los registros nativos.
  3. El endpoint coincide con la disposición del runtime.
  4. Un prompt pequeño funciona antes de probar agentes o flujos de documentos más grandes.
  5. Cualquier exposición a la LAN está autenticada y es intencionada.
Mantén el primer setup local

Conectar Odysseus AI con Ollama no requiere publicar ningún servicio en internet. Mantén ambos locales hasta tener autenticación, firewall y proxy decididos.

Notas de verificación 2026 para configurar Odysseus AI con Ollama

Antes de cambiar el nombre del modelo, verifica la frontera de ejecución y la URL base. El mismo servidor Ollama puede requerir localhost para un proceso nativo y host.docker.internal para un proceso en contenedor.

Un ejemplo seguro es listar un modelo, probar el endpoint desde la misma capa que ejecuta Odysseus AI y guardar después la configuración. Si falla la primera petición, no cambies todavía la etiqueta del modelo.

Comprobacion Resultado correcto Si falla
API Ollama del host El host alcanza http://127.0.0.1:11434 antes de usar Odysseus. Inicia Ollama, descarga un modelo pequeño y prueba la API primero.
Ruta Docker al host Odysseus en contenedor usa host.docker.internal:11434/v1. No uses localhost dentro del contenedor salvo que Ollama esté en la misma red.
Ruta nativa Odysseus nativo usa 127.0.0.1:11434/v1 si Ollama está en la misma máquina. Quita los nombres de host de Docker y prueba con un prompt pequeño.
  1. Mantener Ollama local durante las pruebas salvo que firewall y autenticacion esten definidos.
  2. Confirmar que el tag del modelo existe en ollama list.
  3. Mantén separada la intención de esta página de las guías de configuración relacionadas.

Preguntas frecuentes sobre configurar Odysseus AI con Ollama

Empieza con http://host.docker.internal:11434/v1 cuando Odysseus AI está en Docker y Ollama en el host. Si no responde, revisa el binding de Ollama y la red de Docker antes de cambiar el modelo.

Usa la base compatible con OpenAI y /v1 cuando el campo del proveedor espera ese formato. Mantén la URL coherente con la documentación y prueba exactamente esa dirección.

No. Ollama es un servidor de modelos independiente en esta configuración. Odysseus AI se conecta a él; no inicia Ollama dentro del contenedor.

Si Odysseus AI y Ollama se ejecutan de forma nativa en Windows, prueba primero http://127.0.0.1:11434/v1. Usa host.docker.internal solo cuando Odysseus esté en Docker y Ollama en el host.

El servidor puede responder aunque no haya un modelo descargado o la etiqueta no coincida. Ejecuta ollama list, confirma la etiqueta y luego revisa el campo de modelo de Odysseus AI.

Normalmente sí. Ollama es el servidor de modelos y Odysseus AI es el workspace que se conecta a él. Inicia cada capa por separado y comprueba la conexión.

Fuentes y referencias oficiales

  1. Repositorio oficial de Odysseus AI en GitHub - Indicaciones sobre Docker, Windows, Apple Silicon y endpoints de Ollama.
  2. Documentación de la API de Ollama - Comportamiento de la API del servidor de modelos local.
  3. Documentación de redes de Docker Desktop - Comportamiento de red del host con host.docker.internal.

Guías relacionadas de Odysseus AI

Última actualización: 13 de agosto de 2026

Volver a la Wiki de Odysseus AI