Illustration of what odysseus does: Self-hosted workspace for AI chat, agents, research, documents, email and calendar

odysseus-dev /

odysseus

Self-hosted workspace for AI chat, agents, research, documents, email and calendar

  • 94.2k stars
  • 5.8k stars since 3 Oct
  • Python
  • Updated today
  • Some experience
  • Models & local AI
Open on GitHub (opens in a new tab) Website (opens in a new tab)

Odysseus is an AI workspace you run on your own machine or server. Instead of separate apps for chatting with a model, writing documents, reading email and keeping a calendar, you get them in one web interface with AI built into each part.

You start it with Docker Compose and open it in the browser at localhost:7000. It can use models you host locally or hosted APIs. Agents can use tools, MCP, files, a shell, skills and memory. A Cookbook section suggests models that fit your hardware, then downloads and serves them.

The README does not compare it to other projects by name. The difference is breadth: IMAP/SMTP email, CalDAV calendar sync, a writing-focused editor and blind model comparison all sit beside the chat. The README warns it has powerful local tools, so keep authentication on if it is reachable over a network.

What it does

  • Chat and agents

    Works with local or API models. Agents can use tools, MCP, files, a shell, skills and memory.

  • Cookbook for local models

    Recommends models that suit your hardware, then handles downloading and serving them.

  • Deep Research

    Runs multi-step web research, reads the sources and produces a report.

  • Compare

    Tests models side by side in a blind format, then helps synthesize the answers.

  • Email, notes and calendar

    IMAP/SMTP inbox with triage, tags, summaries, reminders and reply drafts, plus todos, scheduled agent tasks and CalDAV sync.

What you could build

  • Run a private chat assistant on your own hardware with a local model.
  • Ask an agent to research a topic on the web and write up a sourced report.
  • Compare two or more models on your own prompts without knowing which is which.
  • Triage an email inbox with AI summaries and reply drafts.
  • Draft and edit documents with AI suggestions in a Markdown editor.

Get started

Clone the repo, copy .env.example to .env, and start it with Docker Compose. Open http://localhost:7000 once the containers are healthy, and find the first admin password in the odysseus container logs.

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

Commands are copied from the project's README. Read it on GitHub for the full setup.

More in Models & local AI

See all
transformers Shared model definitions for text, vision, audio and multimodal AI models 168k open-webui Self-hosted chat interface for Ollama and OpenAI-compatible models, with RAG and plugins 156.5k2.7k minimind Train a tiny 64M-parameter language model from scratch on one consumer GPU 64.3k1.2k Kronos Pre-trained Transformer models that forecast candlestick (K-line) price data 43.2k3.4k airllm Run very large open language models on a small GPU by loading one layer at a time 40.4k5.1k Vane Self-hosted AI answer engine that searches the web and cites its sources 37.7k681 timesfm Pretrained Google model that forecasts time series without training on your data 34.7k668 Unlimited-OCR Open OCR model that turns images and multi-page PDFs into structured text in one pass 28.2k1.6k gallery Android and iOS app for running open LLMs offline on your phone 25.1k252 lingbot-map Feed-forward model that builds 3D scenes from video frames as they stream in 18.2k989

    ↑↓ to move, Enter to open, Esc to close