投研知识库

2天狂揽3w stars，火爆全网的私人 AI 工作空间

Properties1
tagswechat, inbox_daily, githubstore

6分钟阅读

2天狂揽3w stars，火爆全网的私人 AI 工作空间

项目简介

Odysseus

是一个

自托管的 AI 工作空间

—— 旨在提供类似 ChatGPT 和 Claude 的界面体验，但更具个性、更多趣味。在你自己的硬件上运行，使用你自己的数据 ——

本地优先、隐私优先、无后门

。简单理解，就是想在自己电脑或服务器上，跑一个类似 ChatGPT/Claude 的工具，但数据全在本地，不依赖云端，也不把隐私交给大公司。

特性

   聊天

  —— 与任意本地模型或 API 对话，添加模型非常简单。

   vLLM · llama.cpp · Ollama · OpenRouter · OpenAI

   Agent（智能体）

  —— 赋予工具，让它自主完成整个任务。

   基于 opencode · MCP · 网页 · 文件 · Shell · 技能 · 记忆

   Cookbook（食谱）

  —— 扫描你的硬件，推荐模型，一键下载并启动服务。

   基于 llmfit · VRAM 感知 · GGUF / FP8 / AWQ · 适配度评分 · vLLM / llama.cpp 服务

   深度研究

  —— 多步执行，收集、阅读并综合来源，生成精美的可视化报告。

   改编自 Tongyi DeepResearch

   模型对比

  —— 有趣的并排对比工具，支持完全盲测，无偏见！

   多模型 · 盲测 · 综合分析

   文档编辑

  ——

   你

  来写作，AI 辅助而非主导。

   多标签编辑器 · Markdown · HTML · CSV · 语法高亮 · AI 编辑 · 建议

   记忆 / 技能

  —— 持久化记忆和技能，你的智能体会随着时间更好地理解你和你的任务而不断进化！

   ChromaDB · fastembed (ONNX) · 向量 + 关键词检索 · 导入/导出

   邮件

  —— 内置 IMAP/SMTP 收件箱 + AI 智能分类：紧急提醒、自动标签、自动摘要、自动回复草稿、自动垃圾邮件过滤。

   IMAP · SMTP · 按账号路由 · CalDAV 感知

   笔记 & 任务

  —— 带提醒的快速笔记、待办清单，以及智能体可以执行的定时任务。

   笔记推送 · 检查清单 · cron 风格任务 · ntfy / 浏览器 / 邮件通知

   日历

  —— 本地优先的日历，支持 CalDAV 同步至 Radicale / Nextcloud / Apple / Fastmail。

   CalDAV 拉取 · .ics 导入/导出 · 按日历颜色 · 智能体感知

   移动端支持

  —— 在手机上也能良好显示和运行。

   响应式 · 可安装 (PWA) · 触屏手势

   更多功能

  —— 值得探索！

   图片编辑器 · 主题编辑器 · 文件上传（视觉 + PDF） · 网页搜索 · 预设 · 会话 · 2FA

演示


快速开始

默认配置开箱即用：克隆仓库 → 运行 → 在

设置

中配置模型、搜索、邮件等。

仅在需要部署级覆盖（如

APP_BIND

、

APP_PORT

、

AUTH_ENABLED

等）时才修改

.env

文件。

首次启动时，Odysseus 会创建一个管理员账号（默认为

admin

，可通过

ODYSSEUS_ADMIN_USER

修改），并在终端打印临时密码。

Docker 安装时可在

docker compose logs odysseus

中查看该密码。首次登录后请立即在

设置

中修改密码。

想贡献代码？请参考 CONTRIBUTING.md。

Docker（推荐）

git clone https://github.com/pewdiepie-archdaemon/odysseus.git cd odysseus cp .env.example .env       # 推荐，明确默认配置 docker compose up -d —build

容器健康后访问

http://localhost:7000

。

Docker Compose 默认绑定

127.0.0.1

，如端口被占用，可在

.env

中设置

APP_PORT=7001

后重建容器。仅在需要 LAN 或反向代理访问时才将

APP_BIND=0.0.0.0

。

原生 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

要求：Python 3.11+。Cookbook 需要

tmux

来后台下载和运行模型。仅在需要 LAN/反向代理时使用

--host 0.0.0.0

。

Apple Silicon（M 系列）

Docker 在 macOS 上无法使用 Metal GPU。若需在 M 系列 Mac 上使用 GPU 加速的 Cookbook，请原生运行：

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

默认运行在

http://127.0.0.1:7860

。

想通过 Tailscale 等可信 LAN 访问手机，可使用：

ODYSSEUS_HOST=0.0.0.0 ./start-macos.sh

构建可点击的 macOS App：

./build-macos-app.sh

原生 Windows

一键启动器

（推荐，安全可重复运行）：

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

或手动安装：

git clone https://github.com/pewdiepie-archdaemon/odysseus.git cd odysseus py -3.11 -m venv venv venv\Scripts\Activate.ps1 pip install -r requirements.txt python setup.py python -m uvicorn app:app —host 127.0.0.1 —port 7000

项目地址

https://github.com/pewdiepie-archdaemon/odysseus

如果你觉得这篇文章不错，别忘了

 点赞、在

 看、转发

给更多需要的小伙伴哦！

技术 / 产品交流

扫码加入交流群，备注格式：

「开发语言-城市-昵称」

其他合作

请注明来意

Graph View

反向链接