Odysseus란?
Odysseus는 클라우드 호스팅 제품이 아니라 Docker를 통해 자신의 컴퓨터나 서버에서 실행되는 셀프 호스팅 AI 워크스페이스입니다. GitHub 저장소는 이를 "채팅, 에이전트, 리서치, 문서, 이메일, 메모, 캘린더, 로컬 모델 워크플로"를 하나의 배포에 결합한 것으로 설명합니다.
- 핵심 기능: 채팅, 자율 에이전트, 웹 리서치, 문서 편집, 이메일, 메모, 작업, 캘린더를 아우르는 셀프 호스팅 올인원 워크스페이스
- 배포 방식: Docker(
docker compose)를 통한 셀프 호스팅 — 공식 Odysseus 클라우드/SaaS 요금제는 없음 - 모델 연결: 로컬 추론 백엔드(Ollama, llama.cpp, vLLM)뿐 아니라 API 제공업체(OpenAI, OpenRouter)와도 작동하므로, 작동을 위해 로컬 모델 실행이 필수는 아님
- 라이선스: AGPL-3.0-or-later, 오픈소스 카피레프트 라이선스
- 저장소: github.com/odysseus-dev/odysseus, GitHub API에 따르면 2026년 9월 12일 기준 스타 87,156개
Odysseus는 누가 만들었나? PewDiePie의 기원
Odysseus는 PewDiePie로 알려진 콘텐츠 크리에이터 펠릭스 셸버그가 개인 프로젝트로 시작했으며, 이후 널리 스타를 받은 오픈소스 저장소로 성장했습니다. 프로젝트 공개를 다룬 Cybernews, XDA Developers를 포함한 여러 독립 매체가 셸버그를 이 프로젝트의 창시자로 보도했습니다.
- Odysseus는 저장소가 커뮤니티 운영 조직
odysseus-dev로 이전되기 전, 셸버그 본인의 GitHub 계정에서 시작됨 - 이 프로젝트는 클라우드 구독 대신 자신의 하드웨어에서 로컬로 AI 도구를 실행하려는 셸버그 자신의 관심이 확장된 것으로 널리 소개되어 왔음
- 이 리뷰는 셸버그를 독자적으로 인터뷰하거나
odysseus-dev조직에서의 현재 일상적 참여 여부를 확인하지 않았습니다 — 이 리뷰 작성 시점의 메인테이너/기여자 구조는 반드시 개인이 운영하는 프로젝트가 아니라 커뮤니티 프로젝트의 모습을 반영합니다
Odysseus로 무엇을 할 수 있나?
Odysseus의 GitHub README는 기능을 여러 영역으로 그룹화합니다. 아래는 프로젝트 자체의 기능 설명을 사용해 항목별로 정리한 것입니다.
- 채팅 + 에이전트 — 로컬 또는 API 모델과의 대화, 그리고 도구 사용, MCP(Model Context Protocol) 지원, 파일·셸 접근, 커스텀 "스킬", 메모리를 갖춘 에이전트 워크플로
- 심층 리서치 — 단일 검색 결과가 아닌, 출처를 읽고 서면 보고서를 생성하는 다단계 에이전트형 웹 리서치
- 비교 — 동일한 프롬프트에 대해 여러 모델을 블라인드로 나란히 테스트하고 결과를 종합
- Cookbook — 사용 가능한 하드웨어에 맞춰 로컬 모델을 매칭하기 위한 하드웨어 인지 모델 추천, 다운로드, 서빙 가이드
- 문서, 이메일, 메모, 작업, 캘린더 — AI 제안이 포함된 문서 편집기, 분류와 요약 기능을 갖춘 IMAP/SMTP 이메일 클라이언트, 메모·작업 관리자, CalDAV를 통한 캘린더 동기화
- 부가 기능 — 이미지 갤러리와 편집기, 설정 가능한 테마, 파일 업로드, 통합 웹 검색, 저장된 프리셋, 다중 세션, 2단계 인증
Odysseus 설치하기(Docker, 셀프 호스팅)
Odysseus는 자체 GitHub README에 게시된 명령어를 사용해 Docker로 설치합니다. 별도로 다운로드 가능한 데스크톱 앱이나 모바일 앱은 없으며, 모든 배포는 직접 실행하는 셀프 호스팅 Docker 인스턴스입니다.
1. 저장소 복제
- 명령어 / 작업:
git clone https://github.com/odysseus-dev/odysseus.git
2. 프로젝트 디렉터리로 이동
- 명령어 / 작업:
cd odysseus
3. 환경 파일 생성
- 명령어 / 작업:
cp .env.example .env실행 후.env를 편집해 모델/API 연결 추가
4. 컨테이너 빌드 및 시작
- 명령어 / 작업:
docker compose up -d --build
5. 워크스페이스 열기
- 명령어 / 작업:
- 브라우저에서
http://localhost:7000접속
GitHub README는 네이티브(비Docker) 설치, 로컬 모델 가속을 위한 GPU 패스스루 설정, Windows 및 macOS별 참고 사항도 문서화하고 있습니다 — 이처럼 활발하고 스타가 많은 프로젝트는 릴리스마다 설치 안내가 바뀔 수 있으므로 정확한 단계는 최신 README를 확인하세요. Odysseus 자체에는 고정된 최소 하드웨어 요구 사항이 없습니다. 실질적인 요구 사항은 로컬 모델에 연결하는지(해당 모델을 실행할 만큼 충분한 RAM/VRAM 필요) 아니면 API 제공업체에 연결하는지(Docker 컨테이너 자체는 아주 적은 자원만 필요)에 따라 달라집니다.
플랫폼 및 라이선스
배포 방식
- 세부 사항:
- Mac, Windows, Linux에서 Docker를 통한 셀프 호스팅 — 공식 클라우드 요금제 없음.
비용
- 세부 사항:
- 무료. 운영에 유료 Odysseus 구독은 필요하지 않으며, 비용이 발생한다면 자체 하드웨어나 연결하기로 선택한 API 제공업체 사용료에서만 발생.
라이선스
- 세부 사항:
- 저장소의 LICENSE 파일에 따라 AGPL-3.0-or-later.
모델 지원
- 세부 사항:
- 로컬 백엔드(Ollama, llama.cpp, vLLM) 또는 API 제공업체(OpenAI, OpenRouter) —
.env파일을 통해 배포마다 설정.
GitHub 활동
- 세부 사항:
- GitHub API에 따르면 스타 87,156개, 포크 860개, 마지막 코드 푸시는 2026년 9월 11일.
여기에 언급된 수치에 의존하기 전에 현재 라이선스 조건, 스타 수, 설치 요구 사항을 GitHub 저장소에서 직접 확인하세요 — 빠르게 성장하는 오픈소스 프로젝트의 수치와 설치 단계는 릴리스마다 바뀝니다.
Odysseus 대 다른 셀프 호스팅 AI 워크스페이스
Odysseus는 채팅에 추가적인 생산성 또는 에이전트 기능을 결합한 여러 셀프 호스팅 오픈소스 도구 중 하나입니다. 같은 영역의 다른 옵션들과 어떻게 비교되는지 아래에 정리했습니다 — 전체 카탈로그는 로컬 AI 소프트웨어 디렉터리를 참고하세요.
- Msty — 데스크톱 우선의 로컬 AI 채팅 앱으로, 단일 앱 설치가 더 간단하지만(Docker 불필요) Odysseus의 이메일/캘린더/문서 묶음보다 기능 범위가 좁음; Msty 리뷰 참고.
- AnythingLLM — Odysseus의 더 넓은 이메일/캘린더/리서치 범위 대신 검색 증강 생성(RAG)과 문서 채팅에 초점을 맞춘 셀프 호스팅 오픈소스 워크스페이스; AnythingLLM 리뷰 참고.
- Khoj — 개인 지식 검색과 메모에 초점을 맞춘 셀프 호스팅 오픈소스 "두 번째 뇌" 비서로, Odysseus의 올인원 워크스페이스보다 생산성 초점이 좁음; Khoj 리뷰 참고.
- LibreChat — 많은 모델 제공업체를 지원하는 셀프 호스팅 오픈소스 채팅 인터페이스로, 플러그인/에이전트 시스템을 갖췄지만 Odysseus의 내장 이메일 및 캘린더 도구는 없음; LibreChat 리뷰 참고.
Odysseus는 누구에게 적합한가?
Odysseus가 적합한지는 Docker 배포를 직접 운영하는 데 익숙한지, 그리고 여러 개의 별도 앱 대신 채팅, 에이전트, 리서치, 생산성 도구를 아우르는 하나의 워크스페이스를 원하는지에 달려 있습니다.
다음에 해당하면 Odysseus를 시도해 보세요
- Docker와 셀프 호스팅에 익숙하며, 채팅·이메일·메모·캘린더 데이터가 어디에 저장되는지 직접 통제하고 싶다
- 여러 개의 별도 도구를 조합하는 대신 채팅, 에이전트, 리서치, 문서, 이메일, 메모, 캘린더를 아우르는 하나의 워크스페이스를 원한다
- 작업에 따라 로컬 모델(Ollama, llama.cpp, vLLM) 또는 API 제공업체(OpenAI, OpenRouter)를 유연하게 연결하고 싶다
- 빠르게 바뀌는 README와 릴리스 주기를 따라가는 것을 포함해, 널리 스타를 받았지만 커뮤니티가 유지 관리하는 오픈소스 소프트웨어를 사용하는 데 익숙하다
다음에 해당하면 기다리거나 다른 대안을 찾아보세요
- Docker 배포 대신 원클릭 데스크톱 또는 모바일 앱을 원한다 — Odysseus는 현재 셀프 호스팅 단계가 필요하다
- 공식 지원 계약, SLA, 또는 기업용 라이선스를 갖춘 벤더 지원 제품이 필요하다 — 이 리뷰 작성 시점 기준 Odysseus는 상업적 지원 등급이 없는 오픈소스 프로젝트다
- 단순한 로컬 채팅 인터페이스만 필요하다 — 그런 더 좁은 요구에는 전용 로컬 채팅 앱 같은 단일 목적 도구가 설정 부담이 더 적다
- 이메일 및 캘린더 기능을 위해 직접 IMAP/SMTP 자격 증명과 CalDAV 동기화 설정을 관리하는 것이 부담스럽다
Odysseus 평가 시 흔한 실수
Odysseus를 둘러싼 대부분의 혼란은 셀프 호스팅 단계를 과소평가하거나, 그 기원 스토리를 특정 기능의 증거로 과대평가하는 데서 비롯됩니다.
실수 1: Odysseus를 다운로드 가능한 데스크톱 또는 모바일 앱으로 여기기
Odysseus는 원클릭 설치 프로그램이 아닙니다. 저장소를 복제하고 .env 파일을 설정한 뒤 직접 docker compose up -d --build를 실행하고, 그다음 브라우저로 http://localhost:7000에 접속하는 셀프 호스팅 Docker 배포입니다.
실수 2: PewDiePie 기원이 곧 오늘날에도 개인 단독 운영 프로젝트임을 의미한다고 여기기
Odysseus는 펠릭스 셸버그(PewDiePie)의 프로젝트로 시작했지만, 이후 저장소는 커뮤니티 운영 GitHub 조직 odysseus-dev로 이전되었습니다. 이 리뷰는 셸버그의 현재 일상적 관여 여부를 확인하지 않았습니다 — 지원과 로드맵을 평가할 때는 Odysseus를 한 개인의 지속적인 개인 유지 관리로 뒷받침되는 제품이 아니라 커뮤니티 오픈소스 프로젝트로 취급하세요.
실수 3: AGPL-3.0-or-later를 MIT 같은 허용적 라이선스와 동일하게 취급하기
AGPL-3.0-or-later는 네트워크 사용 관련 의무가 있는 카피레프트 라이선스입니다. Odysseus의 수정 버전을 다른 사람이 사용하는 서비스로 운영한다면 일반적으로 수정된 소스 코드를 공개해야 합니다. 포크를 기반으로 상업용 제품을 만들기 전에 라이선스 텍스트를 검토하세요.
실수 4: Odysseus가 작동하려면 로컬 모델이 필요하다고 여기기
Odysseus는 API 제공업체(OpenAI, OpenRouter)뿐 아니라 로컬 백엔드(Ollama, llama.cpp, vLLM)와도 작동합니다. 사용하기 위해 로컬 모델을 실행할 필요는 없으며, .env 파일에서 자신의 하드웨어와 프라이버시 요구에 맞는 백엔드를 설정하면 됩니다.
자주 묻는 질문
Odysseus는 무엇인가요?
Odysseus(github.com/odysseus-dev/odysseus)는 채팅, 에이전트, 심층 리서치, 문서/이메일/메모/캘린더 도구를 결합한 무료 오픈소스 셀프 호스팅 AI 워크스페이스로, 자신의 하드웨어에서 Docker를 통해 배포합니다.
Odysseus는 누가 만들었나요?
여러 독립 매체가 보도한 바에 따르면 Odysseus는 콘텐츠 크리에이터 펠릭스 셸버그(PewDiePie)가 시작했습니다. 저장소는 이후 커뮤니티 운영 GitHub 조직 odysseus-dev로 이전되었습니다.
Odysseus는 무료인가요?
네. Odysseus는 무료 오픈소스 소프트웨어입니다. 비용이 발생한다면 자체 호스팅 하드웨어나 연결하기로 선택한 API 제공업체에서 발생하며, Odysseus 자체에서 발생하지 않습니다.
Odysseus는 어떤 라이선스를 사용하나요?
저장소의 LICENSE 파일에 따라 AGPL-3.0-or-later입니다. 이는 수정 버전을 타인을 위한 네트워크 서비스로 운영할 경우 의무가 따르는 카피레프트 라이선스입니다.
Odysseus는 어떻게 설치하나요?
저장소를 복제하고(git clone https://github.com/odysseus-dev/odysseus.git), 예시 환경 파일을 복사한 뒤(cp .env.example .env) docker compose up -d --build를 실행하세요. 이후 워크스페이스는 http://localhost:7000에서 접근할 수 있습니다.
Odysseus는 로컬 AI 모델이 필요한가요?
아니요. Odysseus는 로컬 모델 백엔드(Ollama, llama.cpp, vLLM) 또는 API 제공업체(OpenAI, OpenRouter)와 작동하며, 어느 쪽을 사용할지는 .env 파일에서 설정합니다.
Odysseus의 GitHub 스타 수는 몇 개인가요?
GitHub API에 따르면 2026년 9월 12일 기준 스타 87,156개, 포크 860개였습니다. 빠르게 성장하는 프로젝트의 스타 수는 자주 바뀌므로 현재 수치는 저장소에서 직접 확인하세요.
Odysseus는 클라우드 서비스인가요?
아니요. Odysseus는 셀프 호스팅으로, 자신의 컴퓨터나 서버에서 Docker를 통해 직접 실행합니다. 공식 Odysseus 클라우드/SaaS 제품은 없습니다.
PromptQuorum이 Odysseus를 실제로 테스트했나요?
이 리뷰는 Odysseus 자체 저장소, README 문서, 라이선스 파일, 그리고 그 기원에 관한 독립 언론 보도에 근거하며, 스타 수와 라이선스는 GitHub API와 대조했습니다 — Odysseus의 AI 출력 품질에 대한 독자적인 벤치마킹을 수행했다고 주장하지는 않습니다.
Odysseus와 가장 가까운 대안은 무엇인가요?
비슷한 영역을 다루는 셀프 호스팅 오픈소스 도구로는 AnythingLLM(RAG/문서 채팅), Khoj(개인 지식 검색), LibreChat(다중 제공업체 채팅) 등이 있습니다 — 자세한 내용은 위의 비교 섹션과 로컬 AI 소프트웨어 디렉터리를 참고하세요.