Configurar Odysseus AI en macOS: Mac, MacBook, Apple Silicon y Ollama

Elige la configuración de Mac según lo que quieras comprobar

Para la mayoría de usuarios de MacBook e iMac, la ruta nativa Apple Silicon es el inicio más claro cuando los modelos locales y Ollama forman parte del objetivo. Docker sirve para pruebas aisladas o reproducibles, pero añade una capa de red que cambia el significado de localhost.

Usa Odysseus AI nativo con Ollama nativo cuando ambos corran en el Mac. Usa host.docker.internal cuando Odysseus AI esté en Docker y Ollama siga en el host Mac. Elige la ruta antes de cambiar puertos o etiquetas de modelos.

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
./start-macos.sh

Configuración nativa de Odysseus AI en macOS y Apple Silicon

La ruta nativa suele ser la configuración más directa para un MacBook o iMac con modelos locales. Confirma repositorio, permisos del launcher, Python/dependencias y primera URL local antes de añadir Ollama u otro provider.

El primer arranque debe demostrar que el workspace está sano. Trata los conflictos de puerto y dependencias como problemas de inicio, no como problemas de modelo.

1. Clona el repositorio oficial

Usa el repositorio oficial como fuente de verdad para scripts, issues y cambios del README. Evita comandos copiados cuando contradicen el estado actual del proyecto.

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus

2. Ejecuta el launcher de macOS y lee el primer error

El primer fallo suele indicar permisos, Python, dependencias o conflicto de puerto. Corrige esa capa antes de tocar endpoints de modelos.

chmod +x ./start-macos.sh
./start-macos.sh

3. Abre la UI local y completa el primer login

Si la app arranca en el puerto local documentado, usa esa URL en el navegador y cambia cualquier credencial temporal según los prompts actuales.

http://127.0.0.1:7860

4. Configura modelos solo después

Cuando el workspace esté sano, conecta Ollama u otro proveedor desde Settings. Depurar modelos antes de que la app funcione oculta el problema real.

http://127.0.0.1:11434/v1

Docker en Mac: aislamiento frente a acceso a modelos locales

Docker es válido en macOS para una prueba desechable, dependencias aisladas o paridad con un despliegue. No siempre es el valor predeterminado correcto para un flujo local con Apple Silicon.

Cuando el contenedor necesite llegar a Ollama en el host Mac, usa el endpoint del host y no asumas que localhost apunta al Mac. Mantén el primer arranque local hasta entender la ruta.

Conectar Ollama durante la configuración de Odysseus AI en Mac

Ollama es un servidor de modelos local separado. Para Odysseus AI y Ollama nativos en el mismo Mac, empieza con http://127.0.0.1:11434/v1. Para Odysseus AI en Docker y Ollama en el host, usa http://host.docker.internal:11434/v1.

Verifica Ollama con un modelo listado antes de depurar la interfaz de Odysseus AI. La aplicación puede arrancar aunque el endpoint o la etiqueta estén mal.

http://127.0.0.1:11434/v1

Solucionar problemas de Odysseus AI en MacBook, iMac y macOS

Comprueba primero launcher e interfaz local, después la red del runtime y por último Ollama y la etiqueta del modelo. Así separas un problema de arranque de Mac de un problema del provider.

Lista final para una instalación en Mac

Una instalación en Mac está lista cuando el workspace, el endpoint de modelo y el límite de seguridad están claros.

1. La UI abre localmente tras un arranque limpio.
2. Sabes si la ejecución es nativa, Docker o remota, y el endpoint coincide.
3. Ollama responde por separado antes de usarlo en Odysseus AI.
4. Un modelo pequeño funciona antes de probar agentes o documentos.
5. El workspace no está expuesto a red hasta definir auth y reglas.

Notas de verificación 2026 para configurar Odysseus AI en Mac

La decisión de Mac depende de dónde se ejecutan workspace y modelos. Apple Silicon nativo elimina una capa de red; Docker aporta aislamiento pero cambia el acceso al host.

Para un MacBook o iMac sigue este orden: inicia el workspace, abre la interfaz local, verifica Ollama, elige el endpoint del runtime y solo entonces prueba una petición de modelo.

1. Usar el GitHub oficial como fuente de comandos.
2. Depurar arranque antes de endpoints, y endpoints antes de agentes.
3. Mantén separada la intención de esta página de las guías de configuración relacionadas.