Odysseus 自托管 AI 工作台

Odysseus 是什么

Odysseus 是一个自托管的 AI 工作空间，目标是把日常工作中分散的 AI 工具集中到一个界面里：聊天、Agent、深度研究、文档写作、邮件、笔记、任务与日历。项目以 Python 为主，采用 AGPL-3.0 协议，目前在 GitHub 上已有近 10 万 Star。

它既可以使用云端 API 模型，也可以接入本地模型，适合对数据隐私有要求的团队或个人。

核心功能

• Chat + Agents：支持本地与 API 模型，具备工具调用、MCP、文件读写、Shell、技能与记忆能力。
• Cookbook：根据硬件情况推荐模型，并提供下载与本地服务管理。
• Deep Research：多步骤联网调研，读取来源并生成报告。
• Compare：多模型盲测对比，并可对结果做综合。
• Documents：写作优先的编辑器，支持 AI 改写、建议、Markdown、HTML、CSV 与语法高亮。
• Email：IMAP/SMTP 收件箱，支持分拣、标签、摘要、提醒与回复草稿。
• Notes / Tasks / Calendar：提醒、待办、定时 Agent 任务与 CalDAV 同步。
• 其他：图库与图片编辑、主题、上传、网页搜索、预设、会话管理与两步验证。

快速开始

官方推荐使用 Docker Compose 部署，仓库默认分支为 dev，追求稳定可选择 main 分支。

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

容器健康后访问 http://localhost:7011，初始管理员密码会打印在 docker compose logs odysseus 中。Compose 会优先拉取官方多架构镜像 ghcr.io/odysseus-dev/odysseus，拉取失败时才在本地构建，因此没有构建工具链的主机也能运行。

生产环境建议固定不可变标签，而不是使用 :latest：

ODYSSEUS_IMAGE=ghcr.io/odysseus-dev/odysseus:1.0.2-7c8070f docker compose up -d

原生安装、GPU 配置、Windows/macOS 说明与 HTTPS 配置可参考仓库中的 setup 指南。

安全注意事项

Odysseus 自带较强的本地工具能力，部署时需要注意：

• 任何可被网络访问的部署都应保持 AUTH_ENABLED=true。
• 非本地开发环境应保持 LOCALHOST_BYPASS=false。
• 不要把私有数据提交到 Git，也不要将模型或服务端口直接暴露到公网。

适合谁使用

如果你希望在自己的服务器上搭建一个统一的 AI 入口，把聊天、调研、写作、邮件与日程串起来，同时保留对模型与数据的控制权，Odysseus 是一个值得尝试的选择。功能较多，建议先按需启用模块，再逐步接入团队工作流。