小黃老師嘿技術

1. Odysseus 是什麼？先用一句話看懂

Odysseus 是一套開源、自架型的 AI 工作區，目標是讓你在自己的電腦、伺服器或私有網路裡，建立一個類似 ChatGPT、Claude 的 AI 使用介面，但它不只停留在聊天，而是進一步整合 Agent、工具、模型服務、文件、Email、行事曆、研究與記憶等功能。

白話來說，如果一般 AI 聊天工具像是一個很會回答問題的助理，那 Odysseus 更像是一間你自己搭起來的 AI 工作室。你可以決定它要接本機模型，還是接外部 API；你可以讓它只在自己的機器裡運作，也可以在可信任的私有網路內使用。這種設計對重視隱私、喜歡自架工具、想玩 Local LLM 的使用者特別有吸引力。

它的官方介紹主打 local-first、privacy-first、no telemetry，也就是偏向本機優先、隱私優先、不主動蒐集使用資料。這對於不想把工作文件、私人筆記、客戶資料或研究內容全部丟到雲端的人來說，確實很有吸引力。不過也要先說清楚，Odysseus 不是下載 App 後按一下就完全無腦使用的產品，它比較適合願意碰一點 Docker、Python、API Key、本機模型設定的人。

2. 它可以做什麼？核心功能完整拆解

Odysseus 最基本的功能當然是聊天。你可以把它當成自架版 AI 聊天介面，接本機模型或 API 模型來使用。它支援的思路不是綁死單一模型，而是讓你自己選擇模型來源，例如本機的 Ollama、llama.cpp、vLLM，或外部的 OpenAI、OpenRouter 等服務。這對想比較不同模型回答品質的人很方便。

第二個重點是 Agent。Agent 的意思不是單純回你一段文字，而是讓 AI 可以規劃任務、呼叫工具、讀資料、整理檔案，甚至在你授權的情況下執行比較接近真實工作的流程。舉例來說，你可以請它研究一個主題、整理成報告、比較多個資料來源，或協助處理文件內容。這也是 Odysseus 和單純聊天頁面最大的差異之一。

第三個重點是 Tools 與 MCP。Odysseus 可以連接內建工具，例如 bash、files、web、memory，也可以整合 MCP server。你可以把 MCP 想成一種讓 AI 接上外部工具的標準接口，讓 AI 不只是坐在那裡回答，而是可以和更多服務互動。這種能力對工程師、自動化使用者、研究者很有價值，但也代表安全設定要更謹慎。

另外，Cookbook 也是它很有特色的功能。它會依照你的硬體狀況推薦適合的模型，讓你不用每次都自己猜哪個模型跑得動。對 Local LLM 新手來說，這種硬體感知的模型推薦很實用，尤其是你不確定自己電腦的 RAM、VRAM 或 Apple Silicon 能力時。

3. Odysseus 的優勢：為什麼值得研究

Odysseus 最大的優勢，是它把「AI 使用權」拉回使用者手上。你不用完全依賴單一雲端平台，也不用把所有資料都交給外部服務處理。你可以選擇本機模型，也可以選擇外部 API；你可以先用簡單聊天功能，也可以進一步開啟 Agent、文件、Email、行事曆與研究工具。

第二個優勢是整合度高。很多自架 AI 工具只負責聊天或文件問答，但 Odysseus 的野心更大，它想把 AI 工作流中常見的東西包在一起：聊天、Agent、模型比較、深度研究、文件編輯、記憶、技能、Email、行事曆、圖片工具、任務排程。這種設計如果成熟起來，會很像個人的 AI 作業系統。

第三個優勢是開源。開源代表你可以看程式碼、自己修改、自己部署，也比較容易理解資料到底流向哪裡。當然，開源不等於自動安全，但至少它給了使用者與社群檢查、修正、擴充的可能。

不過，我不會把它形容成適合所有人的神級工具。它目前比較像是快速成長中的開源 AI 工作區，功能很多、想像空間很大，但也可能遇到安裝、相容性、設定與穩定度問題。如果你只是想要最省事的 AI 助理，雲端版 ChatGPT 或 Claude 會比較輕鬆；如果你想掌握更多控制權，Odysseus 就很值得研究。

4. 適合哪些人？實際應用情境整理

第一種適合的人，是想玩本機 AI 的使用者。你可能已經在用 Ollama，或者正在研究 Llama、Qwen、Mistral、Gemma 這類模型，但覺得每次開終端機很麻煩。Odysseus 可以幫你把模型使用、比較與聊天集中到一個更完整的介面。

第二種適合的人，是內容創作者與部落格經營者。你可以用 Deep Research 先整理資料，再用 Documents 寫成草稿，最後再做 SEO 調整、表格整理與 FAQ 補充。對需要常常寫教學文、產品比較、技術介紹的人來說，這種工作流會很順。

第三種適合的人，是工程師或自動化玩家。Agent、MCP、shell、files 這些能力一旦串起來，就可以處理很多半自動化任務，例如整理專案文件、檢查資料夾、生成報告、比對設定、分析 log。只是這類功能權限很高，絕對不能亂開給不信任的人使用。

第四種是小團隊或重視隱私的工作者。如果你們有內部文件、會議紀錄、產品規劃、客戶服務資料，不想全部丟到外部雲端，就可以考慮在私有網路裡測試 Odysseus。不過正式使用前，還是要先規劃好帳號權限、備份、更新、安全邊界與 API Key 管理。

5. 安裝前準備：你需要哪些東西

安裝 Odysseus 前，建議先確認你的使用目的。如果你只是想試玩介面與基本功能，Docker 會是最簡單的方式。如果你是 Mac M 系列，且想讓本機模型吃到 Apple Silicon 的 Metal 效能，就比較適合用原生 macOS 腳本。如果你使用 Windows，可以先跑官方 PowerShell 啟動腳本。

最基本需要準備三樣東西：第一是 Git，用來下載專案；第二是 Docker 或 Python 環境；第三是瀏覽器，啟動後用網址開啟 Odysseus 介面。如果你要接本機模型，還可以先安裝 Ollama。

第一次測試時，我建議不要急著接私人 Email、正式 API Key、公司文件或重要資料夾。先用測試資料跑通基本流程，確認介面、帳號、模型與工具都正常後，再慢慢加入更進階的功能。這種工具很有潛力，但越有能力的工具，越需要穩穩地設定。

6. Docker 安裝教學：最推薦的新手方式

如果你不知道該選哪種安裝方式，先選 Docker。官方 README 也把 Docker 列為推薦方式，因為它能把相關服務包在容器裡，對新手來說比較容易啟動、停止與重建。

先打開終端機，輸入以下指令：

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --build

容器啟動完成後，打開瀏覽器輸入：

http://localhost:7000

第一次啟動時，Odysseus 會建立 admin 管理員帳號，並在終端機印出臨時密碼。Docker 使用者可以用這個指令查看 logs：

docker compose logs odysseus

登入後第一件事，就是到 Settings 修改密碼。這個步驟不要省，因為 Odysseus 不是普通聊天頁，它可能會接觸到模型服務、檔案、工具與信箱等高權限功能。

如果 7000 port 被占用，可以打開 .env，把 APP_PORT 改成 7001 或其他數字，再重新建立容器：

docker compose down
docker compose up -d --build

平常檢查容器狀態可以用：

docker compose ps
docker compose logs --tail=120 odysseus

7. Mac、Windows 與 Ollama 串接方式

Mac M 系列建議：原生啟動

如果你使用 Mac mini M4、MacBook Air M 系列或 MacBook Pro M 系列，想要讓本機模型更好地運用 Apple Silicon，官方建議可以用原生方式啟動，因為 Docker on macOS 不能直接使用 Metal GPU。

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

啟動後通常開在：

http://127.0.0.1:7860

如果你想在同一個可信任區網或 Tailscale VPN 裡用手機開啟，可以用：

ODYSSEUS_HOST=0.0.0.0 ./start-macos.sh

但這裡一定要特別提醒：不要把它直接暴露到公開網路。如果你不知道 0.0.0.0 的意思，就先不要用這個設定。

Windows 使用者：PowerShell 啟動

Windows 使用者可以使用官方提供的 PowerShell 腳本，它會建立虛擬環境、安裝套件、執行 setup 並啟動服務。

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

如果你比較熟 Python，也可以手動建立 venv 安裝。不過一般人第一次測試，建議先照官方腳本跑，能減少不少環境設定問題。

如何串接 Ollama？

如果你本機已經裝好 Ollama，可以在 Odysseus 的 Settings 裡新增 OpenAI-compatible endpoint。Docker 情境下，如果 Ollama 跑在主機端，常見 endpoint 是：

http://host.docker.internal:11434/v1

如果是原生 macOS 或 Windows，常見 endpoint 會是：

http://localhost:11434/v1

接上後，你就能在 Odysseus 裡選擇本機模型聊天、比較或跑部分工作流。若模型速度很慢，通常不是 Odysseus 本身的問題，而是模型太大、硬體 RAM 不足，或模型服務沒有正確使用 GPU 加速。

8. 安全設定與常見問題

Odysseus 的安全重點很簡單：它不是拿來直接公開給陌生人使用的網站。因為它具備本機工具、shell、檔案讀寫、Email、Calendar、模型服務、MCP 等能力，一旦權限設定錯誤，就可能造成資料外洩或系統被濫用。官方安全文件也提醒不要把它當成公開、免登入服務來跑。

Q1：Odysseus 可以取代 ChatGPT 嗎？

看你的需求。如果你要的是最穩定、最省事、手機 App 開箱即用，ChatGPT 或 Claude 還是比較輕鬆。如果你想自架、接本機模型、掌握資料、玩 Agent 與工具整合，Odysseus 的彈性會更高。

Q2：一定要很強的電腦才能跑嗎？

Odysseus 這個平台本身不一定需要高階電腦，真正吃效能的是本機模型。如果你接外部 API，普通電腦也能測；如果要跑大型 Local LLM，就需要更多 RAM、VRAM 或較新的 Apple Silicon。

Q3：新手第一步該玩什麼？

建議順序是 Chat、Compare、Documents、Deep Research。先不要急著碰 Email、Calendar、shell、MCP。等你熟悉介面與權限邏輯後，再慢慢開啟高風險整合。

Q4：我應該用 Docker 還是原生安裝？

大多數人先用 Docker。Mac M 系列如果想跑本機模型並利用 Metal，則可考慮原生 macOS 腳本。Windows 使用者可以先用官方 PowerShell 腳本，之後再視需要調整。

Q5：它目前穩定嗎？

它是一個很有潛力、功能很多的開源專案，但仍在快速發展。官方 Roadmap 也把安裝測試、整合稽核與 bug 修正列為高優先項目。簡單說，可以研究、可以測試，但正式導入前要留意穩定性與安全邊界。

資料來源與延伸閱讀

• Odysseus 官方介紹頁
• Odysseus GitHub Repository
• Odysseus Security Policy
• Odysseus Threat Model
• Odysseus Roadmap