/proyectos/odysseus-ai

Odysseus AI — Tu propio workspace de IA self-hosted

Un workspace open source (AGPL-3.0) que reemplaza un puñado de suscripciones: chat con modelos, agentes, investigación profunda, documentos, email, notas, calendario y herramientas locales, todo en tu hardware.

8 de octubre de 2026 · 4 min de lectura

Odysseus AI — Tu propio workspace de IA self-hosted

Qué es

Odysseus AI es un workspace de IA self-hosted open source (AGPL-3.0) que mete en una sola app web todo lo que normalmente tenés repartido entre ChatGPT, Notion, Gmail, un cliente de notas y un asistente de investigación: chat con modelos locales o por API, agentes con herramientas, investigación profunda, documentos colaborativos, email, notas, calendario y un cookbook con recomendaciones de modelos según tu hardware.

El repo vive en odysseus-dev/odysseus y suma 86.900 estrellas y 813 forks en GitHub. El proyecto lo hizo público PewDiePie (Felix Kjellberg) — dato que aparece en varios repos derivados, aunque el repo canónico lo mantiene el equipo odysseus-dev. Es uno de los repos self-hosted de IA más populares del momento.

Cómo funciona por dentro

Odysseus es una app web servida por Flask (app.py) con un frontend en Node y un stack completo levantado con Docker Compose. La instalación es deliberadamente corta:

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build

Una vez que los containers están healthy, abrís http://localhost:7000 y tenés el workspace funcionando. La contraseña del primer admin aparece en los logs de docker compose.

La arquitectura está modularizada en servicios:

  • core/ — lógica central del workspace y orquestación.
  • routes/ — endpoints HTTP de la API.
  • services/ — integraciones con modelos, email, calendario y storage.
  • integrations/ — conectores externos (MCP, SearXNG, providers de modelos).
  • mcp_servers/ — servidores MCP propios que exponen capacidades de Odysseus a otros agentes.
  • companion/ — apps móviles y de escritorio que se conectan al workspace.
  • docker/ — imágenes Docker oficiales (CPU, NVIDIA, AMD).

Trae compose files separados para tres perfiles de hardware: docker-compose.yml (CPU), docker-compose.gpu-nvidia.yml (GPU NVIDIA) y docker-compose.gpu-amd.yml (GPU AMD). Es una decisión que pocos proyectos self-hosted toman y vale oro si tenés una workstation con GPU.

Qué trae la caja

Lo que distingue a Odysseus de un wrapper de LLM es la cantidad de módulos útiles que ya vienen integrados:

  • Chat + Agentes — modelos locales o por API, herramientas, MCP, acceso a archivos, shell, skills y memoria persistente.
  • Cookbook — recomendaciones de modelos según tu hardware, descargas y serving.
  • Deep Research — investigación web multi-paso con lectura de fuentes y generación de informes.
  • Compare — pruebas ciegas side-by-side de modelos con síntesis automática.
  • Documents — editor orientado a escritura con edición asistida por IA, sugerencias, Markdown, HTML, CSV y syntax highlighting.
  • Email — inbox IMAP/SMTP con triaje, tags, resúmenes, recordatorios y borradores de respuesta.
  • Notes, Tasks + Calendar — recordatorios, todos, tareas programadas y sync CalDAV.
  • Extras — galería/editor de imágenes, themes, uploads, búsqueda web, presets, sesiones y 2FA.

MCP es ciudadano de primera: tiene su propia carpeta mcp_servers/ y los agentes pueden usar servidores MCP externos desde el chat. Si ya usás Claude Desktop o Cursor con MCP, vas a sentirte como en casa.

Por qué importa

Hay tres razones por las que Odysseus se ganó un lugar en el radar:

  • Es un reemplazo real de stack, no una demo. Chat + email + notas + calendario + documentos + agentes, todo en tu hardware, todo open source. No es vaporware: el repo tiene 86.900 estrellas, commits diarios y un roadmap público (ROADMAP.md).
  • Honra self-hosted como filosofia. AGPL-3.0, datos en tu servidor, auth y 2FA propios, modelos locales soportados con cookbooks por hardware, y avisos claros en SECURITY.md y THREAT_MODEL.md sobre qué no exponer públicamente.
  • El autor es improbable. Que PewDiePie (Felix Kjellberg) sea quien empujó el proyecto open source no le quita mérito — al contrario, le dio una distribución masiva. Pero el repo canónico vive en odysseus-dev/odysseus y lo mantiene un equipo dedicado, no su cuenta personal de GitHub.

Si venís frustrado de pagar 5 suscripciones y tener tus datos fragmentados en 5 servicios distintos, este es el tipo de proyecto que te cambia el día.

Siguiente paso

Si querés probarlo, la vía más rápida es la del README:

  1. Cloná el repo: git clone https://github.com/odysseus-dev/odysseus.git.
  2. Copiá .env.example a .env y dejá los defaults si querés arrancar rápido.
  3. Levantá el stack: docker compose up -d --build.
  4. Abrí http://localhost:7000, tomá la contraseña del primer admin de los logs y entrá.

Si tenés GPU NVIDIA, cambiá a docker-compose.gpu-nvidia.yml. Si tenés AMD, hay compose específico también. La guía completa (website/setup.md) cubre HTTPS, CalDAV, email y configuración de proveedores de modelos.

El proyecto vive y se mueve: el ROADMAP.md es público, los Discussions están abiertos y los issues suman actividad diaria. Buen momento para sumarse.

Enlaces oficiales

Ir al proyecto →
← Todos los proyectos