데스크톱 원클릭 설치 · OAuth 연동 · 6단계 Runbook · 로컬/관리형 경계 · 7×24 호스트 선정
2026년에 OpenHuman(tinyhumansai/openhuman, GitHub 약 2.9만 Star)을 가동하고 싶은데 「pip로 모델을 설치해야 하나, DMG를 받아야 하나」가 헷갈리시나요? 본문은 단계별 완전 가이드입니다. Rust + Tauri 데스크톱, Memory Tree 로컬 SQLite, 118+ OAuth 연동, 20분마다 auto-fetch를 순서대로 설명합니다. 환경 대조표, 6단계 Runbook, 첫 요청 검증, 오류 표, 7×24 호스트 권장 사항을 포함하며, OpenClaw 이중 프레임워크 글과 달리 OpenHuman 단독 설치에 집중합니다.
OpenHuman(TinyHumans, GPL-3.0)은 로컬 우선 데스크톱 AI 슈퍼 어시스턴트입니다. Memory Tree가 Gmail, GitHub, Notion, Slack 등 소스 데이터를 정규화 Markdown 청크로 만들어 블랙박스 벡터 DB가 아닌 본기 SQLite에 기록합니다. 내장 자동 모델 라우팅(추론 작업은 최신 모델, 경량 작업은 저비용 모델), 웹 검색, Coder 툴체인, 음성, Google Meet에 참여할 수 있는 데스크톱 마스코트도 제공합니다. ChatGPT 웹과의 차이는 주를 넘는 맥락이 디스크에 남는다는 점과 OAuth 원클릭 연동입니다.
설치 단계의 다섯 가지 함정: OpenHuman을 「CUDA 설정이 필요한 디지털 휴먼」으로 오해하기, 로컬 vs 관리형 경계 무시, auto-fetch 완료 전 질문하기, 덮개를 닫은 MacBook에서 7×24 동기화 기대하기, 소스 빌드에서 Node 24 / Rust 1.93 부족——아래에서는 공식 데스크톱 설치 + 첫 가동만 다룹니다. OpenClaw와 동일 호스트 비교는 5월 이중 프레임워크 글을 참고하세요.
| 환경 항목 | 최소 요구 | 권장(대용량 메일 + 로컬 모델) |
|---|---|---|
| OS | macOS / Windows 10+ / Linux 데스크톱 | macOS 14+ Apple Silicon 또는 Ubuntu 24.04 LTS |
| 메모리 | 4 GB 이상 | 16 GB 이상(공식: 대용량 메일/저장소 또는 본기 모델) |
| 디스크 | 약 2 GB 앱 + 증가형 SQLite | 50 GB 이상 SSD, Memory Tree와 로그 여유 |
| GPU | 불필요(기본 클라우드 라우팅) | 본기 local model 시 Apple Silicon UMA가 안정적 |
| 네트워크 | 로그인·OAuth에 외부 연결 필요 | 안정 회선, Meet·auto-fetch에 유리 |
pip/CUDA 경로 오용: 최종 사용자는 설치 패키지 또는 curl 스크립트를 사용하며, pip install -r requirements.txt 디지털 휴먼 저장소가 아닙니다.
데이터 경계 무시: Memory Tree는 로컬이지만 기본 로그인, 일부 OAuth, 검색 프록시는 관리형 서비스 경유——Advanced에서 RPC와 자체 모델을 변경할 수 있습니다.
첫 질문이 너무 이릅니다: Gmail/GitHub 연결 후 약 20분 auto-fetch로 트리에 기록될 때까지 기다린 뒤 「지난주 메일 요약해줘」라고 질문하세요.
본기를 7×24 서버로 사용: 노트북 덮개를 닫으면 동기화가 끊깁니다. Memory Tree 복리에는 상시 가동 데스크톱 호스트가 필요합니다.
소스 빌드 의존성 부족: 기여자는 Git, Node.js 24+, pnpm 10.10, Rust 1.93(rustfmt/clippy 포함), CMake, 서브모듈이 필요합니다.
동일한 OpenHuman이라도 채널과 호스트에 따라 서명 업데이트, uptime, 백그라운드 auto-fetch 적합성이 달라집니다. 아래 표는 「설치 후에도 Memory Tree를 매일 키우고 싶은」 운영 관점입니다.
| 채널 / 호스트 | 적합 대상 | 7×24 auto-fetch | 비고 |
|---|---|---|---|
| 공식 DMG / MSI | macOS / Windows 일반 사용자 | 머신 상시 가동에 의존 | tinyhumans.ai/openhuman에서 다운로드 |
| curl / Homebrew / apt | 터미널에 익숙한 macOS / Linux 사용자 | 동일 | 스크립트·패키지 매니저는 README와 동기 |
| 개인 MacBook | 시험, 경량 연동 | 덮개 닫으면 중단 | POC만, 운영 기억 복리에는 비권장 |
| Mac Mini M4 월 렌탈 | 팀 공유 Memory Tree, Meet 프록시 | DC SLA 상시 가동 | SSH 인도, Ollama/OpenClaw 동일 호스트(5월 글 참고) |
설치는 몇 분이면 됩니다. Memory Tree를 20분마다 자동으로 키우려면 적절한 7×24 호스트가 필요합니다.
공식은 macOS/Linux 원클릭 스크립트와 Windows PowerShell을 제공합니다. Linux에서는 서명 apt 저장소도 설정할 수 있습니다. 렌탈 노드에서 OpenClaw Gateway와 OpenHuman 데스크톱을 동시 가동할 계획이면 16 GB 이상 UMA M4를 선택하고 SQLite·로그용 디스크 할당량을 확보하세요.
다음은 최종 사용자 데스크톱 설치용입니다(소스 기여자용 아님). 데이터는 기본적으로 본기 앱 데이터 디렉터리(SQLite Memory Tree·Markdown vault 포함)에 저장됩니다. 업그레이드 전 백업하세요.
다운로드 및 설치: tinyhumans.ai/openhuman에서 DMG/MSI를 받거나 공식 설치 스크립트(macOS/Linux x64)를 실행합니다.
첫 실행 및 로그인: Sign in! Let's Cook에서 소셜 계정으로 로그인합니다. 대부분 Advanced RPC URL 변경은 불필요합니다.
첫 소스 연결: 온보딩에서 OAuth로 Gmail 또는 GitHub(118+ 연동 중 선택)를 연결하고 권한 성공을 확인합니다.
auto-fetch 대기: 앱을 전면 또는 상시 가동 호스트에서 약 20분 유지해 코어 스케줄러가 가져와 Memory Tree에 접어 넣게 합니다.
첫 요청 검증: 「GitHub에서 지난주 연 PR 요약해줘」「최근 메일을 주제별로 정리해줘」 등으로 질문해 답변이 내 데이터를 인용하는지 확인합니다.
선택 고급 설정: 설정에서 모델 라우팅을 확인하고 로컬 모델(대메모리 머신)을 켜거나 자체 Composio / 검색 자격 증명으로 관리형 의존을 줄입니다.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash brew tap tinyhumansai/core brew install openhuman
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
로컬 vs 관리형: Memory Tree, Markdown vault, 워크스페이스 설정은 본기에 있습니다. 기본적으로 OpenHuman 관리형 로그인, 모델 라우팅, 일부 OAuth, 검색 프록시를 사용합니다. 완전 자체 모델·자격 증명은 문서의 custom setup 경로를 따르세요.
다음 증상은 「앱은 열렸는데 Memory Tree가 비어 보이는」 단계에서 많습니다. 표 순서대로 제외하고 재설치·계정 변경·DB 초기화를 동시에 하지 마세요.
| 현상 | 흔한 원인 | 조치 |
|---|---|---|
| 로그인 후 Gmail/GitHub 연결 실패 | 네트워크 또는 OAuth 콜백 차단 | 시스템 프록시/방화벽 확인, OAuth 재시도, 기업 환경에서 콜백 도메인 허용 |
| 답변이 내 데이터와 무관 | auto-fetch 미완료 | 앱 상시 가동 후 약 20분 뒤 재질문, 연동 페이지 Active 확인 |
| Linux 설치 스크립트 실패 | 비 x64 또는 의존 라이브러리 부족 | 공식 패키지로 전환, GitBook Getting Started 플랫폼 설명 참고 |
| pnpm dev:app 빌드 실패 | Node/Rust 버전 불일치 | Node 24+, pnpm 10.10, Rust 1.93 및 서브모듈 정렬 |
| 본기 모델 OOM | 메모리 부족 | local model 끄고 관리형 라우팅으로 복귀하거나 16 GB 이상 호스트로 이전 |
대용량 메일이나 단일 저장소 ingest 시 디스크 IO와 16 GB RAM을 우선 확보하세요. 메모리가 적으면 일시적으로 병렬 소스를 줄입니다. Voice, Meet 프록시, Coder 툴체인은 기본 포함되어 「파일 읽기 플러그인」 추가 설치는 불필요합니다. OpenClaw Gateway 등 다른 자동화 스택과 동일 호스트일 때 SQLite·로그 디렉터리 스냅샷 백업으로 vault 오삭제를 방지하세요.
tinyhumansai/openhuman 약 2.9만 Star(2026년 6월 기준), Rust + Tauri 데스크톱 스택.실전 시나리오: 개인 개발자가 GitHub + Notion을 연결해 주간 보고 자동 생성; 운영이 Gmail + Calendar로 회의 요약; 팀이 OpenHuman을 렌탈 Mac Mini에 올리고 VNC/SSH로 유지하며 노트북은 덮개를 닫을 수 있음——노트북·가정 PC로도 설치 검증은 가능하지만 슬립·IO로 Memory Tree 복리가 끊깁니다. Linux VPS 단독으로는 공식 완전 데스크톱 경험이 없습니다. OpenHuman을 「지난주 메일을 기억하는 동료」로 쓰려면 Mac Mini M4 월 렌탈이 uptime과 UMA를 예측 가능 OpEx로 묶어 줍니다.
본 Runbook 완료 후 7×24 상시 노드가 필요하면 VpsMesh Mac Mini M4 클라우드 렌탈: SSH 인도, 리소스 패널, 해지 전 앱 데이터 디렉터리 백업 가능합니다. 요금은 Mac Mini M4 렌탈 가격, 배포는 고객 센터, 주문은 주문 페이지를 참고하세요.
주의: 같은 주말에 호스트 변경, Memory Tree 초기화, 메이저 업그레이드, 전체 OAuth 변경을 동시에 하지 마세요. 네 가지를 병행하면 이분 탐색이 불가능합니다. 첫 요청을 24시간 안정시킨 뒤 로컬 모델·Meet 프록시로 진행하세요.
필요하지 않습니다. 최종 사용자는 공식 설치 패키지, curl | bash, Homebrew, apt로 데스크톱 앱을 설치하면 됩니다. 소스에서 빌드할 때만 Node 24+, pnpm 10.10, Rust 1.93 등 개발 체인이 필요하며 「디지털 휴먼 CUDA 학습」과는 다른 경로입니다.
Memory Tree 데이터베이스, Markdown vault, 워크스페이스 설정은 기본적으로 본기 SQLite입니다. 기본 설정은 OpenHuman 관리형 로그인, 모델 라우팅, 일부 OAuth, 검색 프록시를 사용합니다. Advanced / custom setup에서 자체 모델과 Composio 자격 증명을 연결해 경계를 강화할 수 있습니다.
OpenHuman은 데스크톱 앱이며 공식 완전 경험은 macOS/Windows/Linux GUI가 전제입니다. auto-fetch와 Meet 프록시를 상시 가동하려면 덮개를 닫은 MacBook보다 Mac Mini M4 월 렌탈이 안정적입니다. OpenClaw와 동일 호스트도 가능합니다(이중 프레임워크 배포 글 참고). 요금은 가격 페이지, 주문은 주문 페이지입니다.