OpenHuman(TinyHumans AI 오픈소스)은 데스크톱 우선 개인 AI Agent입니다. Gmail, 캘린더, GitHub 등을 연결하면 Memory Tree와 Obsidian 호환 Markdown 볼트로 컨텍스트를 로컬 SQLite에 남기고, Ollama로 선택적 로컬 추론도 사용할 수 있습니다. 「OpenHuman 설치」를 검색하면 오래된 Python 클론 튜토리얼에 빠지기 쉽지만, 2026년 공식 경로는 Homebrew / apt / 서명 설치 패키지이며 pip install -r requirements.txt가 아닙니다.
본 글은 macOS, Windows, Linux에서 처음부터 OpenHuman을 가동하려는 초보자와 개발자를 위한 것입니다. 설치 pain point와 호스트 대조를 정리한 뒤 네이티브 패키지 설치 → 첫 실행 → 계정·연동 → Ollama → Memory Tree 검증 → 7×24 호스트 6단계 체크리스트를 제공합니다. 읽은 후 데이터 디렉터리를 로컬 Mac에 둘지, 절전하지 않는 Mac mini에 둘지 판단할 수 있어야 합니다.
01 설치 전 알아야 할 과제: 「git clone + pip」 경로가 아닙니다
OpenHuman은 Rust + Tauri + React로 패키징된 데스크톱 앱(GPL-3.0, Early Beta)입니다. OpenClaw(터미널 Gateway + Node 생태계)나 Hermes Agent(설치기가 Python/Node를 ~/.hermes/에 배치)와 달리 일반 사용자가 Python 환경을 직접 빌드할 필요는 없습니다. 소스 기여 시에만 Node 24+, pnpm, Rust 등 툴체인이 필요합니다.
- 낡은 튜토리얼: 일부 「디지털 휴먼」 글은
conda create,checkpoints/*.pth를 언급하지만 다른 프로젝트 템플릿이며 tinyhumansai/openhuman과 무관합니다. - 스크립트 설치의 서명 부재: 공식 README는
curl … | bash로 스크립트 변조를 감지할 수 없다고 경고하며, 프로덕션에서는 Homebrew bottle / 서명 apt / MSI를 우선해야 합니다. - 매니지드와 로컬 공존: Memory Tree와 워크스페이스는 로컬에 있지만 기본 로그인, 모델 라우팅, 일부 OAuth는 OpenHuman 매니지드 백엔드를 거칩니다. 완전 오프라인은 BYO 모델과 Composio 직접 모드 전환이 필요합니다.
- 덮개 닫으면 동기 끊김: 약 20분 주기 auto-fetch와 백그라운드 기억 압축은 호스트가 깨어 있어야 하며, 노트북 절전은 컨텍스트 동기를 중단합니다.
- Linux Wayland: AppImage는 일부 Wayland 환경에서 기동에 실패할 수 있으므로 Debian/Ubuntu 사용자는 .deb / apt를 우선하세요(공식 issue #2463).
결론: 설치 자체는 10여 분 안에 끝날 수 있습니다. 장기 경험은 호스트가 7×24 온라인인지, 로컬 vault와 SQLite를 백업·이전할 수 있는지에 달려 있습니다.
설치 명령과 동작은 TinyHumans 공식 문서가 기준입니다. 릴리스마다 아래 링크를 다시 확인하세요.
02 환경 요건과 배포 호스트 대조: 어느 머신이 가장 수월한가
공식은 macOS(Intel / Apple Silicon), Windows 10/11, Linux(Debian/Ubuntu amd64, Arch AUR) 설치 패키지를 제공합니다. 아래 표는 선정용이며, 디스크와 메모리는 선택한 Ollama 모델 크기에 맞추세요.
| 호스트 | 7×24 가용성 | 설치 마찰 | Memory Tree / Ollama | 전형적 약점 |
|---|---|---|---|---|
| MacBook 로컬 | 덮개·절전 시 끊김 | 낮음(Homebrew / .dmg) | Apple Silicon + Ollama 양호 | auto-fetch 중단, OS 업데이트 재부팅 |
| Windows 데스크톱 | 상시 가동 가능, 재부팅 잦음 | 낮음(서명 MSI) | NVIDIA 로컬 모델 선택 | macOS 툴체인과 불일치 |
| Linux 데스크톱 / 헤드리스 | 서버급 온라인률 | 중간(apt가 AppImage보다 안정) | Ollama 공식 Linux 지원 | GUI 없을 때 배포판 확인 필요 |
| Mac mini M4 월 렌탈 베어메탈 | DC SLA, 장기 온라인 | 낮음(SSH + brew) | 통합 메모리로 7B–14B급 | 신뢰 DC·계약 기간 선정 |
리소스 참고(Ollama 로컬 병행): 매니지드 모델 + 가벼운 연동만이면 8 GB 메모리로 시험 가능합니다. Qwen2.5 / Gemma3 7B급을 상주하고 브라우저 도구를 쓰면 16 GB 이상 통합 메모리 또는 RAM을 권장합니다. 로컬 데이터(Memory Tree, vault, SQLite)에는 10–30 GB SSD를 확보하고 메일·저장소 동기량에 따라 늘리세요.
03 공식 설치 경로: Homebrew, apt, Release 선택법
권장 순서: 공식 사이트 또는 GitHub Releases에서 플랫폼 패키지를 받거나, 서명 체인이 있는 시스템 패키지 관리자를 사용합니다. 패키지 관리자를 쓸 수 없을 때만 스크립트 설치를 고려하세요.
macOS(Homebrew, 공식 권장):
brew tap tinyhumansai/core
brew install openhuman
openhuman --versionDebian / Ubuntu(서명 apt 저장소):
sudo apt-get install -y --no-install-recommends 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 openhumanWindows: GitHub Releases에서 서명 .msi를 받아 설치합니다.
대안(무결성 검증 없음, 신중히): 공식 README 스크립트 설치. 릴리스 후 GPG 검증 절차(issue #2620) 공개 여부를 저장소에서 확인하세요.
04 6단계 롤아웃: 첫 실행, 연동, Ollama, Memory Tree 검증
- 설치 완료 및 앱 실행: Launchpad 또는 앱 메뉴에서 OpenHuman을 엽니다. CLI가 PATH에 있으면
openhuman --version으로 버전을 확인합니다(Releases 페이지 현재 tag 기준). - 온보딩과 계정: UI에 따라 onboarding을 마칩니다. 기본 매니지드 경험은 모델 라우팅과 일부 OAuth를 위해 OpenHuman 계정 로그인이 필요합니다. 순수 로컬 실험은 설정에서 BYO / Ollama로 전환합니다(공식 Local AI 문서 참조).
- Ollama 설치·기동(선택적 로컬 추론): macOS / Linux에 Ollama를 설치하고 문서 권장 모델(Qwen2.5, Gemma3 등, gitbook 기준)을 pull한 뒤 OpenHuman 모델 라우팅에서 로컬 엔드포인트를 선택합니다.
- 1–2개 데이터 소스로 스모크 테스트: GitHub나 캘린더 등 낮은 민감도 연동을 먼저 연결하고 약 20분 auto-fetch 주기를 기다려 Memory Tree에 새 Markdown 청크가 생기는지 봅니다.
- Memory Tree와 vault 검증: 앱에서 Memory Tree / Obsidian 호환 디렉터리를 열어 SQLite와
.md파일이 늘어나는지 확인합니다. 비어 있으면 무작정 재설치하지 말고 연동 권한과 네트워크를 점검하세요. - 7×24 호스트 계획: 종일 auto-fetch와 메시지 채널이 필요하면 절전 비활성 Mac mini(로컬 또는 CALMVPS 베어메탈)로 옮기고, 워크스페이스와 설정 디렉터리 전체를 tarball 백업한 뒤 머신을 전환합니다.
CALMVPS 베어메탈 Mac 배포 시 요금 페이지에서 M4 메모리와 리전을 고른 뒤 SSH 접속 후 로컬과 동일한 brew install openhuman을 실행합니다. 해지 전 OpenHuman 로컬 데이터 디렉터리(Memory Tree / vault 포함)를 아카이브하세요.
05 인용 가능 사양, 흔한 오류, CALMVPS 시나리오 정리
- 기술 스택: Rust + Tauri v2 + React 데스크톱 셸. Memory Tree는 로컬 SQLite를 쓰며 약 ≤3k token 청크를 Markdown에 기록합니다(공식 README / gitbook).
- 동기 리듬: 활성 연동은 기본 약 20분마다 auto-fetch로 컨텍스트를 가져옵니다(문서 기준, 실시간 push 아님).
- TokenJuice: 도구 출력과 웹 스크랩은 모델 투입 전 압축되며, 공식은 최대 약 80% token 절감을 제시합니다(작업 유형에 따라 다르며 청구는 직접 관측하세요).
| 현상 | 흔한 원인 | 조치 |
|---|---|---|
| pip/conda 가이드 실패 | 다른 프로젝트 문서 오용 | Homebrew / apt / Release 설치 패키지로 전환 |
| Linux AppImage 즉시 종료 | Wayland / sharun 호환 | .deb 또는 문서 환경 변수 우회 |
| Ollama 무응답 | 서비스 미기동 또는 모델 미 pull | ollama serve + ollama pull <model> |
| Memory Tree 계속 비어 있음 | 연동 미승인 또는 fetch 주기 미도달 | OAuth 확인 및 20분 주기 대기 |
FAQ 요약: 전용 GPU 없이도 동작합니다. 매니지드 모델 경로는 GPU 필수가 아닙니다. 로컬 Ollama는 Apple Silicon에서 CPU만 쓰는 Windows보다 부드러운 경우가 많습니다. Mac M 시리즈는 arm64 설치 패키지와 arm64 Ollama 모델을 우선하세요. 모델 다운로드가 느리면 네트워크를 바꾸거나 DC 측 Mac에서 미리 ollama pull하세요.
OpenHuman을 자주 덮개를 닫는 노트북에 두면 auto-fetch 연속성과 Memory Tree 복리가 약점입니다. 저가 해외 VPS에는 공식 데스크톱 경험과 GUI 유지 비용이 부족합니다. 백업 없이 설치하면 머신 교체 시 컨텍스트를 잃습니다. 네이티브 서명 설치, Ollama 로컬 추론, 20분 기억 동기, 통합 메모리 빠른 증설이 필요한 프로덕션에서는 CALMVPS 베어메탈 Mac mini M4 월 렌탈이 보통 더 나은 선택입니다. SSH로 바로 사용하고 Apple Silicon을 단독 점유하며 월 단위로 유연히 계약할 수 있습니다. 기종과 계약 기간은 CALMVPS 요금 페이지를 참고하세요.