2026 OpenHuman 설치 가이드: Homebrew / apt / npm 배포 + Memory Tree 온보딩 + 클라우드 Mac 24/7 운영

OpenHuman은 TinyHumans AI가 GPL-3.0으로 공개한 개인용 AI 슈퍼 어시스턴트입니다. Rust + TypeScript, Tauri v2 데스크톱, SQLite 영속화, 200개 이상 클라우드 모델 라우팅, Ollama / LM Studio 로컬 추론을 지원합니다. 세션마다 사라지는 챗봇이 아니라 연결 계정과 로컬 파일에서 지속적으로 컨텍스트를 수집해 Memory Tree로 Markdown 구조에 정리합니다. 주를 넘긴 습관, 프로젝트 맥락, 연락 우선순위가 여기에 쌓여 이후 추론에 주입됩니다.

설치 성공은 첫 관문에 불과합니다. 사용자는 데스크톱이나 음성으로 어시스턴트에 요청하고, 지난주 결정을 반영한 응답을 기대합니다. 그러려면 설정 디렉터리, SQLite DB, Memory Tree 파일군이 재부팅과 OS 업데이트를 넘어 존속하는 호스트가 필요합니다. 개발용 MacBook에서 아래 절차를 시험하는 것은 문제없지만, 프로덕션 Memory Tree를 절전하는 노트북에 올리는 것은 적절하지 않습니다. 기억 복리 효과가 입증된 단계에서 많은 팀이 동일 설정 tarball을 전용 클라우드 Mac으로 이전합니다.

본 글은 GUI 또는 SSH + VNC, 아웃바운드 HTTPS, OAuth 연동 권한을 전제로 합니다. OpenHuman은 얼리 베타입니다. pin한 버전의 업스트림 문서를 정본으로 삼고, 프로덕션에서는 main을 추적하지 말고 GitHub Releases 검증 빌드를 선택하세요.

커뮤니티 스레드에서 흔한 것은 깨진 설치 스크립트가 아니라 호스트 불일치, Headless Linux에 대한 GUI 기대, 설정 디렉터리의 에페hemeral 배치, 로컬 AI 미옵트인입니다. 아래 표는 Memory Tree를 상시 키울 때 각 플랫폼이 충족해야 할 조건과 전형적 실패 패턴을 대조한 것입니다.

• 설치 경로 선택: Homebrew와 apt는 OS 패키지 서명 체인을 통과합니다. npm은 Node 18+가 필요하며, 첫 설치 시 SHA-256 검증과 함께 네이티브 바이너리를 받습니다. curl 한 줄은 가장 빠르지만, 프로덕션 Mac에서는 Releases DMG 또는 Homebrew를 권장합니다.
• 전용 Unix 사용자: root나 공유 로그인 사용자가 아닌, 고정 Home을 가진 non-root 계정으로 OpenHuman을 실행합니다. OAuth Token과 Memory Tree 권한 복잡화를 막습니다.
• 디스크 설계: 설정 디렉터리, SQLite, Memory Tree, 로그용 별도 영역을 확보합니다. 20GB root 볼륨은 수주간 연동 동기로 가득 차기 쉽습니다.
• 로컬 AI: 기본 비활성입니다. config.toml에서 local_ai.runtime_enabled와 local_ai.opt_in_confirmed를 명시적으로 true로 하지 않으면 Ollama가 떠 있어도 OpenHuman은 클라우드 모델 경로만 사용합니다.
• 스냅샷 정책: Memory Tree는 사용에 따라 성장합니다. 파일럿 중 디스크 스냅샷을 남발하면 주간 축적 선호가 사라집니다. 설정 트리 tarball 백업을 먼저 확립하세요.

어느 경로로든 설치 직후 GUI를 한 번 기동해 버전 표시와 설정 Home 쓰기 권한을 확인하세요. OAuth 연결 실패를 Memory Tree 탓으로 돌리기 전에 네트워크와 디스크 영속성을 먼저 고치면 온보딩 시간을 줄일 수 있습니다.

업스트림은 다섯 공식 경로를 제공합니다. macOS 프로덕션에서는 Homebrew 또는 서명 DMG, Debian 계열 Linux에서는 signed apt repo, CI나 크로스플랫폼 CLI에서는 npm, 감사 중시 팀은 GitHub Releases 직접 다운로드, 최속 검증에는 curl 스크립트가 정석입니다. 아래 6단계는 신규 NUKCLOUD 인스턴스와 깨끗한 Ubuntu 데스크톱 모두에서 검증한 순서입니다.

1. 01
   호스트 준비: macOS에서는 Xcode Command Line Tools를 확인합니다. Ubuntu / Debian에서는 sudo apt update && sudo apt install -y curl gnupg2 ca-certificates를 실행합니다. OpenHuman 전용 사용자를 만들고 Home을 tmpfs가 아닌 영속 디스크에 둡니다.
2. 02
   경로 선택 및 설치: 아래 중 하나를 실행합니다. 프로덕션에서는 pin한 릴리스 태그에 맞춰 Homebrew bottle 또는 apt 패키지 버전을 고정하세요.
3. 03
   바이너리·버전 확인: 앱 또는 openhuman --version으로 CLI 응답을 확인합니다. npm 경로에서는 global bin이 PATH에 있는지 봅니다.
4. 04
   첫 GUI 기동: macOS는 Applications에서, Linux는 데스크톱 엔트리 또는 AppImage에서 시작합니다. Headless 클라우드 Mac은 VNC 또는 화면 공유를 먼저 엽니다.
5. 05
   설정 Home 확인: 마법사가 보여 주는 사용자 설정 디렉터리에 config.toml이 생성되는지 확인합니다. 권한은 전용 사용자만 읽기·쓰기 가능해야 합니다.
6. 06
   베이스라인 기록: macOS 마이너 버전 또는 /etc/os-release, 설치 경로, 설정 디렉터리 경로, 첫 버전을 기록합니다. Memory Tree 연결 전 tarball화해 두면 잘못된 업그레이드로 SQLite가 깨졌을 때 복구할 수 있습니다.

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

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
sudo apt-get update
sudo apt-get install -y openhuman

npm install -g openhuman
openhuman --version

https://github.com/tinyhumansai/openhuman/releases/latest
OpenHuman_*_aarch64.dmg
OpenHuman_*_amd64.deb
OpenHuman_*_amd64.AppImage

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

신규 클라우드 Mac에서는 프로바이더 패널에서 provision하고 SSH Key를 등록한 뒤 VNC를 켠 다음 설치 경로를 고르세요. 프로덕션 SKU를 정할 때는 주문 페이지에서 디스크와 RAM을 먼저 고르고, Memory Tree와 SQLite가 좁은 root 볼륨을 공유하지 않게 합니다. NUKCLOUD 콘솔 Runbook대로 SSH 접속해도 설치 명령은 자택 Mac과 동일합니다.

모델 엔드포인트 없는 OpenHuman은 빈 데스크톱 셸입니다. 설정은 사용자 설정 디렉터리의 config.toml과 OAuth 자격 증명에 둡니다. 파일명과 키는 릴리스마다 바뀔 수 있으므로 pin한 버전 업스트림 문서를 정본으로 유지하세요.

로컬 AI 활성화: 기본은 클라우드 모델 경로만입니다. Ollama 또는 LM Studio를 쓰려면 config.toml에서 명시적으로 옵트인합니다. Ollama는 127.0.0.1:11434에서 먼저 띄우고 설정 UI에서 엔드포인트를 고르세요. OLLAMA_KEEP_ALIVE=-1은 콜드 스타트 억제에 유효합니다.

클라우드 Provider: 200개 이상 모델 slug로 라우팅할 수 있습니다. API Key는 mode 600 env 파일에 두고 설정에서 참조합니다. 가벼운 작업과 추론 작업에 모델을 나누는 model routing이 Memory Tree 주입 비용 최적화에 도움이 됩니다.

영속 경로: 설정 디렉터리, SQLite, Memory Tree 폴더가 영속 볼륨에 있는지 확인합니다. Docker나 에페hemeral VPS 이미지에서는 이 경로를 명시적으로 bind-mount하지 않으면 컨테이너 재생성 시 주간 기억이 리셋됩니다.

local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true

brew install ollama
ollama pull qwen2.5:7b
export OLLAMA_KEEP_ALIVE=-1
ollama serve
curl http://127.0.0.1:11434/api/tags

설정 편집 후 GUI를 재시작해 로컬 모델 목록이 보이는지 확인하세요. 팀이 OpenClaw + Ollama 로컬 Agent도 평가 중이면 OpenHuman은 데스크톱 기억과 SaaS 연동이 강점입니다. 동일 머신 공존은 가능하지만 Ollama 모델 로드와 메모리 경합을 피하려 시간대를 나누거나 모델 크기를 tier로 나누세요. Telegram 프로덕션 게이트웨이가 필요하면 Hermes Agent 설치 글의 launchd 절차를 별도 호스트 또는 별도 사용자로 참고하세요.

Memory Tree는 OpenHuman의 핵심입니다. 첫 마법사에서 데이터 소스를 연결하면 이후 백그라운드 동기가 Markdown 구조로 압축·정리합니다. Gmail, Notion, Slack, GitHub, 캘린더, 로컬 파일 등 팀 실제 워크플로에 맞춰 단계적으로 추가하세요. 한 번에 모든 연동을 켜면 OAuth 실패 분리가 어렵습니다.

첫 온보딩: VNC 또는 화면 공유로 클라우드 Mac에 들어가 GUI 마법사를 완료합니다. 각 SaaS에서 OAuth 동의 화면이 열리므로 Headless SSH만으로는 부족합니다. 연결 성공 후 Memory Tree 뷰에서 노드가 늘어나는지 24시간 안에 확인하세요.

macOS 상주: 로그인 항목 또는 LaunchAgent로 OpenHuman 자동 기동을 설정합니다. WorkingDirectory를 설정 Home에 맞추고 크래시 시 KeepAlive를 켭니다. NUKCLOUD 클라우드 Mac과 자택 Mini 모두 절차는 같습니다.

Linux 데스크톱: systemd user unit으로 GUI 세션 기동 후 OpenHuman을 올립니다. loginctl enable-linger로 SSH 로그아웃 후에도 동기 작업을 유지할 수 있습니다. 순수 VPS는 VNC 데스크톱 스택 구축이 전제입니다.

1. 01
   GUI 첫 기동 → 언어·프라이버시 동의 → 설정 Home 위치 확인.
2. 02
   Memory Tree 마법사에서 Gmail / Notion / Slack을 하나씩 연결하고 OAuth 성공을 각각 확인.
3. 03
   config.toml에서 local_ai 활성화 후 설정 UI에서 Ollama 엔드포인트 선택.
4. 04
   테스트 프롬프트로 「지난주 회의 메모」 회상 가능 여부와 Memory Tree 노드 증분 관측.
5. 05
   launchd 또는 systemd로 상주화하고 의도적 kill 후 30초 이내 재기동·SQLite 존속 확인.
6. 06
   설정 디렉터리 주간 tarball 백업 스케줄. 72시간 안정 후 추가 SaaS 연동 개방.

[Unit]
Description=OpenHuman Desktop Agent
After=graphical-session.target

[Service]
ExecStart=/usr/bin/openhuman
Restart=on-failure
RestartSec=15
Environment=DISPLAY=:0

[Install]
WantedBy=default.target

운영 메모: 첫 1주는 동기 작업 오류, 디스크 증분, OAuth Token 갱신 실패를 매일 확인합니다. 7일 안정 후 설정 트리와 Memory Tree 주간 tarball을 유지하세요. day-two: Releases 페이지 버전 drift, 업그레이드 전 설정 백업, Linux는 journalctl --user -u openhuman.service, macOS는 Console.app 필터.

설치 경로는 의도적으로 크로스플랫폼입니다. 호스팅 선택이 Memory Tree가 주 단위로 자라는지 리셋되는지를 결정합니다. Headless Linux VPS에 curl만 흘려도 OAuth 온보딩과 Tauri GUI가 빠져 프로덕션 Memory Tree에는 맞지 않습니다. 자택 Mac mini는 전원과 ISP를 통제할 수 있을 때 유효합니다. 엔터프라이즈 팀은 VNC 도달성과 문서화된 테넌트 경계를 가진 클라우드 Mac을 고르는 경우가 많습니다.

하드 구매 전 Memory Tree 복리를 검증하려는 팀에게 NUKCLOUD 종량제 클라우드 Mac은 캐시플로를 유지하면서 동기 품질과 디스크 영속성을 측정할 수 있습니다. 범용 분 단위 macOS VPS는 CPU oversell로 동기 작업 중 GUI가 죽기 쉽습니다. Memory Tree가 프로덕션급이면 월 10달러 절약보다 안정 디스크·예측 가능한 아웃바운드·재기동 내성이 더 중요해집니다.