Odysseus: 9일 만에 깃허브 스타 63,000개 달성한 셀프호스팅 AI 워크스페이스 — 2026 설치 가이드

Odysseus는 2026년 5월 31일 깃허브에 공개된 후 6월 8일까지 63,000개의 스타를 달성했습니다. 하루 평균 약 7,000개의 스타가 증가한 셈으로, 2026년 가장 빠르게 성장한 오픈소스 AI 프로젝트 중 하나입니다. 핵심 아이디어는 명확합니다: 월 $20의 ChatGPT Plus 구독으로 얻을 수 있는 모든 것을 내 서버에서, 내 데이터로, MIT 라이선스로 실행하는 것입니다.

Odysseus란 무엇인가 #

기술적으로 Odysseus는 FastAPI + Uvicorn 백엔드와 바닐라 JS 프론트엔드로 구성된 Python 웹 애플리케이션입니다. 검증된 여러 오픈소스 컴포넌트를 하나의 통합 워크스페이스로 묶었습니다:

• 채팅(Chat) — 로컬 또는 원격 LLM과 대화. 설정에서 URL과 키를 입력하면 즉시 연결됩니다. 지원 백엔드: vLLM, llama.cpp, Ollama, OpenRouter, OpenAI, GitHub Copilot.
• 에이전트(Agent) — 목표와 도구(웹, 파일, 쉘, MCP 서버, 메모리)를 지정하면 AI가 작업을 자율적으로 수행합니다. opencode 기반으로 구축되었습니다.
• 쿡북(Cookbook) — 하드웨어를 스캔하고 사용 가능한 VRAM을 감지해 GGUF / FP8 / AWQ 모델을 추천하고, 클릭 한 번으로 다운로드 및 실행합니다. llmfit 기반.
• 딥 리서치(Deep Research) — 웹 검색, 소스 읽기, 종합 분석을 수행하는 멀티스텝 에이전트 리서치. 알리바바의 Tongyi DeepResearch에서 포크된 기능.
• 모델 비교(Compare) — 블라인드 사이드-바이-사이드 비교. 동일한 프롬프트를 여러 모델에 보내고, 어느 모델의 답변인지 모르는 상태에서 평가합니다.
• 문서(Documents) — 멀티탭 마크다운 / HTML / CSV 에디터. ‘내가 쓰고, AI가 보조’하는 방식으로 설계되었습니다.
• 메모리 / 스킬(Memory / Skills) — ChromaDB 벡터 스토어 + fastembed(ONNX)로 에이전트에게 영구 메모리를 제공합니다. 임포트/익스포트 지원.
• 이메일(Email) — IMAP/SMTP 받은 편지함. AI가 긴급도 감지, 자동 태그, 요약, 답장 초안을 생성합니다.
• 메모 & 할일(Notes & Tasks) — 알림 메모, 체크리스트, 에이전트가 실행 가능한 크론 스타일 스케줄 작업.
• 캘린더(Calendar) — 로컬 우선 캘린더. Radicale, Nextcloud, Apple Calendar, Fastmail과 CalDAV 동기화 지원.
• 모바일 PWA — 반응형 디자인, iOS/Android 홈 화면 설치 가능.

빠른 시작 (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 로그에 임시 관리자 비밀번호가 출력됩니다:

docker compose logs odysseus | grep "Admin password"

로그인 후 설정에서 비밀번호를 변경하고, 첫 번째 모델 서버(로컬 Ollama 또는 OpenAI API 키)를 추가하세요.

네이티브 설치 (Linux / macOS) #

Apple Silicon에서 GPU 가속 로컬 모델을 사용하려면 Docker 대신 네이티브 설치를 권장합니다(Docker는 Metal GPU에 접근할 수 없음):

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

Apple Silicon 원클릭 시작:

./start-macos.sh        # 127.0.0.1:7860에 바인딩

요구 사항: Python 3.11+. Cookbook의 백그라운드 모델 다운로드에는 tmux가 필요합니다.

주요 경쟁 제품과 비교 #

주의 사항 #

Odysseus는 현재 버전 1.0으로, 출시된 지 2주도 채 되지 않았습니다. Linux에서 Cookbook의 일부 런타임은 백그라운드 작업에 수동 tmux가 필요하고, CalDAV 동기화에서 반복 이벤트 처리 관련 알려진 이슈가 있으며, 모바일 PWA 성능은 브라우저마다 다소 차이가 있습니다. 하지만 이슈 트래커가 활발하게 관리되고 있고 메인테이너의 응답 속도가 빠릅니다.

프로덕션급 에이전트 배포에는 LangGraph나 CrewAI처럼 더 검증된 프레임워크가 여전히 유리합니다. Odysseus는 강력하고 유연하며 프라이버시를 보장하는 개인 AI 워크스페이스로 포지셔닝하는 것이 적합합니다.

관련 리소스 #

전체 스택이 부담스럽다면 개별 컴포넌트부터 시작할 수 있습니다. Ollama 로컬 LLM 가이드는 몇 분 안에 로컬 추론 서버를 세우는 방법을 다룹니다. 에이전트 메모리 레이어를 더 깊이 이해하고 싶다면 Mem0와 AI 에이전트 영구 메모리에서 ChromaDB 벡터 검색이 실제로 어떻게 동작하는지 설명합니다. 더 가벼운 RAG 대안을 찾는다면 AnythingLLM 아키텍처를 먼저 살펴보세요.

결론 #

월 구독료 없이, 데이터를 클라우드에 올리지 않고, 내 하드웨어에서 ChatGPT 수준의 AI 워크스페이스를 원한다면 Odysseus가 현재 가장 완성도 높은 오픈소스 선택지입니다. 9일 만에 63,000 스타를 달성한 것은 과장된 홍보가 아닌 커뮤니티의 진심 어린 반응입니다. 레포를 클론하고 docker compose up을 실행하면 5분 안에 완전한 AI 워크스페이스가 실행됩니다.

GitHub: pewdiepie-archdaemon/odysseus