Odysseus:把 ChatGPT 搬回本地跑

Odysseus 主界面预览

(题图:Odysseus 主界面,集聊天、Agent、研究、邮件于一体)


为什么你需要一个「自托管 AI 工作台」

过去一年,「本地跑 AI」的门槛降得很快。Ollama 一行命令跑模型,Open WebUI 提供一个还不错的聊天界面,AnythingLLM 能做 RAG——但拼在一起,总觉得差了点什么。

你想要的不只是「能聊」,而是:

  • Agent 能真正帮你做事(不只是回答)
  • 深度研究能自动搜资料、读来源、写报告
  • 邮件、日历、笔记能和 AI 打通
  • 所有数据都在自己手里,不发给第三方

这些需求,分开来看各有工具能解决;合在一起,就是一个「自托管的 ChatGPT/Claude 完整体验」。

Odysseus 就是冲着这个目标去做的。它不是简单的「Ollama 前端」,而是一个把所有能力整进同一个应用的 自托管 AI 工作台。目前在 GitHub 上已经突破 45,000 Star,是近期增长最快的开源 AI 项目之一。


Odysseus 是什么

官方定位很直接:

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

一句话:把 ChatGPT 和 Claude 给你的所有便利——聊天、Agent、深度研究、记忆、邮件、日历、笔记——用开源的方式重新实现一次,跑在你自己的硬件上。

几个关键特质:

  • 本地优先:模型跑在你自己的机器上,数据不出门
  • 无遥测:不收集用户数据,不打电话回家
  • MCP 就绪:完整支持 Model Context Protocol,可接任意 MCP Server
  • AGPL-3.0 开源:代码完全开放,可自由部署和修改

核心功能速览

Odysseus 的功能列表相当长,挑重点说:

1. Chat + Agents

最基础的聊天界面,但后端不绑死单一 provider:

  • 本地推理:支持 vLLM、llama.cpp、Ollama
  • 云端 API:OpenRouter、OpenAI 兼容接口随便接
  • Agent 模式:给模型配工具,让它自主规划、执行多步任务
  • 内置 opencode 作为 Agent runtime,完整支持 MCP

2. Cookbook(硬件感知的模型推荐)

这是最实用的功能之一——根据你自己的硬件,推荐能跑得动的模型:

  • 自动扫描 GPU 显存、系统内存
  • 给出 GGUF / FP8 / AWQ 格式的适配建议
  • 一键下载 + 一键起服务
  • 支持 270+ 模型目录

对 NAS 用户来说,这个功能很友好——不用自己算「我的 16GB 内存能跑哪款模型」。

3. Deep Research(深度研究)

基于阿里 DeepResearch 改造的多步研究流程:

  • 自动检索 → 阅读来源 → 综合信息 → 生成报告
  • 输出带引用的 Markdown 报告
  • 可导出为 HTML 分享

4. Compare(模型对比)

同一 prompt 同时丢给多个模型,支持盲测模式(隐藏模型名),还有一个「裁判模型」做综合评分。选模型、调 prompt 的时候很好用。

5. Memory + Skills(长期记忆与自进化技能)

  • 所有对话和 Agent 行为都会写入 ChromaDB 向量库
  • Embedding 用 fastembed(ONNX 推理,CPU 友好)
  • Skills 自进化:Agent 自己写技能、优化技能、复用技能,越用越懂你

6. Email Assistant

原生 IMAP/SMTP 支持,AI 自动处理邮件:

  • 智能摘要、风格匹配的草稿回复
  • 自动打标签、垃圾邮件识别
  • 多账号路由

7. Notes & Tasks & Calendar

  • 快速笔记 + Todo 清单
  • 定时 Agent 任务:可以让 Agent 在指定时间自动执行任务
  • CalDAV 同步(兼容 Radicale / Nextcloud / Apple Calendar)

快速部署:Docker Compose 方式

官方推荐的部署方式就是 Docker Compose,步骤很简单:

# 克隆仓库(默认分支 dev,追新功能;想要稳定一点用 main 分支)
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus

# 配置环境变量
cp .env.example .env
# 按需编辑 .env(模型路径、端口、邮件配置等)

# 启动
docker compose up -d --build

启动完成后访问 http://localhost:7000,首次登录密码会在 docker compose logs odysseus 里打印出来。

NAS 用户注意:项目还提供了 GPU 版本的 compose 文件:
docker-compose.gpu-nvidia.yml——NVIDIA GPU 用户
docker-compose.gpu-amd.md——AMD GPU 用户(是的,连 AMD 都考虑了)

没有独立显卡也完全没问题,CPU 模式能跑 7B-14B 参数的量化模型,够日常用了。


与同类工具对比

维度 Odysseus Open WebUI AnythingLLM LibreChat
聊天 UX ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐⭐
Agent/MCP ✅ 完整支持 ✅ 支持 ❌ 弱 ❌ 弱
深度研究 ✅ 内置
长期记忆 ✅ ChromaDB 部分 部分
邮件/日历 ✅ 原生
移动端 PWA
部署复杂度

结论很清晰:Open WebUI 最适合「就想聊聊天」的场景;Odysseus 适合想要完整体验、愿意折腾的用户


有什么坑

作为一个 2026 年 5 月底才出 v1.0 的项目,Odysseus 还有一些要注意的地方:

1. 资源占用不低

vLLM + ChromaDB + Agent runtime + IMAP 客户端同时跑,官方没给最低配置建议。根据社区反馈,16GB 内存是舒适运行的底线,想跑 30B+ 模型还得上显卡。

2. 早期项目,迭代快

dev 分支每天都有提交,功能在快速变动。部署了之后更新要做好数据备份,.env 和数据库卷记得单独保留。

3. 安全注意事项

Odysseus 有 shell 访问和文件上传能力,不要把管理端口直接暴露到公网。官方文档专门强调了这点——一定要开认证,不要暴露模型和服务的原始端口。

4. 多用户场景

目前看上去是单用户设计,家庭成员共享一个部署的话权限隔离还没做好。企业场景建议等后续版本。


适合谁用?

  • ✅ 已经在用 ChatGPT/Claude 付费版,但对数据归属有顾虑的用户
  • ✅ 家里有 NAS 或闲置电脑,想折腾本地 AI 的用户
  • ✅ 希望 Agent 有长期记忆、能感知邮件和日程的重度 AI 用户
  • ✅ 想把 AI 工作台当「个人操作系统」来定制的开发者

不适合:
– ❌ 只想「装个软件聊聊天」的用户(用 Ollama + Open WebUI 更轻量)
– ❌ 生产环境需要 SLA 保障的场景(项目还在快速迭代)
– ❌ 企业多租户场景(目前单用户设计)


总结

Odysseus 的野心很大——把 ChatGPT 和 Claude 的完整体验,在 2026 年用开源的方式重新实现一次,跑在你自己的硬件上。

它不一定适合每个人,但如果你符合上面说的「适合谁用」——值得花一个周末在 NAS 或闲置电脑上部署试试。45K Star 不是白给的,项目的迭代速度和社区活跃度都相当高。

下一步可以关注的方向:MCP 生态成熟度、移动端 PWA 离线能力、以及多用户隔离的进展。


项目地址
– GitHub: https://github.com/pewdiepie-archdaemon/odysseus
– 官方文档: 仓库 docs/setup.md
– 协议: AGPL-3.0-or-later

(本文基于官方文档及公开资料整理,未实际部署测试。部署前请务必阅读官方 Setup Guide。)