Odysseus

Odysseus – 开源的本地自托管 AI 工作空间

Odysseus：您的专属本地化 AI 工作台，隐私至上，功能强大

您是否还在为使用 ChatGPT 或 Claude 等强大 AI 工具时，对数据隐私的担忧而烦恼？是否渴望一个能够完全掌控自己数据，并且功能集成的 AI 解决方案？现在，Odysseus 来了，它是一款开源、可自托管的 AI 工作空间，旨在为您提供一个安全、高效且功能丰富的本地化 AI 体验。

Odysseus 究竟是什么？

Odysseus 是一款性的开源自托管 AI 工作空间，它提供了一个与 ChatGPT / Claude 类似的用户友好型界面。其核心优势在于所有工具均在本地运行，确保您的数据不出本机，实现隐私零泄露。Odysseus 集成了、Agent 智能体、深度研究、笔记、任务管理、日历、邮件处理、模型对比等十余项强大功能。它兼容 vLLM、Ollama、OpenRouter 等多种模型后端，是构建您个人或团队私有化 AI 中枢的理想选择。

Odysseus 的核心亮点功能

• 智能 AI 对话：Seamlessly engage with both local models (like vLLM,llama.cpp,Ollama) and cloud-based APIs (OpenAI,OpenRouter). Adding new models is incredibly straightforward.
• Agent 智能体：Empower your AI with autonomous task execution capabilities. Odysseus supports agents with access to MCP,web browsing,file system operations,shell commands,custom skills,and memory.
• Cookbook 模型库：Effortlessly scan your hardware and receive tailored model recommendations. Download and launch compatible models (supporting GGUF,FP8,AWQ formats) with a single click.
• 深度研究助手：Engage in multi-step research processes where the AI automatically gathers,reads,and synthesizes information from various sources,culminating in beautifully visualized reports.
• 模型盲测对比：Conduct objective model comparisons with side-by-side output displays and anonymous voting to eliminate bias.
• 智能文档编辑器：A versatile multi-tab editor for Markdown,HTML,and CSV files,where AI acts as a writing assistant rather than a dominant force.
• 持久化记忆与技能：Leverage ChromaDB and fastembed for persistent vector memory,allowing your agents to evolve and learn over time.
• 内置邮件客户端：Manage your IMAP/SMTP inboxes with AI-powered features like intelligent categorization,automatic summarization,draft replies,and spam filtering.
• 高效笔记与任务管理：Quickly capture notes,create to-do lists,and schedule timed tasks with flexible reminders via ntfy,browser notifications,or email.
• 本地优先日历：Utilize a local-first CalDAV calendar that seamlessly syncs with popular services like Radicale,Nextcloud,Apple,and Fastmail.
• 移动端无缝体验：A responsive PWA design with intuitive touch gestures ensures a smooth experience on your mobile devices.
• 更多实用工具：Includes an image editor,theme customizer,web search integration,file upload (visual + PDF),and 2FA for enhanced security.

Odysseus 的技术基石

• 前端架构：Built on a modern web technology stack,the responsive PWA interface offers a theme editor and a multi-tab document editor (Markdown/HTML/CSV). Browser installation provides a cross-device native experience,secured with 2FA authentication.
• 模型推理层：A unified abstraction layer connects to diverse backends. Locally,it supports inference engines like vLLM,llama.cpp,and Ollama. Cloud-side,it’s compatible with APIs from OpenAI and OpenRouter,enabling seamless multi-model orchestration and switching.
• Agent 执行框架：The tool invocation system is constructed upon opencode and the MCP (Model Context Protocol) standard,granting LLMs access to shell commands,web browsing,and file system operations. It supports autonomous task planning,multi-step execution,and toolchain orchestration.
• 记忆检索系统：ChromaDB serves as the local vector database,with fastembed (ONNX runtime) handling embedding generation locally. It supports both vector similarity and keyword search modes,facilitating the import and export of persistent memory and skills.
• Cookbook 模型适配：The llmfit tool scans hardware VRAM capacity to automatically assess the compatibility score of quantized formats (GGUF/FP8/AWQ) with your hardware. It then launches vLLM or llama.cpp backend services with a single click,utilizing tmux for managing download and inference processes.
• 深度研究引擎：Drawing inspiration from the Tongyi DeepResearch architecture,this engine implements multi-step information gathering,source credibility assessment,reading comprehension,and synthesis,ultimately producing structured research reports with visual representations.

如何轻松上手 Odysseus

• Docker 部署：
  • Clone the repository to your local machine: git clone https://github.com/pewdiepie-archdaemon/odysseus.git
  • Navigate into the project directory: cd odysseus
  • Copy the environment configuration file: cp .env.example .env
  • Build and start the containers: docker compose up -d --build
  • Access the system via your browser at http://localhost:7000.
  • Retrieve the temporary administrator password from the terminal or Docker logs for your initial login.
• Apple Silicon (M Series) Native Deployment：
  • Clone the repository to your local machine: git clone https://github.com/pewdiepie-archdaemon/odysseus.git
  • Navigate into the project directory: cd odysseus
  • Execute the startup script: ./start-macos.sh
  • Access Odysseus through your browser at http://127.0.0.1:7860,leveraging Metal GPU acceleration.
• Windows One-Click Deployment：
  • Clone the repository to your local machine: git clone https://github.com/pewdiepie-archdaemon/odysseus.git
  • Navigate into the project directory: cd odysseus
  • Run the PowerShell startup script: powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1
  • Follow the script’s prompts for automatic installation,then access Odysseus via your local browser.

Odysseus 的核心优势

• 本地优先，隐私至上：所有数据存储在本地，无需上传云端，彻底规避隐私泄露和风险。
• 即插即用：默认配置即可运行，无需复杂的环境搭建。支持 Docker、原生 Linux、macOS App、Windows 脚本及 PWA 多平台一键部署。
• 全能型工作空间：将、研究、笔记、任务、日历和邮件整合至统一界面，显著减少工具切换的繁琐。
• 开放的模型生态：不局限于单一模型，兼容本地推理与云端 API。Cookbook 功能自动匹配您的硬件与模型。
• 可进化的 Agent：通过持久化记忆和技能系统，Agent 能够随着使用时间的增长而更深入地理解用户需求，并支持 MCP 标准进行工具扩展。

Odysseus 的项目链接

• 项目官网：https://pewdiepie-archdaemon.github.io/odysseus/
• GitHub 仓库：https://github.com/pewdiepie-archdaemon/odysseus

Odysseus 与同类竞品比较

Odysseus 的应用场景

• 个人隐私 AI 助手：在本地设备上安全地使用大模型，敏感数据绝不离开本机。
• 开发者本地 LLM 实验室：快速切换、对比和评测不同的开源模型，进行盲测和性能分析。
• 研究者深度调研：利用 Agent 自动收集文献、生成结构化研究报告并进行可视化呈现。
• 团队私有化知识库：结合向量记忆和文档编辑功能，构建内部问答和写作协作平台。
• 个人效率管理：集成笔记、待办事项、日历和邮件功能，打造一个由 AI 驱动的个人生产力中枢。