odysseus 使用教程
从入门到精通的完整指南
odysseus 简介
Odysseus是一款自托管的AI工作区，旨在提供ChatGPT和Claude的本地替代体验。它集成了聊天、Agent、深度研究、文档编辑、邮件管理、日历、笔记任务等十余种功能模块。支持连接vLLM、llama.cpp、Ollama、OpenRouter等多种本地和云端模型。内置Cookbook功能可自动扫描硬件并推荐适合的模型。采用Docker部署，支持NVIDIA/AMD GPU和Apple Silicon，数据完全本地存储。已获超7万GitHub Star，采用AGPL-3.0协议，是功能最全面的开源AI工作区之一。
详细功能介绍
【工具简介】Odysseus是一款功能全面的自托管AI工作区，提供聊天、Agent、深度研究、文档、邮件、日历等一站式AI能力，数据完全本地存储。
【核心功能】①多模型聊天与Agent：支持vLLM、llama.cpp、Ollama、OpenRouter、OpenAI等多种模型后端，内置Agent可自主调用工具完成复杂任务。②深度研究：多步骤自动收集、阅读和综合信息源，生成可视化研究报告，适合深度调研场景。③Cookbook智能推荐：自动扫描硬件配置，推荐最适合的本地模型，一键下载并启动服务，支持VRAM感知评分。④全功能办公套件：内置文档编辑器（Markdown/HTML/CSV）、邮件客户端（IMAP/SMTP）、日历（CalDAV同步）、笔记和任务管理。⑤记忆与技能系统：基于ChromaDB向量数据库的持久化记忆和技能系统，Agent可随使用不断进化。
【适用场景】①个人AI工作站：作为日常AI助手，集成聊天、研究、文档、邮件等全方位个人生产力工具。②团队本地AI平台：在团队内部署，提供统一的AI能力入口，数据不出内网满足安全要求。③模型评估与测试：利用Compare功能进行多模型盲测对比，帮助选择最适合业务场景的模型。
【快速入门】①Docker部署：克隆仓库，复制.env.example为.env，执行docker compose up -d --build。②首次登录：使用终端显示的临时密码登录管理界面，建议立即修改密码。③配置模型：在Settings中添加本地或云端模型服务，Cookbook可自动推荐适合硬件的模型。④开始使用：通过左侧导航切换聊天、研究、文档等功能模块，Mobile端也支持完整功能。
【优缺点分析】优点：①功能极其全面，聊天、Agent、研究、文档、邮件、日历一站式覆盖，替代多个独立工具。②完全自托管，数据隐私有保障，支持多种本地和云端模型灵活切换。③社区活跃（7万+Star），持续迭代更新，Docker部署简单。缺点：①功能模块众多，初次配置和学习成本较高。②本地模型推理依赖GPU硬件，CPU模式速度较慢。③部分功能（如邮件、日历）需要额外配置CalDAV/IMAP服务，增加运维复杂度。
【适合人群】①AI技术爱好者：希望拥有自己的AI工作站、探索各种AI能力的技术探索者。②隐私敏感用户：不希望数据上传云端、需要完全掌控数据的个人或团队。③全栈效率追求者：希望用一个平台替代ChatGPT、Notion、邮件客户端等多个工具的效率达人。