Tóm tắt nhanh:
- Odysseus là một workspace AI self-hosted toàn diện – phiên bản local-first, privacy-first thay thế cho UX của ChatGPT và Claude, “với chút jank và vui hơn” theo lời tác giả.
- Repo do tài khoản pewdiepie-archdaemon publish – dự án viral mạnh với hàng triệu view sau khi ra mắt, được nhiều người tin là liên quan đến PewDiePie.
- 9 module lớn trong một app: Chat, Agent (built trên OpenCode), Cookbook (auto-detect hardware + recommend model), Deep Research (adapted từ Tongyi DeepResearch), Compare (blind A/B test model), Documents, Memory & Skills, Email (IMAP/SMTP với AI triage), Notes & Tasks, Calendar (CalDAV).
- Hỗ trợ đa runtime LLM: vLLM, llama.cpp, Ollama, OpenRouter, OpenAI – đổi provider chỉ vài cú nhấp.
- Cài Docker một lệnh hoặc native trên Linux/macOS/Windows. Apple Silicon có script
start-macos.shriêng để dùng Metal GPU.- Mobile-ready (PWA): chạy đẹp trên điện thoại như trên desktop.
- License MIT. Memory dùng ChromaDB + fastembed (ONNX), Vector + keyword retrieval.
Odysseus xuất hiện và ngay lập tức gây bão trong cộng đồng self-host AI. Lý do không chỉ vì repo này được publish bởi PewDiePie – YouTuber huyền thoại với hơn 110 triệu subscriber – mà còn vì dự án thực sự giải quyết một bài toán quan trọng: đưa toàn bộ trải nghiệm ChatGPT về máy của bạn, dưới quyền kiểm soát hoàn toàn của bạn.
Khác với những ChatGPT alternative thông thường vốn chỉ là một chat UI bọc quanh API, Odysseus đóng gói một workspace hoàn chỉnh: chat, agent có quyền truy cập tool, deep research multi-step, email AI triage, calendar CalDAV sync, notes/tasks/reminder, document editor có AI assist. Tất cả chạy local, không gửi data ra ngoài (trừ khi bạn chủ động gọi API cloud).
Triết lý “local-first, privacy-first, and no trojan” được tác giả tuyên bố thẳng trong README – đối lập rõ rệt với các sản phẩm SaaS thường thu thập data người dùng làm training data.
Các tính năng nổi bật của Odysseus
Chat đa runtime
Module Chat hỗ trợ vLLM, llama.cpp, Ollama, OpenRouter, OpenAI – thêm provider chỉ vài cú nhấp trong Settings. Bạn có thể đặt một local Ollama làm default cho task hàng ngày, fallback OpenRouter cho task cần model lớn. UI quen thuộc với người dùng ChatGPT, không cần học gì mới.
Agent built trên OpenCode
Module Agent (built trên anomalyco/opencode) cho phép hand off cả task cho agent tự thực hiện. Agent có sẵn các tool: MCP, web, files, shell, skills, memory. Bạn có thể bảo nó “đọc thư mục project, tìm bug trong file auth.ts, viết test cover edge case, chạy test và báo kết quả” – agent xử lý từng bước đến khi xong.
Cookbook: scan hardware, recommend model
Đây là feature đặc trưng nhất của Odysseus. Cookbook (built trên AlexsJones/llmfit) scan VRAM của bạn, đánh giá GGUF / FP8 / AWQ fit scoring, đề xuất model phù hợp nhất với GPU bạn có, click một cái để download và serve qua vLLM hoặc llama.cpp. Không cần biết model nào fit RAM bao nhiêu – Cookbook tính giúp.
Deep Research
Adapted từ Tongyi DeepResearch của Alibaba NLP, module này chạy multi-step research: gather source, đọc, synthesize thành báo cáo visual đẹp. Phù hợp khi bạn cần research một topic mới hoặc dựng background cho bài blog dài.
Compare: blind A/B test model
Module Compare test model side-by-side trong điều kiện hoàn toàn blind – bạn không biết model nào trả lời câu nào, chỉ chấm điểm. Tránh bias “tôi thích Claude nên đánh giá cao Claude”. Đây là cách tốt nhất để chọn default model cho từng use case.
Memory & Skills
Persistent memory dùng ChromaDB + fastembed (ONNX) cho cả vector và keyword retrieval. Agent tích lũy kiến thức về bạn và task qua thời gian – import/export dễ dàng. Skills là các tool/workflow custom bạn dạy agent một lần để nó tự dùng sau này.
Email với AI triage
Đây là feature ít workspace AI nào có. Odysseus có IMAP/SMTP inbox built-in với AI triage: tự động mark urgency, auto-tag, auto-summary, auto-reply draft, auto-spam filter. Mỗi account có thể route riêng. CalDAV-aware để agent biết lịch của bạn khi reply email.
Notes, Tasks, Calendar
Notes nhanh với reminder. To-do list. Scheduled task dạng cron mà agent có thể tự execute. Calendar local-first với CalDAV sync sang Radicale, Nextcloud, Apple, Fastmail. Reminder kênh đa dạng: ntfy, browser push, email.
Mobile-ready (PWA)
Toàn bộ UI responsive, installable as PWA, hỗ trợ touch gesture. Chạy đẹp trên điện thoại không kém gì desktop – hiếm có self-hosted tool nào làm được mobile UX ở mức này.
Hướng dẫn cài đặt Odysseus
Yêu cầu Python 3.11+ (cho native install) hoặc Docker.
Cài Docker (khuyến nghị)
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
cp .env.example .env
docker compose up -d --buildĐợi container healthy, mở http://localhost:7000. Docker Compose tự động bind 127.0.0.1 (an toàn, không expose ra LAN/internet). Nếu cần truy cập từ thiết bị khác qua LAN, set APP_BIND=0.0.0.0 trong .env.
Compose cũng spin up ChromaDB (memory), SearXNG (web search), ntfy (notification) – đầy đủ stack.
Lần đăng nhập đầu tiên: hệ thống tự tạo admin account (admin mặc định) và in temporary password vào terminal:
docker compose logs odysseusTìm dòng password, dùng nó để login, rồi đổi trong Settings.
Cài native 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 7000Cần tmux cho Cookbook (background model download và serve).
Cài Apple Silicon (Metal GPU)
Docker trên macOS không dùng được Metal GPU. Để có GPU acceleration trên M-series Mac, chạy native:
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
./start-macos.shScript tự install Homebrew dependency, tạo venv, run setup, khởi động uvicorn trên port 7860 (vì AirPlay thường giữ port 7000). Dùng llama.cpp/Ollama cho Metal. Truy cập tại http://127.0.0.1:7860.
Build app wrapper clickable:
./build-macos-app.shCài Windows
One-command launcher:
git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus
powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1Cần Python 3.11+. Để dùng Cookbook đầy đủ, cài thêm Git for Windows (cung cấp bash.exe). Local GPU serving của vLLM/SGLang cần Linux/WSL2 – trên Windows native, dùng Ollama là đường đơn giản nhất, point Odysseus tới http://localhost:11434/v1 trong Settings.
NVIDIA Docker GPU (Linux)
Có script chẩn đoán GPU passthrough đi kèm:
scripts/check-docker-gpu.sh # diagnostic only
scripts/check-docker-gpu.sh --install-nvidia-toolkit # install NVIDIA Container Toolkit
scripts/check-docker-gpu.sh --enable-nvidia-overlay # enable GPU compose overlayVerify sau khi enable:
docker compose exec odysseus nvidia-smi -LSử dụng Odysseus: Workflow điển hình
Bước 1: Cấu hình model qua Cookbook
Vào tab Cookbook. Hệ thống scan hardware và đề xuất danh sách model phù hợp. Pick một (ví dụ Qwen 2.5 Coder 7B GGUF), click download. Model được serve qua llama.cpp tự động, hiển thị endpoint trong Settings.
Bước 2: Add provider trong Chat
Mở Settings → Providers, thêm provider local (http://localhost:8000/v1 cho vLLM hoặc http://localhost:11434/v1 cho Ollama). Đối với cloud, paste API key của OpenRouter/OpenAI.
Bước 3: Chat hoặc giao task cho Agent
Tab Chat cho hội thoại đơn giản. Tab Agent khi bạn cần agent tự execute task: “đọc file report.csv, tóm tắt thành 3 bullet, viết email gửi sếp”.
Bước 4: Setup Email và Calendar
Vào Settings → Email, thêm IMAP/SMTP account. AI triage bật mặc định – inbox sẽ tự tag urgency, summary, suggest reply. Calendar tab → connect CalDAV (Nextcloud, Radicale, Apple, Fastmail).
Bước 5: Deep Research cho task lớn
Khi cần research topic mới, mở Deep Research tab, nhập câu hỏi. Hệ thống gather source từ SearXNG, đọc, synthesize – output là báo cáo Markdown đẹp có thể export hoặc lưu vào Documents.
Bước 6: Setup mobile
Mở Odysseus trên điện thoại qua LAN (set APP_BIND=0.0.0.0 hoặc dùng Tailscale). Bấm “Install” trong browser – app cài vào màn hình chính như native app.
Một số mẹo và lưu ý quan trọng
Security: Odysseus có shell access, file upload, model download – treat như admin console. Giữ AUTH_ENABLED=true, LOCALHOST_BYPASS=false, SECURE_COOKIES=true khi serve qua HTTPS. Không expose trực tiếp ra internet – đặt sau reverse proxy (Caddy/Nginx) hoặc private gateway (Tailscale, Cloudflare Access).
Để enable browser MCP (Playwright cho page navigation, screenshot, vision), chạy một lần:
npx -y @playwright/mcp@latest --versionRestart Odysseus, server sẽ register at startup.
Đối với memory ChromaDB: data nằm trong ./data/chroma. Backup thư mục data/ thường xuyên – đây là toàn bộ user data (chat history, document, memory, settings).
Không expose ChromaDB, SearXNG, ntfy, Ollama, vLLM port ra ngoài – chỉ entrypoint Odysseus đi qua reverse proxy.
Odysseus là một trong những self-hosted AI workspace tham vọng và toàn diện nhất xuất hiện trong cuối 2026. Việc đóng gói chat, agent, research, email, calendar, notes vào một app duy nhất – tất cả chạy local – khiến nó trở thành lựa chọn lý tưởng cho power user, privacy advocate, hoặc indie hacker muốn thoát khỏi big-tech.
