macOS Homebrew · Memory Tree · 118+ OAuth · 흔한 오류 10선 · VNC 원격 Mac 검수
OpenHuman은 tinyhumansai가 만든 오픈소스 데스크톱 개인 AI Agent입니다. 단순 채팅창이 아니라 기억·도구·연동·음성을 하나의 로컬 지능층으로 묶는 제품입니다. 2026년 5월 v0.56.0이 나왔고 GitHub Star는 3만을 넘었습니다. 본문은 macOS Homebrew 설치(권장), 첫 실행·LLM 설정, Memory Tree 연동, 118+ OAuth 통합, 흔한 오류 10선, VNC 원격 Mac 20분 검수를 다룹니다. OpenClaw·OpenHuman 배포 글·Hermes Agent 설치 글과 함께 읽으면 좋습니다.
OpenHuman은 「Personal AI super intelligence」를 표방합니다. OpenClaw(터미널·BYO 모델)나 Hermes Agent(역시 터미널 중심)와 달리 데스크톱 GUI 우선입니다. 말하는 마스코트가 화면에 떠 있고, 키보드를 멈춰도 백그라운드에서 맥락을 감지합니다.
기술 스택은 Rust + Tauri + React, 라이선스는 GNU GPL-3.0입니다. 최신 안정판 v0.56.0(2026-05-27)은 Early Beta로 기능 변화가 잦습니다. 업그레이드 전 Release Notes를 확인하세요.
| 비교 항목 | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| 오픈소스 | ✅ GPL-3.0 | ✅ MIT | ✅ MIT | 🚫 독점 |
| UI | ✅ 데스크톱 GUI | ⚠️ 터미널 우선 | ⚠️ 터미널 우선 | ✅ 데스크톱+CLI |
| 기억 | ✅ Memory Tree + Obsidian | ⚠️ 플러그인 의존 | ✅ 3층 메모리 | ✅ 세션 단위 |
| 서드파티 연동 | ✅ 118+ OAuth | ⚠️ 직접 연결 | ⚠️ 직접 연결 | ⚠️ 소수 |
| 자동 동기화 | ✅ 약 20분마다 | 🚫 없음 | 🚫 없음 | 🚫 없음 |
| 모델 라우팅 | ✅ 내장(TokenJuice) | ⚠️ 수동 | ⚠️ 수동 | 🚫 단일 |
터미널 환경을 피하고 AI가 일상 워크플로를 이해하기를 원한다면 OpenHuman의 GUI와 118+ 커넥터가 강점입니다. 반면 그래픽 UI에 의존하므로 SSH만으로는 OAuth·권한 팝업에서 막힙니다. 여기서 VNC 원격 Mac이 필요합니다.
일반 사용자(바이너리 설치)는 macOS 12 Monterey 이상(14 Sonoma·15 Sequoia 권장)과 Homebrew 또는 .dmg만 있으면 됩니다. 소스 빌드는 Node.js 24+, pnpm 10.10.0, Rust 1.93.0, CMake, Xcode CLT가 필요합니다.
중요: OpenHuman은 Tauri(WebKit)로 UI를 그리고 AI 추론은 LLM API·Ollama가 처리합니다. 본기 GPU는 불필요합니다. Apple M1–M4 모두 무난하고, Memory Tree 사용 시 RAM 16GB를 권장합니다.
디스크는 앱 본체 150–200MB, Memory Tree DB는 초기 500MB에서 장기 2–5GB까지 늘 수 있습니다. 로컬 Ollama 소형 모델은 모델당 2–8GB를 더 잡아먹습니다.
설치 방법은 Homebrew tap(권장), 공식 .dmg, curl 스크립트(비권장), 소스 빌드(개발자) 네 가지입니다. 아래는 Homebrew 절차입니다.
Homebrew 확인: 터미널에서 brew --version을 실행합니다. 없으면 공식 스크립트로 설치하세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 중 Xcode Command Line Tools 팝업이 뜹니다. VNC 데스크톱에서 「설치」를 눌러야 SSH만으로는 처리할 수 없습니다.
tap 추가 후 설치:
brew tap tinyhumansai/core brew install openhuman
완료 후 OpenHuman.app이 ~/Applications에 생깁니다.
첫 실행·접근성 권한: Spotlight(⌘+Space)로 OpenHuman을 엽니다. 접근성·알림 권한을 시스템 설정에서 허용하세요.
Onboarding·LLM: Claude, GPT-4o/mini, Gemini, Grok, Ollama 중 선택하고 API Key 또는 TokenJuice를 설정합니다. Memory Tree를 살리려면 긴 컨텍스트 모델(Claude Sonnet 등)을 권장합니다.
OAuth 118+ 연동: Settings → Integrations에서 Gmail, GitHub, Notion, Slack 등을 연결합니다. 브라우저 OAuth는 그래픽 데스크톱에서만 완료됩니다.
Memory Tree 활성화: Settings → Memory → Memory Tree에서 Enable. 첫 동기화는 10–25분 걸릴 수 있습니다. 앱을 강제 종료하지 마세요.
첫 대화 검증: 「어제 보낸 메일 요약해줘」(Gmail 연동 시)처럼 Memory Tree 맥락이 담긴 답이 오면 성공입니다.
tinyhumans.ai/openhuman 또는 GitHub Releases에서 Apple Silicon은 arm64, Intel은 x86_64 .dmg를 받아 Applications로 드래그합니다. Gatekeeper 경고 시 「개인정보 보호 및 보안」에서 「그래도 열기」를 선택하세요.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
공식 문서는 스크립트 변조를 검증할 수 없다고 경고합니다. 꼭 쓸 경우 -o install.sh로 저장해 내용을 확인한 뒤 실행하세요.
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
첫 Tauri 네이티브 빌드는 5–15분 걸릴 수 있습니다. M4 Pro는 3–5분 수준입니다.
Memory Tree는 세션 메모리가 아니라 여러 소스를 하나의 검색 가능한 개인 지식 그래프로 묶습니다. 메일·PR·문서·캘린더 요약이 약 20분마다 증분 갱신됩니다.
Settings → Memory → Memory Tree에서 최소 5분(기본 20분) 간격과 Gmail 최근 90일 같은 범위를 조절할 수 있습니다. 범위가 넓을수록 첫 동기화는 느리지만 회수 정확도는 올라갑니다.
Settings → Memory → Local Sources에 Vault 루트를 추가하면 Markdown 변경을 감지해 벡터 인덱스를 갱신합니다. Vault 읽기는 읽기 전용이며 .md 파일은 수정하지 않습니다.
Integrations에서 키워드(label:payroll 등)를 제외하거나 Local Sources에서 .private/ 디렉터리를 빼세요. DB는 ~/.openhuman/memory/에 있어 백업·이전이 쉽습니다.
| # | 증상 | 원인 | 해결 |
|---|---|---|---|
| 1 | brew install 404·tap 실패 | Formula URL 변경·네트워크 | brew update 또는 .dmg로 전환 |
| 2 | WebKit process terminated | macOS 12 미만·캐시 손상 | ~/Library/WebKit/tinyhumansai 삭제 후 재시작 |
| 3 | 접근성 팝업이 사라짐 | TCC 미등록 | 시스템 설정에서 OpenHuman 수동 추가 |
| 4 | OAuth 콜백 실패 | 포트 58080–58090 점유 | 기본 브라우저 변경·포트 확인 |
| 5 | Memory Tree 0% 정체 | 토큰 만료·네트워크 | Integrations에서 재승인 |
| 6 | API Key invalid | 키 오입력·잔액 | Settings → LLM Test Connection |
| 7 | 자동 업데이트 실패 | 비 Homebrew 설치 권한 | brew upgrade openhuman |
| 8 | 마스코트 미표시 | 디스플레이 배율·접근성 | 기본 Retina 배율·권한 재확인 |
| 9 | Obsidian 감시 무효 | 경로 공백·디스크 접근 | 경로 따옴표·완전 디스크 접근 허용 |
| 10 | 음성·마이크 무응답 | 마이크 권한 | 개인정보 보호 → 마이크에 OpenHuman 추가 |
추가 문제는 ~/Library/Logs/tinyhumansai/ 로그와 GitHub Issues를 확인하세요. Early Beta 특성상 버전마다 UI 문구가 바뀔 수 있으니, 스크린샷보다 로그 타임스탬프를 증거로 남기는 편이 재현에 유리합니다.
OpenHuman 초기 설정은 GUI가 필수입니다. SSH만으로는 다음을 처리할 수 없습니다.
VNC 접속: VNC Viewer 등으로 VNCMac 노드에 연결합니다. 해상도 1440×900 이상을 권장합니다.
Homebrew + OpenHuman: VNC 데스크톱 Terminal에서 03절 1–2단계를 실행합니다. CLT 팝업은 VNC에서 「설치」를 누르세요.
권한 일괄 허용: ~/Applications/OpenHuman.app을 실행하고 접근성·알림·완전 디스크 접근을 모두 허용합니다.
LLM·OAuth: VNC 브라우저에서 Google/GitHub OAuth를 완료합니다. Safari 또는 Chrome이 기본 브라우저여야 콜백이 돌아옵니다.
Memory Tree 검증: Settings → Memory 진행률이 완료(녹색 체크)되면 「최근 가장 활발한 GitHub repo는?」처럼 맥락 답변을 확인합니다.
5단계 후 OpenHuman은 7×24 통합 데이터를 감지할 수 있습니다. 로컬 Windows/Linux에서도 VNC로 들어와 대화만 이어가면 재설정이 필요 없습니다.
됩니다. UI는 Tauri(WebKit)이고 추론은 LLM API·Ollama가 담당합니다. Apple Silicon ANE는 Ollama에 도움이 될 수 있으나 필수는 아닙니다.
승인한 커넥터 데이터를 벡터화해 로컬 그래프에 씁니다. 10–25분이 보통이며 데이터량·네트워크에 따라 달라집니다.
공식은 Homebrew tap·서명 .dmg를 권장합니다. 스크립트는 다운로드 후 내용 검토 없이 파이프 실행하지 마세요.
Claude, OpenAI GPT, Gemini, Grok, Ollama. TokenJuice로 청구 통합도 가능합니다. Settings → LLM에서 Test Connection으로 검증하세요.
권한 팝업·OAuth·Memory 진행률은 VNC GUI가 필요합니다. brew upgrade 같은 일상 CLI는 SSH로 충분합니다.
OpenHuman은 GUI로 Agent 진입 장벽을 낮추고, Memory Tree로 업무 맥락을 AI에 넘기며, 118+ OAuth로 디지털 조각을 한곳에 모읍니다. 대가는 그래픽 데스크톱에 대한 지속 의존입니다.
Windows·Linux가 주력이거나 헤드리스 Mac에서 7×24 돌리려면 SSH만으로는 첫 설정에서 막힙니다. 집에 Mac mini를 두는 방법도 있지만 감가·전기·정전 리스크가 따릅니다. VNC가 있는 임대 원격 Mac은 GUI 권한·OAuth·Memory 검수를 upfront 없이 처리할 수 있어 「상주 개인 AI」로 쓰는 개발자가 VNCMac을 고르는 이유입니다.