开源 · MIT 许可 · v1.0

你的 AI,
你的主场。

自托管的 AI 工作台 — 拥有 ChatGPT 级别的体验,但运行在你自己的硬件上。 本地优先、隐私优先、没有后门。聊天、智能体、深度研究、文档编辑、邮件、日历……一站式掌控。

12+核心功能
5+模型后端
100%自托管
0数据上传
向下滚动
vLLM llama.cpp Ollama OpenRouter OpenAI ChromaDB SearXNG FastAPI CalDAV MCP GGUF FP8 AWQ PWA Docker SQLite
功能特性

不只是聊天,
是完整的 AI 工作台

从对话到自动化,从文档到日程,从记忆到邮件 — 一个平台覆盖所有工作流。

智能聊天

与任意本地模型或 API 对话,支持多轮对话、上下文记忆和流式输出。

vLLM llama.cpp Ollama OpenRouter

AI 智能体

赋予工具,让它自主完成复杂任务。支持网页浏览、文件操作、终端命令。

MCP 终端 文件 技能

模型食谱

自动扫描硬件,智能推荐模型,一键下载并部署。VRAM 感知,精准适配。

GGUF FP8 AWQ

深度研究

多步骤自动收集、阅读并综合来源信息,生成结构化的精美可视化报告。

多步骤 可视化

模型对比

并排比较不同模型的输出质量。完全盲测,零偏见,综合分析评分。

盲测 综合评分

文档编辑器

多标签编辑器,AI 在旁协助而非替代。支持 Markdown、HTML、CSV 及语法高亮。

Markdown AI 辅助

记忆与技能

持久化记忆和技能系统,智能体随时间进化,越来越了解你和你的工作。

ChromaDB 向量检索

AI 邮件

内置 IMAP/SMTP 收件箱,AI 自动分类、标签、摘要、紧急提醒和回复草稿。

IMAP SMTP 自动分类

笔记与任务

快速笔记附带提醒,待办清单管理,以及 Cron 风格的定时任务和通知。

提醒 Cron 任务

日历

本地优先日历,支持 CalDAV 同步至 Radicale、Nextcloud、Apple 和 Fastmail。

CalDAV .ics 导入

移动端支持

完美适配手机屏幕,支持 PWA 安装和触摸手势,随时随地使用。

响应式 PWA

更多功能

图片编辑器、主题编辑器、文件上传(视觉+PDF)、网页搜索、预设、会话管理、2FA。

图片编辑 2FA 网页搜索
快速开始

三分钟,跑起来

克隆仓库,选择你的平台,一键启动。首次运行会自动创建管理员账户并在终端打印密码。

Terminal
$ git clone https://github.com/pewdiepie-archdaemon/odysseus.git
$ cd odysseus
$ cp .env.example .env       # 可选,但建议显式设置默认值
$ docker compose up -d --build

容器运行后打开 http://localhost:7000

Terminal — Python 3.11+
$ 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
Terminal — Apple Silicon (Metal GPU)
$ git clone https://github.com/pewdiepie-archdaemon/odysseus.git
$ cd odysseus
$ ./start-macos.sh

启动后访问 http://127.0.0.1:7860(AirPlay 通常占用 7000 端口)

PowerShell — 一键启动
> git clone https://github.com/pewdiepie-archdaemon/odysseus.git
> cd odysseus
> powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1

打开 http://localhost:7000,使用生成的管理员密码登录

架构

清晰分层,
易于扩展

FastAPI 后端 + 模块化前端,所有用户数据存储在 data/ 目录,已被 gitignore 保护。

app.py FastAPI 入口点
core/ 认证、数据库、中间件、常量
src/ llm_core、agent_loop、agent_tools、chat_processor、search
routes/ 聊天、会话、文档、记忆、模型 … 端点
services/ 文档、记忆、搜索、hwfit (Cookbook) …
static/ index.html + app.js + style.css + js/(模块化前端)

内部端口一览

端口 服务
7000Odysseus 应用
8080SearXNG
8091ntfy
8100ChromaDB
11434Ollama
8000–8020模型 / 提供商 API
安全

你的数据,你做主

Odysseus 是强大的本地工具,请像对待管理控制台一样对待它。

认证优先

任何网络可访问的部署都保持 AUTH_ENABLED=true,本地开发外保持 LOCALHOST_BYPASS=false

HTTPS 部署

通过可信反向代理提供 HTTPS 服务时启用 SECURE_COOKIES=true,不要直接暴露到公网。

数据隔离

.envdata/logs/、数据库和 API 密钥排除在 Git 和共享之外。

权限控制

非管理员用户默认无法使用终端、文件读写,MCP 管理和 API 令牌等路由仅限管理员。

准备好出发了吗?

开源、免费、MIT 许可。克隆仓库,三分钟跑起来。
你的 AI 工作台,你做主。

                                  |
                                 |||
                                |||||
                  |    |    |   |||||||
                 )_)  )_)  )_)   ~|~
                )___))___))___)\  |
               )____)____)_____)\\|
             _____|____|____|_____\\\__
             \                       /
       ~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~
               ~^~  all aboard!  ~^~
       ~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~~^~^~