Odysseus
Odysseus 是自托管 AI 工作台:聊天、Agent、本地模型、知识库、邮件日历任务等收进同一个界面,数据落在自己的机器上。定位接近「把 ChatGPT / Claude 那套体验搬回家」,但模块更全、可自托管。
下面按左侧导航逐项说我会用到的功能和优势;安装一笔带过。
安装
$ git clone https://github.com/pewdiepie-archdaemon/odysseus.git
$ cd odysseus
$ cp .env.example .env # 可选
$ docker compose up -d --build打开 http://localhost:7000。首次启动日志里会打印 admin 临时密码,登录后在 Settings 改掉。macOS Apple Silicon 若要 Cookbook 吃 Metal GPU,用 ./start-macos.sh(默认 7860 端口)。
Chats:聊天与 Agent
侧栏 Chats 是主入口。同一列表里既有普通对话,也有带 >_ 图标的 Agent 会话——后者基于 opencode,能挂工具自己跑完任务。
| 能力 | 优势 |
|---|---|
| 多模型切换 | 本地 Ollama、Cookbook 拉起的 vLLM/llama.cpp、云端 OpenAI/OpenRouter 都在 Settings 里配,会话级选模型 |
| 普通 Chat | 快问快答、续写、vision 上传(图片/PDF) |
| Agent | MCP、网页搜索、文件读写、Shell、Skills、Memory 一并可用 |
| 会话历史 | 侧栏按时间排列,搜索框可跨会话检索 |
接 Ollama 最常见:http://localhost:11434/v1。Docker 容器连宿主机 Ollama 用 http://host.docker.internal:11434/v1,宿主机需 OLLAMA_HOST=0.0.0.0:11434 ollama serve。
Agent 非 admin 默认没有 Shell / 敏感写权限;多人共用逐个看 Privileges。
Brain:长期记忆
Brain 对应向量记忆(ChromaDB + fastembed)。优势是跨会话记住偏好、项目背景、常用事实,Agent 和 Chat 都能检索;支持导入/导出,不像纯聊天记录那样每次从零开始。
排查记忆是否降级:
$ docker compose logs odysseus | grep -E 'ChromaDB|MemoryVectorStore|DEGRADED'Email
Email 接 IMAP/SMTP,带 AI 分拣: urgency 提醒、自动标签、摘要、草稿回复、垃圾邮件判断。多账号可分别路由;和 Calendar 联动,适合「邮件 + 日程」在一个工作台里处理,不用切客户端。
Calendar
Calendar 本地优先,支持 CalDAV 同步(Radicale / Nextcloud / Apple / Fastmail 等),.ics 导入导出、多日历配色。Agent 能感知日程上下文——例如问「这周有什么会」或让 Agent 根据空闲时间排任务。
Notes & Tasks
Notes:随手记 + 提醒,可 ping(ntfy / 浏览器 / 邮件通道)。
Tasks:待办清单 + 定时任务,Agent 可按 cron 风格执行(例如每天汇总、定期清理)。
优势是把「想起来就记」和「要按时做」放在 AI 旁边,Reminder 和 Agent 动作共用同一套通知。
Compare
Compare 多模型盲测:并排输出,测完再揭晓模型名。优势是避免「贵的就是好 / 本地一定差」的先入为主,同一 prompt 下直观看风格、速度、事实性差异。和 Chats 里手动换模型相比,更适合做选型。
Cookbook
Cookbook 扫硬件、推荐模型、一键下载并 serve(基于 llmfit):
| 点 | 说明 |
|---|---|
| VRAM 感知 | 按显存/内存推荐 GGUF / FP8 / AWQ |
| 一键 serve | vLLM、llama.cpp 等,Docker 下缓存在 ./data/huggingface |
| 远程 GPU | Cookbook → Settings → Servers 生成 SSH 公钥,ssh-copy-id 到远端 |
macOS 原生走 Metal + llama.cpp/Ollama;vLLM/SGLang 需 CUDA/ROCm。NVIDIA Docker 用 scripts/check-docker-gpu.sh 诊断后再 --enable-nvidia-overlay。
Deep Research
Deep Research 多步检索、读源、合成可视化报告(思路来自 Tongyi DeepResearch)。优势是一次 Chat 搞不定的「先广搜、再深读、再写长文」,交给专门流程而不是自己拆 prompt。
Gallery
Gallery 集中看生成/上传的图片与媒体,和 Chat 里的 vision、Documents 里的附件分开管理,找历史出图不用翻会话。
Library
Library(+) 是文档库:上传 PDF、Markdown 等供 AI 引用。和 Brain 的记忆不同,Library 偏静态资料(手册、论文、项目文档),适合 RAG 式问答。侧栏 + 快速添加入库文件。
其他
| 项 | 说明 |
|---|---|
| Search | 顶栏搜索,跨 Chats / 内容检索 |
| Theme | 深浅色、主题编辑 |
| PWA | 手机浏览器可安装,布局 responsive |
数据都在 data/(app.db、uploads、chroma、huggingface 等),备份整目录即可。
安全
带 Shell、文件、模型下载、邮件 Token,当管理员控制台用:
| 项 | 建议 |
|---|---|
AUTH_ENABLED | 保持 true |
LOCALHOST_BYPASS | 仅本机开发 |
| 公网 | HTTPS + 反代,勿裸奔 0.0.0.0:7000 |
| 内网服务 | SearXNG、ChromaDB、Ollama 端口不对外 |