odysseus

Odysseus 是一款开源自托管AI工作区，集成了聊天、Agent、深度研究、文档编辑、邮件、日历、笔记等十余种功能模块，支持连接多种本地和云端大模型，是ChatGPT和Claude的本地替代方案。 一、快速开始 Odysseus 采用 Docker 部署，步骤如下： 1. 确保你的电脑已安装 Docker 和 Docker Compose。 2. 打开终端，执行命令克隆项目仓库：git clone https://github.com/odysseus-ai/odysseus.git 3. 进入项目目录，执行 docker compose up -d 启动服务。 4. 等待镜像拉取完成后，在浏览器中访问 http://localhost:3000 即可打开 Odysseus 界面。 5. 首次使用需创建管理员账号，按页面提示填写用户名和密码即可完成注册。 二、核心功能演示 功能1：连接本地模型 进入设置页面，点击「模型配置」选项。Odysseus 支持 vLLM、llama.cpp、Ollama、OpenRouter 等多种后端。以 Ollama 为例，选择 Ollama 作为提供商，填写本地服务地址（通常为 http://localhost:11434），保存后系统会自动扫描可用模型列表。内置的 Cookbook 功能还能检测你的硬件配置，推荐适合运行的模型。 功能2：深度研究模式 在聊天界面中，点击顶部的「深度研究」模式切换按钮。输入你的研究问题后，系统会自动进行多轮搜索、信息整合和分析，最终生成结构化的研究报告。相比普通聊天，深度研究模式会调用更多工具、花费更长时间，但输出质量显著更高，适合需要深入调研的场景。 功能3：文档编辑与笔记管理 点击左侧导航栏的「文档」模块，可以创建和编辑富文本文档。Odysseus 的文档编辑器支持 AI 辅助写作，你可以选中任意文字后调用 AI 进行改写、续写或总结。笔记模块则支持待办事项管理，可以设置提醒日期和优先级，将 AI 对话中的重要内容快速转为笔记保存。 三、实际使用案例 案例1：本地知识库问答 将公司内部文档上传到 Odysseus 的知识库中，连接本地部署的模型后，员工可以通过聊天界面直接询问关于公司制度、产品文档等问题。所有数据都在本地服务器上，不会外泄，适合对数据安全有要求的企业。 案例2：个人全能工作台 将日常使用的聊天、笔记、日历、邮件集中在一个界面中。早晨打开 Odysseus 查看今日日程，用 AI 规划工作安排，处理邮件时让 AI 辅助撰写回复，遇到技术问题直接在聊天中提问，所有工作流无缝衔接。 四、常见问题 Q1：我的电脑没有独立显卡，能运行 Odysseus 吗？ 可以。Odysseus 本身只是前端工作区，对硬件要求不高。如果需要运行本地模型，则需要 GPU。你也可以选择连接云端模型服务（如 OpenRouter），这样即使没有显卡也能正常使用所有功能。 Q2：支持哪些操作系统？ Odysseus 通过 Docker 运行，支持 Windows、macOS 和 Linux。macOS 用户如果使用 Apple Silicon 芯片，Odysseus 也做了专门适配，可以利用 Neural Engine 加速推理。 Q3：数据存储在哪里？ 所有数据默认存储在你运行 Docker 的本地服务器上。你可以通过挂载 Docker 卷来自定义数据存储路径，方便备份和迁移。 五、小贴士 1. 善用 Cookbook 推荐功能，它会根据你的 GPU 型号和显存大小推荐最合适的模型，避免盲目下载导致资源浪费。 2. 在团队使用场景中，可以为不同成员创建独立的工作空间，各自的数据和对话记录相互隔离。 3. 定期备份 Docker 卷中的数据目录，防止因服务器故障导致数据丢失。