project
Odysseus - 开源的本地自托管 AI 工作空间
Odysseus 是开源自托管的 AI 工作空间，提供类似 ChatGPT / Claude 的聊天界面，工具完全本地化运行，数据不出本机、隐私零泄露。
Odysseus是什么
Odysseus 是开源自托管的 AI 工作空间，提供类似 ChatGPT / Claude 的聊天界面，工具完全本地化运行，数据不出本机、隐私零泄露。工具集成聊天、Agent、深度研究、笔记、任务、日历、邮件、模型对比等十余项功能，支持 vLLM、Ollama、OpenRouter 等多种模型后端，是个人与团队的私有化 AI 中枢。
Odysseus的主要功能
-
AI 聊天：支持本地模型（vLLM、llama.cpp、Ollama）与 API（OpenAI、OpenRouter）对话，添加模型非常简单。
-
Agent 智能体：赋予工具后自主完成任务，支持 MCP、网页、文件、Shell、技能与记忆。
-
Cookbook 模型库：扫描硬件并推荐适配模型，一键下载启动，支持 GGUF / FP8 / AWQ 等格式。
-
深度研究：多步执行，自动收集、阅读并综合来源，生成精美可视化报告。
-
模型盲测对比：并排对比多模型输出，完全匿名投票，消除偏见。
-
文档编辑器：多标签 Markdown / HTML / CSV 编辑器，AI 辅助写作而非主导。
-
记忆与技能：基于 ChromaDB + fastembed 的持久化向量记忆，智能体随时间进化。
-
邮件客户端：内置 IMAP/SMTP 收件箱，支持 AI 智能分类、自动摘要、自动回复草稿与垃圾过滤。
-
笔记与任务：快速笔记、待办清单、定时任务，支持 ntfy / 浏览器 / 邮件提醒。
-
日历管理：本地优先 CalDAV 日历，可同步 Radicale / Nextcloud / Apple / Fastmail。
-
移动端支持：响应式 PWA 设计，支持触屏手势，手机端可用。
-
更多工具：内置图片编辑器、主题编辑器、网页搜索、文件上传（视觉 + PDF）、2FA 等。
Odysseus的技术原理
- 前端架构：基于现代 Web 技术栈构建响应式 PWA 界面，支持主题编辑器与多标签文档编辑器（Markdown / HTML / CSV），通过浏览器安装实现跨设备原生体验，同时集成 2FA 认证保障访问安全。
- 模型推理层：通过统一抽象层对接多种后端，本地侧支持 vLLM、llama.cpp、Ollama 等推理引擎，云端侧兼容 OpenAI、OpenRouter 等 API，实现多模型统一调度与无缝切换。
- Agent 执行框架：基于 opencode 与 MCP（Model Context Protocol）标准构建工具调用体系，赋予 LLM 访问 Shell、网页、文件系统的能力，支持自主任务规划、多步执行与工具链编排。
- 记忆检索系统：采用 ChromaDB 作为本地向量数据库，结合 fastembed（ONNX 运行时）在本地完成嵌入生成，支持向量相似度检索与关键词检索双模式，实现持久化记忆与技能的导入导出。
- Cookbook 模型适配：通过 llmfit 扫描硬件 VRAM 容量，自动评估 GGUF / FP8 / AWQ 等量化格式与当前硬件的适配度评分，一键拉起 vLLM 或 llama.cpp 后台服务，依赖 tmux 实现下载与推理进程守护。
- 深度研究引擎：借鉴 Tongyi DeepResearch 架构设计，实现多步信息收集、来源可信度评估、阅读提取与综合推理，最终生成带有可视化呈现的结构化研究报告。
如何使用Odysseus
- Docker 部署：
- 克隆仓库到本地：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git - 进入项目目录：
cd odysseus - 复制环境配置文件：
cp .env.example .env - 构建并启动容器：
docker compose up -d --build - 浏览器访问
http://localhost:7000进入系统。 - 查看终端或 Docker 日志获取临时管理员密码完成首次登录。
- 克隆仓库到本地：
- Apple Silicon（M 系列）原生部署：
- 克隆仓库到本地：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git - 进入项目目录：
cd odysseus - 执行启动脚本：
./start-macos.sh - 浏览器访问
http://127.0.0.1:7860即可使用，支持 Metal GPU 加速。
- 克隆仓库到本地：
- Windows 一键部署：
- 克隆仓库到本地：
git clone https://github.com/pewdiepie-archdaemon/odysseus.git - 进入项目目录：
cd odysseus - 执行 PowerShell 启动脚本：
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1 - 按脚本提示完成自动安装后，浏览器访问本地地址即可使用。
- 克隆仓库到本地：
Odysseus的核心优势
-
本地优先、隐私优先：所有数据存储在本地，无需上传云端，彻底杜绝隐私泄露与后门风险。
-
开箱即用：默认配置可运行，无需复杂环境搭建，Docker / 原生 / macOS App 多平台一键部署。
-
All-in-One 工作空间：将聊天、研究、笔记、任务、日历、邮件整合为统一界面，减少工具切换。
-
模型生态开放：不绑定单一模型，兼容本地推理与云端 API，Cookbook 自动匹配硬件与模型。
-
Agent 可进化：持久化记忆 + 技能系统让智能体越用越懂用户，支持 MCP 标准扩展工具。
Odysseus的项目地址
- 项目官网：https://pewdiepie-archdaemon.github.io/odysseus/
- GitHub仓库：https://github.com/pewdiepie-archdaemon/odysseus
Odysseus的同类竞品对比
| 维度 | Odysseus | Open WebUI |
|---|---|---|
| 前端 | 现代 Web 技术栈，PWA 架构，内置主题编辑器与图片编辑器 | 基于 Svelte 的现代化聊天界面，简洁美观 |
| 后端 | Python（FastAPI / Uvicorn），模块化设计 | Python（FastAPI），与 Ollama 深度集成 |
| 向量数据库 | ChromaDB 本地持久化 | 无原生向量库，RAG 通过临时处理实现 |
| 部署方式 | Docker / 原生 Linux / macOS App / Windows 脚本 / PWA | Docker / 原生（主要面向 Docker） |
| GPU 加速 | 支持 Metal（Apple Silicon）、CUDA，Cookbook 自动感知硬件 | 依赖 Ollama 的底层 GPU 支持 |
| 扩展协议 | MCP（Model Context Protocol）标准工具扩展 | 自定义 Pipelines 与 Functions 扩展 |
Odysseus的应用场景
-
个人隐私 AI 助手：在本地设备上安全使用大模型，敏感数据永不离开本机。
-
开发者本地 LLM 实验室：快速切换、对比、评测不同开源模型，进行盲测与性能分析。
-
研究者深度调研：利用 Agent 自动收集文献、生成结构化研究报告并可视化呈现。
-
团队私有化知识库：结合向量记忆与文档编辑，构建内部问答与写作协作平台。
-
个人效率管理：集成笔记、待办、日历与邮件，打造 AI 驱动的个人生产力中枢。