Skip to content
0
/ Agent/Odysseus
11/18/2026
4.4m

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)
AgentMCP、网页搜索、文件读写、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
一键 servevLLM、llama.cpp 等,Docker 下缓存在 ./data/huggingface
远程 GPUCookbook → 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 集中看生成/上传的图片与媒体,和 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 端口不对外

延伸阅读 ​

README · ROADMAP

Released under the MIT License.