Self-hosted AI workspace that refuses to stay in its lane
Odysseus is a self-hosted AI workspace that replicates the ChatGPT experience on your own hardware while also handling email, calendars, documents, and deep research without shipping your data to third-party clouds.
Odysseus bundles chat, agents, email, calendar, and research into a single self-hosted workspace that treats your hardware as first-class infrastructure, not an afterthought.

What it does
Odysseus is a web-based AI workspace that runs entirely on your own machine. It bundles chat, agentic tasks, document editing, deep research, email triage, calendar sync, and note-taking into a single interface that works on desktop and mobile. You can plug in local models via vLLM, llama.cpp, or Ollama, or use remote APIs like OpenAI and OpenRouter, and a built-in hardware scanner recommends models that actually fit your available VRAM.
The interesting bit
The project treats self-hosting as a feature rather than a compromise. It includes an AI-powered email client that auto-tags and drafts replies over IMAP/SMTP, a CalDAV-aware calendar, and a blind side-by-side model comparison tool, all wrapped in a UI that openly admits to having “more jank and fun” than polished SaaS alternatives. The Cookbook feature is particularly unusual: it probes your GPU setup, scores model compatibility, and can download and serve GGUF, FP8, or AWQ weights automatically.
Key highlights
- Chat and agent tools built on
opencodewith MCP support, plus persistent memory viaChromaDBandfastembed - Cookbook scans hardware and recommends VRAM-aware models, supporting
vLLM,llama.cpp, and Ollama backends - Deep Research adapted from Tongyi DeepResearch for multi-step source gathering and synthesis
- Full email client with AI triage, auto-summary, and spam detection over standard IMAP/SMTP
- Calendar, notes, tasks, and a multi-tab document editor with markdown and syntax highlighting
- Progressive web app with mobile support, 2FA, and theme editing
Caveats
- GPU passthrough in Docker requires manual host runtime configuration, and passing
nvidia-smiinto the container does not guaranteellama.cppcan actually see CUDA; you may need to reinstall the serve engine - Windows users cannot locally serve
vLLMorSGLangnatively and must rely on Ollama or WSL2 for GPU-backed models - The README repeatedly warns against exposing the instance directly to the public internet; it defaults to loopback binding and treats the app as an admin console because non-admin privileges still require careful review
Verdict
Worth a spin if you are tired of tab-switching between ChatGPT, your email client, and your calendar. Look elsewhere if you want a zero-config hosted service or if the phrase “GPU passthrough” makes you break out in hives.
Frequently asked
- What is odysseus-dev/odysseus?
- Odysseus is a self-hosted AI workspace that replicates the ChatGPT experience on your own hardware while also handling email, calendars, documents, and deep research without shipping your data to third-party clouds.
- Is odysseus open source?
- Yes — odysseus-dev/odysseus is open source, released under the AGPL-3.0 license.
- What language is odysseus written in?
- odysseus-dev/odysseus is primarily written in Python.
- How popular is odysseus?
- odysseus-dev/odysseus has 82.9k stars on GitHub and is currently cooling off.
- Where can I find odysseus?
- odysseus-dev/odysseus is on GitHub at https://github.com/odysseus-dev/odysseus.