Odysseus는 ChatGPT, Claude의 UI 경험을 로컬 서버에서 직접 구동할 수 있게 만든 셀프호스팅 AI 워크스페이스다. 로컬 우선(local-first), 프라이버시 우선을 핵심 원칙으로 삼아 채팅·에이전트·딥리서치·이메일·캘린더를 하나의 오픈소스 플랫폼으로 통합한다. Docker 한 줄로 설치가 가능하며 모바일에서도 PWA로 이용할 수 있다.
주요 기능
| 기능 | 설명 | 기반 기술 |
|---|---|---|
| Chat | 로컬 모델 또는 API로 채팅 | vLLM · llama.cpp · Ollama · OpenRouter · OpenAI |
| Agent | 도구를 쥐어주고 태스크를 자율 수행 | opencode · MCP · 웹 · 파일 · 셸 |
| Cookbook | 하드웨어 스캔 후 적합 모델 추천·다운로드·서빙 자동화 | llmfit · VRAM-aware · GGUF/FP8/AWQ |
| Deep Research | 다단계 정보 수집 및 합성 후 보고서 생성 | Tongyi DeepResearch 기반 |
| Compare | 모델 간 블라인드 비교 | 멀티 모델 · 편향 없는 A/B 테스트 |
| Documents | AI 보조 멀티탭 에디터 | 마크다운·HTML·CSV · AI 편집·제안 |
| Memory / Skills | 에이전트가 사용자를 학습하며 진화 | ChromaDB · fastembed(ONNX) · 벡터+키워드 검색 |
| AI가 우선순위 분류·태그·요약·답장 초안 생성 | IMAP · SMTP · CalDAV | |
| Notes & Tasks | 리마인더·할일·예약 작업 | cron 스타일 · ntfy/브라우저/이메일 알림 |
| Calendar | CalDAV 동기화 로컬 캘린더 | Radicale · Nextcloud · Apple · Fastmail |
| Mobile 지원 | PWA 설치 가능, 터치 최적화 | 반응형 디자인 |
누구에게 적합한가
- 프라이버시 중시자: 채팅 내용, 이메일, 파일이 외부 서버에 전송되지 않아야 하는 경우
- 홈랩(homelab) 운영자: NAS·미니 PC에 ChatGPT 대용 서버를 구축하려는 경우
- AI 개발자: MCP·API 토큰·웹훅을 활용해 커스텀 에이전트를 로컬에서 실험하고 싶은 경우
빠른 시작
# Docker (권장)
git clone https://github.com/pewdiepie-archdaemon/odysseus
cd odysseus
cp .env.example .env # 설정 편집
docker compose up -d
# 이후 http://localhost:8080 접속초기 설정에서 계정을 생성하고 data/auth.json에서 열린 회원가입을 비활성화할 것을 권장한다.
보안 고려사항
Odysseus는 셸 접근, 파일 업로드, 모델 다운로드, API 토큰 등 강력한 도구를 포함한다. 네트워크 외부에 노출할 경우:
AUTH_ENABLED=true유지- HTTPS와 리버스 프록시 필수
- 관리자 계정 최소화, 비관리자 계정에 셸 권한 부여 금지
- API 토큰은 통합마다 별도 생성
관련 문서
참고 자료
- pewdiepie-archdaemon/odysseus — GitHub 공식 저장소