# Odysseus

> Odysseus is an AGPL-3.0 self-hosted web workspace: chat and agents (tools, MCP, files, shell, memory) on local or API models, a Cookbook that recommends, downloads and serves local models, multi-step web research, blind model comparison, a document editor, an IMAP/SMTP email client, and notes, tasks and CalDAV calendar. Install with Docker Compose or natively on Linux, macOS or Windows (Python 3.11+). It is free; you bring local hardware or paid API keys, so answer quality depends on the model you use. The \`dev\` branch is default and may be unstable.

- Repository: https://github.com/odysseus-dev/odysseus
- Official docs: https://github.com/odysseus-dev/odysseus#readme
- Checked: 2026-10-18

## What it replaces
- ChatGPT Plus: Chat assistant, Chat with your documents, Web search answers (partial). Replaces the chat interface, file chat and web research; answer quality depends on the local or API model you connect.
  - Use it instead of paying for ChatGPT Plus? Personal use: Yes. Business: Partly (Commercial use with conditions: Allowed under AGPL-3.0; modified versions offered over a network must share their source).

## Facts, with sources

| Question | Status | Answer | Source | Checked |
|---|---|---|---|---|
| Runs on my machine? | Confirmed | Yes, self-hosted with Docker or natively; local models optional | https://github.com/odysseus-dev/odysseus#readme | 2026-10-18 |
| Code licence | Partial | AGPL-3.0-or-later (copyleft) | https://github.com/odysseus-dev/odysseus/blob/dev/LICENSE | 2026-10-18 |
| Model weights licence | Confirmed | No separate model weights | https://github.com/odysseus-dev/odysseus#readme | 2026-10-18 |
| Commercial use | Partial | Allowed under AGPL-3.0; modified versions offered over a network must share their source | https://github.com/odysseus-dev/odysseus#readme | 2026-10-18 |
| Paid services needed? | Partial | None required if you run local models; paid model APIs optional | https://github.com/odysseus-dev/odysseus#readme | 2026-10-18 |
| Hardware | Confirmed | App is lightweight; local model serving depends on model, GPU and VRAM (NVIDIA and AMD Docker overlays; CPU-only works) | https://github.com/odysseus-dev/odysseus/blob/dev/website/setup.md | 2026-10-18 |
| Operating systems | Confirmed | Docker on any host; native Linux, macOS (incl. Apple Silicon) and Windows | https://github.com/odysseus-dev/odysseus/blob/dev/website/setup.md | 2026-10-18 |
| Setup effort | Confirmed | Medium, Docker Compose (or a Python 3.11+ native install) | https://github.com/odysseus-dev/odysseus#readme | 2026-10-18 |

GitHub: 94080 stars, 1702 forks, last push 2026-10-20, archived: no.
---
Source: RepoQuarry (https://repoquarry.dev/projects/odysseus). Data licence: CC BY 4.0. Quotes are from project documentation and belong to their authors.