Odysseus

A self-hosted AI workspace for chat, agents, research, documents, email, notes, calendar, and local model workflows.

Quick Start · Setup Guide · Architecture · Security · Contributing · Roadmap

---

Quick Start

dev is the default branch and gets the newest changes first. Use main if you want the more curated branch.

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

Open http://localhost:7000 when the containers are healthy. The first admin password is printed in docker compose logs odysseus.

Native installs, GPU notes, Windows/macOS instructions, HTTPS, and configuration live in the setup guide.

Features

• Chat + Agents — local/API models, tools, MCP, files, shell, skills, and memory.
• Cookbook — hardware-aware model recommendations, downloads, and serving.
• Deep Research — multi-step web research with source reading and report generation.
• Compare — blind side-by-side model testing and synthesis.
• Documents — writing-first editor with AI edits, suggestions, Markdown, HTML, CSV, and syntax highlighting.
• Email — IMAP/SMTP inbox with triage, tags, summaries, reminders, and reply drafts.
• Notes, Tasks + Calendar — reminders, todos, scheduled agent tasks, and CalDAV sync.
• Extras — gallery/image editor, themes, uploads, web search, presets, sessions, and 2FA.

Demo

Explore the interface through the interactive product tour.

Contributing

Help is welcome. The best entry points are fresh-install testing, provider setup bugs, mobile/editor polish, documentation, and small focused refactors. Read the contributing guide, review the public roadmap, and browse the open GitHub issues.

Security

Odysseus is a self-hosted workspace with powerful local tools. Keep auth enabled, keep private data out of Git, and do not expose raw model or service ports publicly. Read the security policy and the deployment security guidance.

Star History

License

Licensed under AGPL-3.0-or-later. See the license and acknowledgments.