pip install＋디지털 휴먼 Demo」 튜토리얼로 OpenHuman을 찾으면 다른 프로젝트를 설치하는 경우가 많습니다. 2026년 공식 제품은 tinyhumansai/openhuman에서 나오며, 데스크톱 Agent + Memory Tree 장기 기억이 핵심이지 Python 얼굴 교체 파이프라인이 아닙니다. 본문은 실행 가능한 결론을 제시합니다. ① macOS / Linux / Windows는 Homebrew, apt, MSI 네이티브 패키지 우선; ② 로그인 후 Memory Tree 첫 요청 통과; ③ 로컬 DB와 호스팅 OAuth 경계 구분; ④ 대용량 메일 + 로컬 모델은 16GB 이상 권장. 환경 매트릭스, 6단계 Runbook, 오류 표, M4 호스트 제안까지 한 번에 정리합니다.
2026 OpenHuman이란? OpenClaw·Hermes와 어떻게 고를까
OpenHuman(GPL-3.0, Rust 코어)은 데스크톱에 상주하는 개인 AI 초두뇌를 지향합니다. 원클릭 OAuth로 100개 이상 앱에 연결하고, 메일·문서를 로컬 SQLite와 Obsidian 호환 Markdown 라이브러리에 축적해 검색 가능한 Memory Tree를 만듭니다. OpenClaw 이중 스택 글이 강조하는 「채널 Gateway + ClawHub」와 달리 OpenHuman은 지식 수집과 기억 압축에 치우칩니다(공식은 token 비용을 약 80% 절감 가능하다고 합니다. 실제 청구서로 확인하세요).
OpenClaw와 비교: OpenClaw는 Telegram·WeChat 등 7×24 Gateway에 강하고, OpenHuman은 데스크톱 Memory Tree와 118개 이상 통합이 강점입니다. 둘을 한 머신에서 돌리면 메모리를 서로 빼앗습니다.
Hermes와 비교: Hermes는 CLI + hermes gateway + Skill 카탈로그입니다. OpenHuman은 GUI onboarding 중심이며, 기본값은 호스팅 로그인과 모델 라우팅(Advanced에서 RPC 변경 가능)입니다.
설치 오류 주의: conda create, checkpoints/*.pth, run_demo.py는 필요 없습니다. 이는 다른 계열의 「디지털 휴먼 영상」 템플릿용이며 공식 저장소와 무관합니다.
버전: 2026년 6월 기준 Release는 v0.56.x 전후 Early Beta입니다. 설치 후 앱 내에서 업데이트를 확인하세요.
OpenHuman 설치 환경 요건: macOS·Windows·Linux 대조
| 항목 | 최소 요건 | 권장(대용량 메일 + 로컬 모델) |
|---|---|---|
| OS | macOS 12+, Windows 10+, Ubuntu 20.04+ | macOS 14+(Apple Silicon) 또는 Ubuntu 24.04 LTS |
| 메모리 | 4 GB(공식 문서) | 16 GB 이상(대량 Gmail/저장소 수집 + 동일 머신 추론) |
| 디스크 | 약 2 GB(앱·인덱스) | 50 GB 이상 SSD(Memory Tree + Markdown 라이브러리 증가) |
| GPU | 불필요(기본 호스팅 모델) | 동일 머신 로컬 추론 시에만 Apple Silicon / NVIDIA |
| 네트워크 | 로그인, OAuth, 모델 API | 안정적 출구 회선. 국내 사용자는 네이티브 패키지 + npm 미러 가속 권장 |
| 설치 경로 | 무결성 검증 | 적용 시나리오 |
|---|---|---|
| Homebrew / apt / MSI | OS 패키지 관리자 서명 체인 | 프로덕션 1순위 |
| npm -g openhuman | 플랫폼 바이너리 SHA-256 검증 | Node ≥18 개발자 |
| curl | bash 스크립트 | 독립 스크립트 서명 없음, 공식 비권장 | 임시 시험만 |
| Git 소스 빌드 | Rust 툴체인 필요 | 기여자·고급 사용자 |
OpenHuman 완전 설치: 6단계 Runbook(4플랫폼)
brew tap tinyhumansai/core brew install openhuman openhuman --version
sudo apt-get install -y gnupg2 curl ca-certificates curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \ | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \ https://tinyhumansai.github.io/openhuman/apt stable main" \ | sudo tee /etc/apt/sources.list.d/openhuman.list sudo apt-get update && sudo apt-get install -y openhuman
경로 선택: macOS는 Homebrew. Linux amd64는 apt. Windows는 GitHub Releases에서 서명된 .msi 다운로드. 크로스 플랫폼은 npm install -g openhuman도 가능(Node ≥18).
바이너리 검증: 터미널에서 openhuman --version 실행, 또는 데스크톱 앱 About에서 v0.53 이상 확인합니다.
첫 실행·로그인: 「Sign in! Let's Cook」 화면에서 소셜 로그인. Advanced에서 custom core RPC URL 설정 가능(셀프호스트 시).
데이터 소스 연결: onboarding에서 Gmail 등 연결. 데이터는 로컬 Memory Tree에 기록되며 Markdown 라이브러리는 Obsidian 워크플로와 연동됩니다.
첫 요청 통과: Memory Tree에 검증 가능한 질문(예: 「지난주 특정 라벨 메일 요약」)을 던져 로컬 인덱스를 인용한 답변인지 확인합니다.
업데이트·롤백: brew/apt는 패키지 관리자로 업그레이드. Release 페이지에서 이전 MSI/dmg로 롤백 가능. Beta 기간에는 소버전 고정을 권장합니다.
경계 알림: Memory Tree DB, Markdown vault, 워크스페이스 설정은 로컬입니다. 다만 기본값은 OpenHuman 호스팅 로그인, 모델 라우팅, 일부 OAuth 프록시에 의존합니다. 셀프호스트는 Advanced / 문서의 custom setup을 참고하세요.
OpenHuman 고급 설정: 로컬 모델 라우팅·성능·오류 빠른 참조
설치만으로는 「설정 완료」가 아닙니다. 수집 규모, 모델 라우팅, 디스크·상시 실행 세 가지가 장기 사용 경험을 좌우합니다.
| 오류 / 현상 | 흔한 원인 | 조치 |
|---|---|---|
| 로그인이 계속 로딩 | 네트워크 또는 호스팅 서비스 도달 불가 | 회선 변경, 프록시 확인. Advanced에서 사용 가능한 RPC 설정 |
| OAuth 승인 실패 | 브라우저 차단 또는 계정 권한 | 시스템 기본 브라우저로 재시도. Workspace 관리자 정책 확인 |
| 수집 극도로 느림 / 디스크 급증 | 대용량 메일함 전량 동기화 | 먼저 메일 범위 축소. 디스크 50GB 이상 확보. 16GB 메모리 |
| 로컬 모델 OOM | 4GB 머신에서 7B+ 실행 | 호스팅 라우팅으로 전환, 또는 16GB 이상 / Apple Silicon으로 |
command not found: openhuman | PATH에 brew/npm 접두사 미반영 | 터미널 재시작. brew link openhuman 또는 npm global bin 확인 |
로컬 모델: 공식 GitBook에 local AI / model routing 경로가 있습니다. 동일 머신 Ollama는 OpenClaw 스택과 같으며 M4 24GB가 여유롭습니다. 자세한 내용은 M4 이중 스택 가이드를 참고하세요.
저 VRAM 모드: 독립 GPU가 없으면 CPU / Metal 경로에 의존합니다. 호스팅 모델을 우선하고 전량 메일 수집과 병렬 피크를 피하세요.
제거: 패키지 관리자로 앱 삭제 후 Memory Tree 데이터 디렉터리와 Markdown vault(앱 설정 경로)를 수동 정리해 디스크 점유를 방지합니다.
설치 이후: 7×24 수집과 Mac Mini M4 호스트 수치
커뮤니티 규모: 2026년 6월 기준 openhuman GitHub Star 약 2.9만(급증 중)이며 데스크톱 Beta 중심 개발입니다.
소비 전력: M4 유휴 약 4–6W. 백그라운드 동기화 + 로컬 7B에서 전형 18–28W. 기억 수집 전용 머신으로 현실적입니다.
통합 메모리: 16GB UMA에서 데스크톱 Agent + SQLite FTS + 소형 모델 병행 시 4GB x86 VPS보다 swap 유발 인덱스 손상 위험이 낮습니다.
노트북 덮개를 닫으면 메일 증분 동기화가 끊깁니다. Windows 데스크톱에는 launchd급 경량 데몬이 없습니다. Memory Tree를 지속적으로 키우고 가끔 로컬 모델을 올려야 한다면 MESHLAUNCH Mac Mini M4 클라우드 베어메탈 월 대여가 보통 최적입니다. 로컬과 같은 brew 경로, SSH 유지보수, 반납 전 데이터 디렉터리 패킹·이전이 가능합니다. 먼저 대여 가격 페이지에서 일 단위 시운전, 경계는 고객 센터를 확인하세요.
아닙니다. Homebrew, apt, MSI로 데스크톱/CLI 바이너리를 설치하세요. pip install -r requirements.txt는 다른 계열의 「디지털 휴먼 영상」 템플릿용이며 tinyhumansai 공식 저장소와 무관합니다.
가능합니다. 기본 호스팅 모델로 Memory Tree를 통과할 수 있습니다. 동일 머신 Ollama라면 Apple Silicon Metal 경로가 현실적입니다. M4 노드를 대여해 24시간 수집 부하 시험도 할 수 있습니다.
프로젝트는 GPL-3.0입니다. 클로즈드 소스 상업 배포에는 Copyleft 의무가 있습니다. 사내 자체 사용도 공식 라이선스와 호스팅 서비스 약관을 확인하고 필요 시 tinyhumans 상업 지원에 문의하세요.