2026 OpenHuman 설치 완전 가이드: 네 플랫폼 네이티브 패키지, Memory Tree와 Ollama 제로부터 가동

Tiny Humans AI 팀이 유지보수하는 OpenHuman은 Your Personal AI super intelligence를 표방하는 Rust + Tauri v2 크로스플랫폼 데스크톱 앱입니다. Gmail, Slack, GitHub, Notion 등 118+ 서비스를 OAuth로 가져온 데이터를 Token 압축 후 로컬 SQLite 기반 Memory Tree에 기록하여, 모델이 수 분 내에 주 단위 컨텍스트를 확보합니다(공식 문서).

설치 전 다음 세 가지 오해를 피하세요.

• 「디지털 휴먼 얼굴 교체」와 혼동: 수 GB .pth를 checkpoints/에 받을 필요가 없으며 NVIDIA CUDA 영상 추론에도 의존하지 않습니다. GUI 설치 패키지는 보통 수백 MB 수준입니다(버전별 변동).
• 순수 웹 채팅과 혼동: 핵심 가치는 백그라운드 자동 동기화 + 기억 트리 검색입니다. 창을 닫아도 기억은 유지되지만, 최초 OAuth와 인덱스 구축이 필요합니다.
• 미검증 스크립트 사용: 공식 문서는 curl … | bash로 스크립트 바이트 무결성을 검증할 수 없다고 명시합니다. 프로덕션에서는 Homebrew / 서명 apt / 서명 MSI를 우선하세요(install.md).

OpenClaw와의 역할: OpenClaw는 Telegram/WhatsApp 등 메시징 Bot 채널에 강하고, OpenHuman은 데스크톱 슈퍼 어시스턴트 + Memory Tree + 회의/음성에 강합니다. 둘 다 Ollama에 연결할 수 있으나 설치와 상주 방식은 다릅니다.

소스 빌드에는 Node.js 24+, pnpm, Rust 1.93+ 등이 필요합니다(저장소 README). 일반 사용자는 소스 체인 불필요합니다. 118+ 연동은 국제 SaaS 중심이며, 국내 생태 서비스는 Beta 단계에서 미지원일 수 있습니다. 배포 전 설정의 커넥터 목록을 확인하세요.

아래는 macOS Homebrew 예시입니다. Linux apt와 Windows MSI 명령은 같은 절 끝에 있으며 로직은 동일합니다.

brew tap tinyhumansai/openhuman
brew install openhuman
openhuman --version

# Linux Debian/Ubuntu (서명 저장소, 발췌)
# curl -fsSL .../KEY.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
# sudo apt-get update && sudo apt-get install -y openhuman

1. 채널 선택: 프로덕션은 Homebrew / apt / MSI 우선. 감사되지 않은 환경에서 프로덕션 머신에 curl | bash 실행 금지.
2. 설치 실행: macOS에서 brew install openhuman 후 터미널 openhuman으로 시작 가능. Launchpad GUI도 가능.
3. 버전 확인: GitHub Releases와 대조해 현재 Beta(예 v0.54.x)인지 확인. 구버전이면 brew upgrade openhuman 또는 패키지 관리자 업그레이드.
4. 최초 마법사: 앱 실행 후 계정 로그인, 시간대, 개인정보 옵션 완료. 데이터는 기본적으로 로컬 사용자 디렉터리 SQLite에 저장(경로는 설정 참조).
5. OAuth 소스 1–2개 연결: Gmail 또는 GitHub로 스모크 테스트 후 Memory Tree에 「동기 중 / 인덱싱됨」 표시 확인.
6. 스모크 대화: 「GitHub 지난주 issue 요약」, 「받은편지함 기반 회신 초안」 등으로 동기화 컨텍스트 인용 여부 확인.

Windows는 최신 Release에서 .msi 설치. Arch는 AUR openhuman-bin 참조. npm 전역 npm install -g openhuman은 최초 설치 시 플랫폼 바이너리 다운로드 및 SHA-256 검증. 실행 시 Node 불필요(공식 install.md).

Memory Tree는 소스 트리 → 주제 트리 → 글로벌 트리 3층 구조입니다. 하층은 커넥터(Gmail, Slack 등)별 원본 조각, 중층은 주제 클러스터, 상층은 대화 검색용입니다. 공식은 약 20분 주기 자동 증분 동기(현 Beta 설정 기준)와 TokenJuice류 Token 압축을 제시합니다.

1. 최소 권한 인증: 읽기 전용 소스 1–2개 먼저 연결, 인덱스 완료 후 확장. 최초 전량 동기화로 디스크·대역폭 포화 방지.
2. 인덱스 상태 관찰: 설정에서 커넥터 「마지막 동기 시간」 확인. syncing 장기 지속 시 프록시·OAuth 만료 점검.
3. Ollama 설치: 호스트에 Ollama 설치 후 ollama pull qwen2.5:7b 등(모델명은 환경에 맞게).
4. 로컬 엔드포인트: OpenHuman 설정에서 Local / Ollama 또는 LM Studio, Base URL 보통 http://127.0.0.1:11434/v1(OpenAI 호환 경로는 UI 기준).
5. 저 VRAM 전략: 16GB 통합 메모리는 7B–8B 양자화 우선. 13B는 Activity Monitor에서 Ollama+OpenHuman 합산 모니터링.
6. Obsidian 동기(선택): vault 경로는 SSD 로컬, 네트워크 드라이브는 watcher 실패 주의.

ollama serve
ollama pull qwen2.5:7b
# OpenHuman 설정 → Local LLM → http://127.0.0.1:11434

완전 오프라인: 클라우드 LLM API 없이 Ollama + 로컬 Memory만으로 대화·인덱스를 로컬에 유지. 법무·내부 문서 어시스턴트에 적합. M 시리즈 Mac은 dGPU 없이 7B급 실행 가능, 속도는 통합 메모리 대역폭에 좌우됩니다.

• 오픈소스 라이선스: 메인 저장소 GPL-3.0. 상용 파생물은 copyleft 준수, 폐쇄 제품 직접 임베드 전 법무 검토 권장(MIT OpenClaw 대비).
• 연동 규모: 공식 118+ OAuth 커넥터(설정 실시간 목록 기준).
• 저장: Memory 데이터는 로컬 SQLite, 기본 클라우드 업로드 없음. 제거 전 사용자 데이터 디렉터리 수동 백업.
• 버전 리듬: Early Beta. 2026년 5월 커뮤니티 GitHub Stars 약 6k+, 여러 차 Trending. 배포 전 Release changelog 필수 확인.

업데이트: brew upgrade / apt upgrade 또는 MSI 재설치. 주요 Beta 업그레이드 전 설정 스크린샷·SQLite 디렉터리 백업 권장.제거: 앱 삭제 후 잔여 데이터 디렉터리·Ollama 모델 캐시 수동 삭제.

노트북·오버셀 VPS의 세 가지 실제 약점: ① 덮개·절전으로 Memory 자동 동기 중단, 월요일에도 「기억 상실」; ② GUI 없는 Linux에서 OAuth·Tauri GUI 최초 설정 곤란; ③ 이웃 디스크 IO 경합으로 Ollama·인덱스 동시 지연, 「설치는 되나 불안정」.

OpenHuman 7×24 증분 기억 + 로컬 Qwen2.5가 필요하면 JEXCLOUD 베어메탈 Mac Mini M4에서 본 글 Homebrew·Ollama 구성 후 VNC로 OAuth 1회 완료, 이후 SSH로 모델·로그만 유지하는 경로가 안정적입니다. 가상화 오버셀 없음, 데이터는 임대 디스크. 해지 전 SQLite·Ollama 모델 디렉터리 패키지 백업. 사양·리전은 요금 페이지, 주문은 주문 페이지, 원격 데스크톱은 고객센터를 참고하세요.