OpenHuman 설치부터 동작 확인까지,
어디서 막히나: 2026 설치·설정 가이드

0 개요:0에서 동작 확인까지 7단계

막히면 먼저 단계를 가리킵니다: 다운로드 → 설치 → 로그인 → 모델 → 연동 → 메모리 → 첫 출력. 아래 표가 지도이고, 이후 절에서 자세히 다룹니다.

1 설치 전 준비:시스템·네트워크·계정·테스트 데이터

공식 Getting Started에 따르면 OpenHuman은 macOS·Windows·Linux 데스크톱에서 동작하며 RAM 4GB 이상을 권장합니다. 대용량 메일함·저장소나 같은 PC에서 로컬 모델을 쓸 계획이면 16GB 이상을 권장합니다.

• 네트워크 — tinyhumans.ai/openhuman과 GitBook 문서에 접속 가능해야 합니다. 기본 경로는 호스트형 로그인·모델 라우팅을 사용하므로 완전 오프라인은 아닙니다.
• 계정 — Google/GitHub 로그인을 준비하세요. 서드파티 연동은 별도 OAuth가 필요하며, 앱 로그인만으로 Gmail이 연결되지 않습니다.
• 테스트 데이터 — 민감도가 낮은 메일함·여분 GitHub 계정으로 메모리 기록을 검증하세요. 첫날부터 업무용 전체 받은편지함을 연결하지 마세요.
• 로컬 모델(선택) — Ollama를 쓸 계획이면 OpenHuman에서 Local AI를 켜기 전에 터미널에서 ollama run이 성공하는지 확인하세요.

2 다운로드 출처:잘못된 프로젝트·버전을 잡는 법

성공 기준: tinyhumans.ai/openhuman 또는 공식 패키지 채널의 설치 파일 · 정보(About) 버전이 최신 GitHub Release와 일치.

공식 경로(하나 선택):

• 웹사이트 설치 파일 — macOS DMG, Windows MSI/EXE, Linux AppImage 또는 .deb(초보자에게 가장 명확).
• Homebrew — brew install tinyhumansai/openhuman/openhuman
• 스크립트 설치 — macOS/Linux: curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash · Windows는 README의 PowerShell. 주력 PC에서는 원격 셸 파이프보다 서명된 사이트 다운로드를 우선하세요.

3 플랫폼별 설치:Mac·Windows·Linux 통과 기준

첫 실행 시 macOS가 손쉬운 사용·입력 모니터링(음성 단축키)을 요청할 수 있습니다. Settings → Automation & Channels에서 검토하고, 첫 동작 확인에 불필요한 권한은 거절해도 됩니다.

4 첫 실행:로그인·작업 공간·실행 안 됨

환영 화면은 「Sign in! Let's Cook」 소셜 로그인입니다. 대부분 Advanced custom core RPC URL은 무시해도 됩니다.

성공 기준: 채팅·Settings가 있는 메인 UI. 막혔을 때: 확장 프로그램이 OAuth 차단 → Safari/Edge 비공개 창 · 로그인은 되는데 백화면 → 완전 종료 후 재실행 · 앱 내 로그/진단(Settings, 버전마다 위치 상이).

5 모델 설정:기본 라우팅·BYOK·로컬 무응답

OpenHuman은 작업마다 Automatic Model Routing을 사용합니다. 초보자는 먼저 클라우드 라우팅 응답을 확인한 뒤 Local AI를 켜세요.

성공 기준: 「안녕」 또는 「한 문장으로 자기소개」에 정상 응답. 막혔을 때:

• 전혀 응답 없음 — 네트워크/프록시 · Early Beta 장애(Discord/GitHub Issues 확인).
• BYOK 실패 — Key 전체 붙여넣기, provider와 설정 일치, 계정 할당량.
• Ollama / LM Studio 무응답 — 터미널에서 로컬 서비스 먼저 확인 · Settings에서 Local AI 활성화 및 GitBook Configuration의 local_ai.runtime_enabled 확인.

6 연동 권한:OAuth·범위·새로고침

Settings에서 Gmail, GitHub, 캘린더 등을 연결합니다. 성공 기준: 목록에 연결됨 표시, 지속 오류 없음.

막혔을 때: 연결됐는데 데이터 없음 → 읽기·가져오기 권한 포함 여부 · Google Workspace는 관리자 승인 필요할 수 있음 · 갱신 없음 → 첫 auto-fetch 주기 약 20분 대기(문서 기준)—몇 분 만에 재설치하지 마세요.

7 메모리 동기화:빈 맥락·검증 방법

메모리는 로컬 Memory Tree(SQLite + Markdown)에 저장됩니다. Memory → View vault in Obsidian(/wiki/)로 볼트를 엽니다.

성공 기준: Gmail 연결 후 약 20분 내 Memory에 새 항목 · 「지난 12시간에 알아야 할 것」 질문에 실제 제목이 인용됨.

막혔을 때: 계속 비어 있음 → OAuth 실제 성공, 테스트 계정에 메일 존재, 첫 주기 미완료 · 요약이 이상함 → Obsidian 원문으로 모델 환각 vs 소스 누락 구분.

8 첫 실전 작업:설정을 한 번에 검증

공식 예시처럼 시도해 보세요: 「오늘 놓친 것을 요약해 줘.」 또는 「연결된 소스에서 오늘 할 일 상위 3개를 적어 줘.」

통과 기준: ① 모델 응답 · ② 응답 사실이 Memory/Obsidian에 존재 · ③ 프로젝트명 등 좁힌 후속 질문도 맞음. ②만 실패 → 메모리 경로 · ①만 → 모델 · 둘 다 → 로그인·네트워크.

9 마무리:재설치 시점·설정 보존

재설치 전 문서/Issues 확인: OAuth 한 건 실패, 연동 하나, 로컬 Ollama만 문제면 앱 전체 재설치가 보통 필요 없습니다. 패키지 손상, 메이저 클린 업그레이드, Release notes 지시 시에 재설치하세요.

데이터 보존: Memory Tree와 Markdown 볼트는 디스크에 있습니다—Memory 화면의 볼트 경로를 기록하고, 제거 전 해당 폴더를 백업하세요(알 수 없는 디렉터리는 삭제하지 마세요). 제거: Homebrew는 brew uninstall openhuman · Debian/Ubuntu는 apt remove · curl 설치는 GitHub docs/install.md 참고.

여전히 막힘 → GitHub Issues, Release notes, Discord(discord.tinyhumans.ai)에 버전·재현 절차를 첨부하세요.

10 Mac mini에서 OpenHuman을 더 안정적으로

OpenHuman은 백그라운드 auto-fetch, SQLite 쓰기, 선택적 Ollama 추론을 수행합니다. Mac mini M4의 통합 메모리는 소형 로컬 모델에 적합하고, 대기 전력 약 4W로 24시간 무소음 운영에 맞습니다. macOS에서는 Homebrew 설치, 권한 대화상자, Obsidian 볼트 접근이 수월합니다. 개인 Memory Tree를 전용 mini에 두면 일상용 Mac과 분리할 수 있습니다. 개인 Agent 실험용 머신을 고민 중이라면 Mac mini M4는 가성비 좋은 출발점입니다—먼저 여기서 흐름을 통과한 뒤, 상시 가동 Mac mini 노드로 옮기세요. 지금이 Mac mini M4를 검토하기 좋은 시점입니다.