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

Quick Start · Setup Guide · 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 — 19+ providers out of the box (Anthropic, OpenAI, DeepSeek, Kimi/Moonshot, OpenRouter, Ollama Cloud, Groq, Mistral, Together AI, Fireworks, Gemini, xAI Grok, Z.AI, NVIDIA, OpenCode Zen/Go, and more), plus subscription bridges for GitHub Copilot and ChatGPT. Tool-using agent with MCP, files, shell, skills, and memory.
• Cookbook — hardware-aware model recommendations, downloads, and vLLM/llama.cpp serving, with llama.cpp auto-detection.
• Deep Research — multi-step web research with source reading, category-aware formatting, and report generation.
• RSS Feed Reader — 3-pane feed reader with nested groups, AI summaries, full-content extraction, OPML import/export, and YouTube channel support.
• 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, 13 canvas background animations (aurora, matrix rain, nebula, hex grid, and more), neon glow theme toggle, user avatars, 10 pluggable web search providers (SearXNG, Brave, Bing, Tavily, Serper, Exa, Firecrawl, and more), presets, sessions, and 2FA.

Demo

A full hover-to-play tour lives on the Odysseus landing page. Its source lives under website/.

Contributing

Help is welcome. The best entry points are fresh-install testing, provider setup bugs, mobile/editor polish, docs, and small focused refactors. See CONTRIBUTING.md and ROADMAP.md.

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/service ports publicly.

• Keep AUTH_ENABLED=true for any network-accessible deployment.
• Keep LOCALHOST_BYPASS=false outside local development.

Deployment details are in the setup guide.

Star History

License

AGPL-3.0-or-later -- see LICENSE and ACKNOWLEDGMENTS.md.