Odysseus AI es el workspace de inteligencia artificial autoalojado creado por PewDiePie: chat, agentes, investigación, correo y calendario en una sola interfaz web. Esta guía te lleva de cero a tenerlo instalado con Docker, tu primer modelo conectado y la instalación protegida.

¿Qué es Odysseus AI en un minuto?

Odysseus es un espacio de trabajo de IA self-hosted: lo instalas en tu propio equipo o servidor, en lugar de usar un servicio en la nube. Es gratuito y de código abierto (licencia AGPL-3.0), lo mantiene la organización odysseus-dev de GitHub y ya supera las 88.000 estrellas. Su filosofía es local-first: con modelos locales, el procesamiento ocurre en tu máquina y tus datos no pasan por servidores de terceros.

Acepta tres tipos de backend para ejecutar los modelos:

• Modelos locales: Ollama, llama.cpp, vLLM, LM Studio o SGLang
• APIs en la nube: OpenRouter, OpenAI, Anthropic, Gemini, Groq, xAI, DeepSeek, Mistral y otras compatibles con OpenAI
• Suscripción a ChatGPT: inicio de sesión con tu cuenta Plus o Pro mediante OAuth, sin API key ni pago por token

Si aún no tienes claro para qué te serviría, estos usos prácticos de los modelos de lenguaje local muestran tareas cotidianas que ya resuelve sin chatbots de pago.

Qué necesitas antes de empezar

• Docker y Git: Docker Desktop en Windows y macOS, o Docker Engine en Linux
• Sistema: macOS con Apple Silicon, o Linux con Python 3.11+ si prefieres instalación nativa (Windows existe, pero el proyecto no lo prueba activamente)
• GPU: opcional pero muy recomendable para modelos locales; sin ella funcionan los backends por API
• Elegir rama: el repositorio usa dev como rama por defecto (novedades primero) y main como rama curada; para producción conviene main

Paso 1: ¿Puede tu equipo ejecutar Odysseus AI?

El factor decisivo es la VRAM de tu GPU o, en una Mac, la memoria unificada. El Cookbook integrado analiza tu hardware y puntúa qué modelos encajan, pero esta tabla te orienta antes de instalar nada.

¿Qué significa Q4? Es la versión cuantizada del modelo: comprimida para ocupar menos memoria a cambio de una pérdida de calidad pequeña. Es el mejor formato para empezar. Si tu equipo se queda corto, esta guía sobre qué LLM local elegir según tu VRAM en 2026 detalla configuraciones óptimas para Ollama y LM Studio con 4, 6, 8 o 12 GB.

Paso 2: Elige tu método de instalación

Docker es la vía recomendada: un solo comando deja corriendo la aplicación junto con ChromaDB, SearXNG y ntfy, vinculados por defecto a 127.0.0.1. Esta tabla resume las rutas por plataforma.

Paso 3: Instálalo con Docker

La guía oficial de Odysseus AI recomienda verificar la fuente antes de empezar. El quick start del README son cuatro comandos:

1. Clona el repositorio (usa la rama main si buscas estabilidad): git clone https://github.com/odysseus-dev/odysseus.git y entra con cd odysseus
2. Prepara la configuración: cp .env.example .env
3. Arranca todo: docker compose up -d –build — la primera vez tarda mientras descarga las imágenes
4. Abre el navegador en http://localhost:7000 cuando los contenedores estén sanos

Para aceleración por GPU, el repositorio incluye los archivos docker-compose.gpu-nvidia.yml y docker-compose.gpu-amd.yml, que se añaden al Compose principal según tu tarjeta. Para despliegues serios, el README sugiere fijar la imagen a una etiqueta inmutable del tipo 1.0.2-7c8070f en lugar de :latest.

Paso 4: Entra por primera vez

La primera contraseña de administrador se imprime en los registros: búscala con docker compose logs odysseus. Si instalas de forma nativa, el asistente te pide elegir una, y también puedes predefinirla con la variable ODYSSEUS_ADMIN_PASSWORD en el archivo .env antes del primer arranque. Al entrar: cámbiala por una larga y única, activa el 2FA con TOTP y guarda los códigos de respaldo.

Paso 5: Conecta tu primer modelo

Sin un modelo conectado, Odysseus no puede responder. Tres rutas según tu prioridad:

Para la ruta local, la guía oficial detalla cómo conectar Ollama con su endpoint y el sufijo /v1 correspondiente. Si la conexión te da problemas, el patrón de servidor local con una GPU de 8 GB explica cómo elegir bien la cuantización y conectar tus apps mediante una API compatible con la de OpenAI.

Paso 6: ¿Cómo proteges la instalación?

Autoalojar es seguro mientras mantengas el acceso privado. El propio proyecto es claro: su modelo de amenazas asume usuarios de confianza en una red privada, así que trátalo como una consola de administración. Revisa la guía de seguridad oficial y esta lista antes del uso real:

• Autenticación activada: AUTH_ENABLED=true y LOCALHOST_BYPASS=false (ambos son los valores por defecto)
• Nunca expongas el puerto 7000 directamente a internet: para acceso remoto usa Tailscale, Cloudflare Access o WireGuard, nunca port forwarding
• HTTPS para todo lo que pase de localhost: Caddy o nginx como proxy inverso, o certificados de Tailscale
• Pocas cuentas admin y registro abierto desactivado; los agentes ejecutan shell y archivos sin sandbox (brecha conocida del proyecto), así que no apruebes a ciegas
• Respalda antes de actualizar: python3 scripts/odysseus-backup snapshot; luego git pull y docker compose up -d –build, preferiblemente en la rama main

Paso 7: Empieza a usar sus herramientas

Ya dentro del workspace, estas son las herramientas que vas a encontrar y para qué sirve cada una.

¿Algo falla? Problemas conocidos y su solución

El proyecto es joven y mantiene una lista pública de limitaciones; estos son los tropiezos más frecuentes documentados por el propio equipo y la comunidad.

¿Cuánto cuesta frente a ChatGPT y Claude de pago?

El software es gratis; el costo real está en el hardware, la electricidad o los tokens. Estas cifras son estimaciones en dólares publicadas por la guía oficial en agosto de 2026: trátalas como referencia.

La matemática del punto de equilibrio: una RTX 4060 de ~$300 se paga sola en unos 15 meses frente a una suscripción Plus de $20/mes. La guía oficial detalla el desglose completo de costos reales, incluida la ruta híbrida por OpenRouter.

La comparación detallada, incluido el inicio de sesión con tu suscripción de ChatGPT, está en la página oficial de Odysseus AI frente a ChatGPT.

Odysseus AI frente a Open WebUI y AnythingLLM

El punto fuerte de Odysseus es ser un espacio de trabajo todo en uno; sus rivales maduros concentran sus fortalezas en otros frentes.

El código y la comunidad viven en el repositorio oficial de Odysseus en GitHub, con 2.098 commits y unos 320 colaboradores hasta septiembre de 2026.

Preguntas frecuentes

¿Odysseus AI es gratis?

Sí. Es software libre bajo AGPL-3.0-or-later, sin suscripción ni capa freemium; el costo real es el hardware, la electricidad o las APIs de pago que decidas usar.

¿Necesito una GPU?

No es obligatoria: sin GPU puedes usar modelos pequeños de 1-4B parámetros o backends por API. Con una GPU de 8 GB o más la experiencia mejora notablemente.

¿Puedo usar mi suscripción de ChatGPT?

Sí: Odysseus permite iniciar sesión con una cuenta Plus o Pro mediante OAuth, usando la suscripción como backend sin API key ni facturación por token, respetando los límites de tu plan.

¿Es seguro autoalojarlo?

Sí, con acceso privado: autenticación activada, HTTPS más allá de localhost y acceso remoto por Tailscale, Cloudflare Access o VPN. Ten presente que los agentes no corren en sandbox, así que conviene aprobar cada acción y mantener pocas cuentas de administrador.