2026년에 「OpenHuman 설치」를 검색하면 구식 Python clone + 모델 가중치 절차가 많이 나옵니다. 이는 범용 「디지털 휴먼」 템플릿에 가깝고, tinyhumans가 현재 밀고 있는 데스크톱 UI Agent와는 다른 제품입니다. 본문은 macOS / Windows / Linux에서 OpenHuman을 「다운로드·설치」에서 「로그인, Gmail/Slack 연결, 첫 ingest 대기, Memory Tree 사용, 선택적 Ollama 로컬 추론」까지 진행하려는 초보자와 개발자를 위한 것입니다. 먼저 여섯 가지 설치 오해를 정리하고, 환경 대조표와 서명 패키지 우선 설치 경로를 제시한 뒤, 8단계 첫 실행 체크리스트와 오류 매트릭스를 제공합니다. OpenClaw와의 조합 배포는 사이트 Mac 대여로 OpenClaw & OpenHuman을 참고하세요. 월 요금은 NOVAKVM 가격 페이지, 주문은 주문 페이지입니다. 아래 버전과 명령은 공식 문서와 GitHub Releases를 기준으로 하며, 릴리스 후 링크를 다시 열어 확인하세요.
[ SECTION_01 ] // PAIN_MAP OpenHuman 설치에서 가장 흔한 여섯 가지 오해 (2026)
- 「먼저 git clone 후 pip install -r requirements.txt가 필수」: 공식 주 경로는 데스크톱 설치 패키지 또는 시스템 패키지 관리자(Homebrew / 서명 APT / MSI)입니다. 터미널에서 Python 의존성을 수동으로 끌어오는 디지털 휴먼 공정이 아닙니다.
- 「NVIDIA GPU 없으면 안 돌아간다」: OpenHuman은 기본적으로 호스팅 모델 라우팅을 사용할 수 있습니다. 민감한 단계에는 Ollama를 선택할 수 있으나 CUDA 학습 환경은 필수가 아닙니다.
- 「설치 직후 Briefing이 비어 있으면 고장」: 공식 Getting Started에 따르면 데이터 소스 연결 후 첫 자동 수집은 약 20분 이내에 실행됩니다. 너무 이른 평가는 오판의 원인이 됩니다.
- 「모든 데이터가 클라우드에 있다」: Memory Tree 데이터베이스, Markdown vault, 워크스페이스 설정은 로컬에 있습니다. 로그인, 일부 OAuth, 모델 라우팅은 OpenHuman 호스팅 서비스를 경유할 수 있으므로 경계를 구분하세요.
- 「curl | bash와 Homebrew가 완전히 동일」: README는 스크립트가
raw.githubusercontent.com에서 오며 독립 서명 검증이 없다고 명시합니다. 프로덕션 환경에서는 서명 네이티브 패키지를 우선하세요. - 「노트북 덮개를 닫아도 프로덕션 ingest 머신」: 대용량 메일과 대규모 코드베이스 동기화는 메모리와 SSD를 소비합니다. 절전은 백그라운드 수집을 중단하며, 「App을 열 수 있다」와는 별개입니다.
다음은 OpenHuman 공식 진입점입니다. 릴리스마다 설치 프로그램 URL과 시스템 요구사항을 다시 확인하세요.
OpenHuman 공식 다운로드 (tinyhumans.ai)
OpenHuman Getting Started (GitBook)
tinyhumansai/openhuman (GitHub 저장소 및 Releases)
[ SECTION_02 ] // ENV_MATRIX OpenHuman 환경 요구사항: 최소 구성과 배포 호스트 선택
아래 표는 데스크톱 클라이언트의 실무 최소 기준입니다. 동일 머신에서 Ollama나 대용량 메일 ingest를 돌릴 때는 「권장」 열로 계획하세요. 금액과 재고는 표에 포함하지 않습니다. 가격 페이지에서 확인하세요.
| 항목 | 최소 | 권장 (대용량 메일 + 선택적 로컬 모델) |
|---|---|---|
| OS | macOS / Windows / Linux 데스크톱 (공식 DL 페이지 참조) | macOS 14+ (Apple Silicon) 또는 Ubuntu 24.04 LTS 데스크톱 |
| 메모리 | 공식 문서 cited 4 GB+ | 16 GB+; 초대형 Gmail/저장소 동기화 또는 동기 Ollama는 24–32 GB 검토 |
| 디스크 | 수 GB 여유 | 고속 SSD; vault + SQLite ingest는 메일 규모에 따라 급증 |
| GPU | 불필요 (호스팅 라우팅) | Apple Silicon 통합 메모리는 로컬 추론에 유리; 독립 GPU 없이도 CPU/Ollama 경로 가능 |
| 네트워크 | 로그인 및 OAuth 연동 접근 가능 | 안정적 egress; 첫 ingest와 약 20분 주기 백그라운드 수집에 상시 온라인 필요 |
| 호스트 | 설치 난이도 | 백그라운드 ingest | 전형적 문제 |
|---|---|---|---|
| 개인 MacBook | 낮음 (Homebrew / DMG) | 덮개 닫으면 중단, 체험용 | 개인 메일과 Agent 기억이 동일 머신 |
| GUI 없는 Linux VPS | 높음 (비공식 주 경로) | 네이티브 GUI와 공식 데스크톱 연동 부재 | 화면 인식, 음성 등 제한 |
| NOVAKVM 월간 Mac mini M4 | 낮음 (macOS 주 경로와 일치) | 전용 bare metal 7×24 온라인 | vault 백업과 반납 시 삭제 계획 필요 |
UI와 Prompt 한 줄만 검증하려면 노트북으로 충분합니다. Memory Tree를 수주간 ingest하려면 App을 절전하지 않는 프로덕션 Mac에 두세요.
[ SECTION_03 ] // INSTALL OpenHuman 플랫폼별 설치: 서명 패키지 우선, 스크립트는 대안
macOS (Homebrew 권장, 시스템 패키지 서명 체인):
brew tap tinyhumansai/core
brew install openhumanLinux (Debian/Ubuntu 서명 APT 저장소, 아키텍처는 공식 기준): GPG와 sources.list.d 항목을 가져온 뒤 apt-get install openhuman합니다. 전체 명령 시퀀스는 GitHub README 「Linux (Debian/Ubuntu — signed apt repo)」 절을 참고하고, 릴리스 후 URL을 재확인하세요.
Windows: GitHub Releases에서 서명 .msi를 다운로드해 설치합니다. 공식 다운로드 페이지에서 최신 빌드를 가져올 수도 있습니다.
범용 설치 프로그램: Releases에서 .dmg, .deb, .AppImage 등을 받을 수 있습니다. 스크립트가 필요하면 macOS/Linux 및 Windows용 install 스크립트가 있으나, README에서는 별도 서명 없는 live 스크립트로 표시되어 네이티브 패키지보다 무결성 위험이 큽니다.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash설치 후 데스크톱 App을 한 번 실행하고 Dock/시작 메뉴에 OpenHuman 아이콘이 나타나는지 확인하세요. 이 단계에서 로그인과 데이터 소스 연결을 건너뛰지 마세요.
[ SECTION_04 ] // RUNBOOK 8단계로 OpenHuman 가동: 로그인, 소스 연결, 첫 Prompt와 로컬 AI
- 다운로드 및 설치: Homebrew / APT / MSI 우선; 설치 후 App을 실행하고 버전이 Releases 페이지와 일치하는지 확인합니다.
- 제품 계정 로그인: 첫 화면은 Sign in; 대부분 소셜 로그인입니다. Advanced 패널에서 custom core RPC URL을 입력할 수 있습니다(자체 백엔드). 일반 사용자는 무시해도 됩니다.
- 로컬과 호스팅 경계 이해: Memory Tree, vault, 워크스페이스는 로컬; 기본은 호스팅 sign-in, 모델 라우팅, OAuth, 검색 프록시를 사용합니다. 커스텀 경로는 공식 Custom setup을 참고하세요.
- 최소 하나의 데이터 소스 연결: 설정 마법사에서 Gmail, Slack 등을 OAuth로 연결합니다. 인가 실패 시 시스템 시간과 브라우저 콜백을 확인하세요.
- 첫 ingest 대기: 공식 설명에 따르면 연결 후 약 20분 이내 첫 자동 수집이 실행됩니다. 이 기간 UI는 볼 수 있으나 Briefing류 답변은 아직 빈약할 수 있습니다.
- 첫 Prompt 스모크 테스트: ingest 후 「지난주 메일 제목을 요약해줘」 등을 시도해 Memory Tree에 컨텍스트가 들어갔는지 확인합니다.
- 선택: Ollama 로컬 AI 활성화: 설정에서 로컬 런타임을 켭니다(버전이 제공하는 경우). 동기 모델 실행 시 16 GB+를 계획하고 SSD 사용량을 모니터링하세요.
- vault 디렉터리 백업: 기기 변경 또는 반납 전 SQLite Memory Tree와 Obsidian 호환
.mdvault를 백업합니다. App만 재설치하면 「기억 상실」이 됩니다.
Memory Tree는 연결 데이터를 약 3k token Markdown 블록으로 정규화해 로컬 SQLite에 쓰고 편집 가능한 vault에 동기화합니다. 이는 「매 대화마다 제로에서 시작」하는 순수 클라우드 채팅 제품과 경로가 다릅니다. 원격 Mac에서 ingest를 장기 운영할 때 SSH와 세션 기준선은 고객 센터를 참고하세요.
[ SECTION_05 ] // TROUBLESHOOT OpenHuman 설치와 첫 실행 흔한 오류
| 현상 | 흔한 원인 | 조치 방향 |
|---|---|---|
| pip 절차 후 App을 찾을 수 없음 | 비공식 「디지털 휴먼」 템플릿 오용 | tinyhumans 데스크톱 경로와 Releases로 전환 |
| 로그인 후 계속 메일 맥락 없음 | 첫 ingest 주기 미도달 | 약 20분 대기 후 Prompt 재시도 |
| 디스크 급증 | 대용량 메일 + vault 이중 기록 | 오래된 연결 정리, 대용량 SSD 또는 512GB+ 대여로 이전 |
| Ollama 활성화 후 버벅임 | 메모리와 모델 크기 불일치 | 더 작은 양자화 모델로 변경 또는 24–32 GB 메모리로 |
| brew install 실패 | tap 미추가 또는 아키텍처 미지원 | README의 brew tap과 Apple Silicon/Intel 패키지명 대조 |
응용: 콘텐츠 낭독 실습. ingest 완료 후 「지난주 특정 메일을 바탕으로 30초 낭독 원고를 써줘」 등으로 Agent가 Memory Tree를 이해하는지 검증할 수 있습니다. 내보내기나 2차 편집은 vault 내 Markdown 블록을 직접 수정하면 됩니다. 실시간 Meet 참여나 마스코트 입모양 등은 현행 Releases 설명을 기준으로 하고, 출처 불명 데모 효과를 그대로 따라 하지 마세요.
[ SECTION_06 ] // HARD_FACTS 인용 가능한 기술 정보와 NOVAKVM 마무리
- 라이선스와 저장소: OpenHuman은 GitHub에서 GNU GPL-3.0으로 공개되며 코드베이스는
tinyhumansai/openhuman입니다. (출처: 저장소 LICENSE, 릴리스 후 재확인.) - 시스템 요구사항: 공식 Getting Started는 데스크톱 macOS, Windows, Linux, 4 GB+ RAM을 지원하며, 대용량 메일/저장소 또는 동기 로컬 모델에는 16 GB+를 권장합니다.
- 기억 아키텍처: Memory Tree+는 데이터를 ≤3k token Markdown 블록으로 canonicalize하고 계층 요약을 SQLite에 저장하며 Obsidian 호환 vault에 기록합니다. (출처: 프로젝트 README 기능 설명.)
- 연동 리듬: Gmail 등 연결 후 첫 자동 수집은 약 20분 이내; 이후 백그라운드 주기는 GitBook을 기준으로 하세요.
- 버전 확인: GitHub Releases와 App 내 About을 기준으로 하고, 2차 기사의 Star 수나 미측정 성능 순위를 그대로 인용하지 마세요.
「설치했다」를 시작점으로 보세요. 개인 노트북은 주말 체험용이지만, 절전, OS 업데이트, 개인 메일과 동일 디스크는 Memory Tree ingest를 자주 끊습니다. GUI 없는 Linux VPS에서는 공식이 강조하는 데스크톱 연동과 화면 컨텍스트를 완전히 담기 어렵습니다. 로컬에서 OpenHuman의 장기 가치를 확인했다면, 더 현실적인 프로덕션 경로는 월간 전용 Mac mini M4로 2–4주 ingest와 vault 증가 곡선을 본 뒤 자체 하드웨어 구매를 판단하는 것입니다.
NOVAKVM 가격 페이지에서 메모리와 디스크를 선택하고, 주문 페이지에서 노드를 기동한 뒤 본문 8단계로 설치와 첫 실행을 완료하세요. 네이티브 macOS 설치 경로, 대용량 메일 ingest 7×24 온라인, 예측 가능한 반납 시 삭제가 필요한 OpenHuman 프로덕션 환경에서는 NOVAKVM Mac mini 클라우드 bare metal 대여가 주력 노트북을 상시 가동하는 것보다 의사결정 비용이 낮은 경우가 많습니다.