Odysseus

在云服务主导的 AI 时代，Odysseus 提供了一条回归本质的路径：一个完全自托管、本地优先的 Odysseus。它不仅仅是一个聊天界面，更是一个集成了智能体自动化、深度研究、个人信息管理（PIM）及模型实验室的综合平台。旨在复刻 ChatGPT 和 Claude 的流畅体验，同时赋予用户对自己数据和硬件的绝对控制权——没有特洛伊木马，只有粗糙而真实的乐趣。

核心亮点：全能、自主、极客

1. 沉浸式对话与智能体 (Agents)

• 多后端兼容：无缝接入 Ollama, vLLM, llama.cpp, OpenRouter, OpenAI, GitHub Copilot 等，配置极简。
• 自主智能体：基于 opencode 和 MCP (Model Context Protocol)，赋予 Agent 文件操作、Shell 执行、网络搜索及技能调用能力，可自动运行复杂任务。
• 持久化记忆与技能：利用 ChromaDB 和 fastembed，实现向量+关键词检索。Agent 能随时间进化，记住你的偏好并掌握新技能，支持导入/导出。

2. 深度研究与可视化报告

• 多步推理：改编自 Tongyi DeepResearch，Agent 能自动收集、阅读并综合多方来源。
• 精美输出：生成结构清晰、视觉美观的研究报告，支持多种格式导出。

3. Cookbook：模型管理的瑞士军刀

• VRAM 感知推荐：扫描本地硬件，根据显存大小推荐最适合的模型。
• 一键部署：基于 llmfit，支持 GGUF/FP8/AWQ 等多种量化格式，自动适配 vLLM 或 llama.cpp 服务，点击即可下载并启动模型。
• 盲测对比 (Blind Test)：提供无偏见的多模型并排比较工具，帮助你在真实场景中选出最佳模型。

4. 个人信息中心 (PIM) 集成

• 智能邮箱：内置 IMAP/SMTP 客户端，支持 AI 自动分类（紧急/垃圾）、标签、摘要及回复草稿生成。
• 本地日历：支持与 Radicale/Nextcloud/Apple/Fastmail 的 CalDAV 同步，AI 可感知日程安排。
• 笔记与任务：多标签编辑器（支持 Markdown/HTML/CSV），结合 Cron 风格任务调度与提醒（ntfy/浏览器/邮件），Agent 可执行计划任务。

5. 全平台响应式体验

• 移动端优化：不仅在桌面端表现优异，在手机端也拥有出色的触摸手势支持和响应式布局，可安装为 PWA。
• 扩展丰富：支持图像编辑、主题定制、文件上传、双因素认证 (2FA) 等。

快速开始：开箱即用

Odysseus 默认设置即可运行，首次启动会在终端/Docker 日志中生成管理员临时密码。

1. Docker 部署 (推荐)

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env       # 可选，用于自定义端口/绑定地址
docker compose up -d --build

访问 http://localhost:7000 登录。

2. Apple Silicon (Mac M1/M2/M3)

Docker 无法利用 Metal GPU，建议原生运行以启用 Cookbook 的 GPU 加速。

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
./start-macos.sh

访问 http://127.0.0.1:7860。若需局域网访问，设置 ODYSSEUS_HOST=0.0.0.0。

3. Windows 一键启动

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1

脚本会自动创建虚拟环境、安装依赖并启动服务。访问 http://localhost:7000。

4. 原生 Linux / macOS

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py
python -m uvicorn app:app --host 127.0.0.1 --port 7000

Odysseus 是为那些渴望数据主权、隐私安全且不愿被单一云服务商锁定的用户打造的终极 AI 工作台。它将强大的本地模型管理能力、智能化的个人助理功能以及极客喜爱的实验工具完美融合。