大家好,我是何三,独立开发者
有个项目叫 Odysseus,38.4k Star(近 4 万),直接给你在本地跑一个 ChatGPT + Claude 体验的 AI 工作台。聊天、自动写代码、深度研究、文档编辑、邮件管理、日历同步……全都有。
最离谱的是,一个 docker compose up 就搞定了。
说实话,我第一反应是——又一个画饼项目。但翻完 README 之后,我服了。
这不是一个简单的聊天 UI
市面上自托管 AI 项目挺多的。要么只能聊天,要么只能跑模型,要么文档烂得跟谜语人似的。
Odysseus 的 Feature 列表长得像在跟 OpenAI 宣战:
- Chat — 接 vLLM、llama.cpp、Ollama、OpenRouter、OpenAI,想接哪个接哪个
- Agent — 给它工具自己去干活。MCP 协议、浏览器、文件、Shell、技能、记忆全都能用
- Cookbook — 扫你的硬件配置,推荐能跑啥模型,点一下自动下载部署
- Deep Research — 跟 ChatGPT 那个深度研究一样,自动阅读、分析、生成报告
- Compare — 模型盲测对比,左右互搏,排除偏见
- Documents — AI 辅助写作,不是替你写,是帮你改
- Email — IMAP/SMTP 集成,AI 自动分类、摘要、草稿回复
- Calendar — 本地优先,同步 CalDAV(支持 Nextcloud、Apple、Fastmail)
- Notes & Tasks — 带提醒的笔记、待办、定时任务
- Memory / Skills — Agent 会记住你,会学习新技能,越用越懂你
一个项目,十二个功能模块。

而且它支持 PWA,手机上也能用,响应式布局,触摸手势,装到手机桌面就跟原生 APP 一样。
没懂作者是怎么在维护这个项目的同时,还有时间睡觉的。
聊聊它的设计思路
之前我用过不少自托管 AI 项目,最大的问题是什么?装完不知道干嘛。配模型配半天,写了条 prompt 发现体验还不如网页版。
Odysseus 的思路反过来了——先给你桌面级的 UI 体验,模型的事儿一步步来。
它有 Cookbook 这个模块,我第一次在自托管项目里看到。点进去,它会先扫你的显卡,告诉你 VRAM 多少,然后推荐适合你硬件跑的模型。GGUF、FP8、AWQ,点一下下载,点一下部署,就完事了。
说白了,以前你要自己翻 HuggingFace 找模型、自己配参数、自己写启动脚本,现在它全帮你干了。
这个 Cookbook 基于一个叫 llmfit 的工具,专门做 VRAM 感知的模型适配评分。你的 8GB 显卡能跑啥、你的 24GB 能跑啥,它算得明明白白。
说到这里想起个事。之前我折腾 Stable Diffusion,为了装个模型翻了一晚上教程。那时候要是有人写个工具自动推荐、一键部署,我可能会哭出来。现在 Odysseus 把这个思路搬到 LLM 上了。
上手:真的就一行命令
Docker 部署:
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build
打开 http://localhost:7000。
第一次启动会自动创建 admin 账号,密码在终端里或者 docker compose logs odysseus 里。登录进 Settings 配模型、搜索引擎和邮箱就行。
苹果 M 系列想用 GPU 加速,有专门的 start-macos.sh 脚本:
./start-macos.sh
为什么 macOS 要单独搞一套?别问我,问 Apple 去。Docker 在 macOS 上不能用 Metal GPU 直通,所以他们写了套原生的启动流程。
Windows 用户也有 launch-windows.ps1,一行代码跑起来。
反正不管你是啥系统,从 clone 到看见聊天界面,五分钟以内。
同类工具链
说到自托管 AI 平台,大家最熟悉的可能是 Ollama + Open WebUI 这个组合。
Ollama 负责拉模型跑模型,Open WebUI 负责聊天界面。但 Odysseus 的定位要重得多——它不只是聊天界面,而是完整的 AI 工作空间。
如果你只是想快速跑个对话体验一下,Ollama 更轻量。如果你想要一个能替代 ChatGPT Plus 的自托管方案,Odysseus 更全面。
觉得自托管 AI 有意思?我之前写过一篇《自托管才是未来:这些开源项目让你彻底摆脱 SaaS》,关注后回复「自托管」就能看。
隐私与安全问题
自己跑东西,最爽的就是数据在自己手里。
Odysseus 默认只绑定本地,外面访问不了。所有数据存在 data/ 目录里,包括对话、文档、记忆、邮件缓存。要暴露到局域网或公网,需要手动改配置,而且作者在安全文档里写了两万多字的注意事项——从 GPU 直通到反向代理,从 auth 配置到密钥轮换,全讲清楚了。这在开源项目里真的少见。
原理大概是这样,细节可能有出入——有懂的大佬欢迎指正。
总结
Odysseus 是我今年看到的完成度最高的自托管 AI 项目之一。38.4k Star(近 4 万)不是白来的——功能密度和质量都让人服气。
缺点也有:功能太多导致学习曲线有点陡,第一次进去得花点时间配环境。但怎么说呢,装完之后的体验——值。
项目地址:https://github.com/pewdiepie-archdaemon/odysseus
本文使用 MGO 编辑并发布
关注"何三笔记",回复"mgo" 免费下载使用