OpenHuman 설치 가이드(2026 최신): 5분 만에 AI 디지털 트윈 구축

# 1. 시스템과 칩(Apple Silicon은 arm64)
sw_vers
uname -m

# 2. Homebrew 사용 가능 여부(brew 설치 시)
brew --version
brew doctor

# 3. 로컬 Ollama 사용 시 11434 포트 비어 있는지
lsof -i :11434 || echo "포트 11434 비어 있음, Ollama 시작 가능"

# 4. 디스크 여유(Memory Tree + 모델 캐시, ≥5GB 권장)
df -h ~

# 브라우저에서 최신 Release 열기(칩에 맞는 arm64 / x64 선택)
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# 또는 공식 다운로드 페이지
open "https://tinyhumans.ai/openhuman"

# 다운로드 후 CLI로 DMG 마운트 후 「응용 프로그램」에 복사(파일명은 실제에 맞게)
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# macOS가 「개발자를 확인할 수 없음」으로 차단 시 격리 속성 제거 후 열기
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman

# 1. 공식 tap 추가(최초 1회)
brew tap tinyhumansai/core

# 2. 설치(현재 stable 바이너리 가져옴)
brew install openhuman

# 3. PATH 등록 확인
which openhuman
openhuman --version

# 4. 데스크톱 실행(CLI가 App 실행, 또는 Launchpad에서 OpenHuman)
openhuman

# 5. 이후 업그레이드
brew update
brew upgrade openhuman

# 대안: core tap 없이 일부 문서 기재
# brew install tinyhumansai/openhuman/openhuman

# Node 버전 확인
node -v

# npm 패키지 설치(최초는 플랫폼별 네이티브 바이너리를 SHA-256 검증과 함께 다운로드)
npm install -g openhuman

openhuman --version
openhuman

# 1. GPG 가져오기 및 apt 소스 추가(공식 install 문서 단계)
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

# 2. 설치 및 실행
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version

# 1. 스크립트만 다운로드(내용 확인 권장)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. 공식 dry-run 미리보기(스크립트 버전이 파라미터 지원 시)
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. 확인 후 설치
bash /tmp/openhuman-install.sh

# macOS / Linux 원라인(위 3단계와 동일)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  | bash

# Windows PowerShell:
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# App 실행 중인지 확인(OpenHuman 관련 프로세스가 보여야 함)
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep

# Ollama 설치 및 백그라운드 시작(OpenHuman과 별개지만 같은 GPU 공유 가능)
brew install ollama
brew services start ollama

# 작은 모델 pull로 연결 테스트(크기·이름은 필요에 따라)
ollama pull llama3.2

# API 프로브: JSON 반환, models 목록 포함
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo

# GUI: Settings → Models / Providers
#   - 클라우드: Anthropic API Key(sk-ant-...) 또는 OpenAI Key 붙여넣기
#   - 로컬: Base URL http://127.0.0.1:11434, 모델 llama3.2 등

# Key를 shell 기록에 남기지 말 것; CLI 테스트에 env가 필요하면 임시 export:
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# (입력 후 Enter, 터미널 에코 없음; 끝나면 unset ANTHROPIC_API_KEY 가능)

# Anthropic 키 유효성 독립 프로브(OpenHuman과 무관)
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo

# GUI: Connections / Integrations → 순서대로 Connect 클릭
#   권장 순서: Gmail → Google Calendar → GitHub
# 브라우저 OAuth 완료 후 App에 Connected / Active 표시

# 회사 프록시로 콜백 실패 시 HTTPS 아웃바운드 먼저 테스트:
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5

# OpenHuman 5~20분 실행 유지; 메뉴바에서 동기화 상태 확인 가능
# 데이터 디렉터리는 버전마다 다름: App 「Settings → Data / Memory」에서 경로 확인
# 흔히 Application Support 아래, find로 대략 검색(수 초 걸릴 수 있음):
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# Memory Tree 루트가 $MEMORY_DIR이면 최근 Markdown 나열:
# MEMORY_DIR="…/memory"   # 설정 화면 경로로 교체
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# 임의 .md에 실제 주제 행(메일/회의/PR) 있는지 spot check
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"

# 테스트 1 — 캘린더(Google Calendar 연결 전제)
「오늘 회의 제목과 시작 시간을 나열하고, Memory Tree 출처를 인용해 주세요.」

# 테스트 2 — GitHub(GitHub 연결 전제)
「최근 머지된 PR이 있는 저장소는? 저장소명과 PR 제목을 알려 주세요.」

# 실패 시: 답이 뻔하면 6단계로 돌아가 .md 생성 여부 확인

# 오늘 추가된 Markdown 개수
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# 최신 3개 조각 수정 시간
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# 디렉터리 옆 SQLite(파일명은 버전마다 다름), sqlite3로 테이블 확인
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

# macOS 클라우드 호스트 로그인 후
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# GUI 없을 때 일부 버전은 동기 엔진만 실행 가능; 공식 문서 기준
# 권장: VNC/화면 공유로 첫 OAuth 완료 후 세션 로그인 유지

# 뚜껑 닫기 슬립으로 동기 중단 방지(데이터센터 정책에 따라)
sudo pmset -c sleep 0 displaysleep 0

# Homebrew 설치 실패: 캐시 정리 후 재시도
brew update
brew cleanup
brew reinstall openhuman

# 크래시 후 macOS 크래시 로그
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama는 실행 중인데 OpenHuman 연결 안 됨
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# 완전 제거 후 재설치(brew 경로)
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# 공식 저장소 최신 Issue(gh CLI 필요)
gh issue list -R tinyhumansai/openhuman -L 5

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# Web UI만
pnpm dev
# 전체 Tauri 데스크톱 개발
pnpm dev:app
# Rust 측 체크
cargo check -p openhuman --lib