OpenHuman 초보 어떻게 시작하나:
2026 설치부터 데이터 소스 연결 Q&A

OAuth, BYOK, Memory Tree를 처음 보면 어지럽습니다. 최소 경로만 먼저 통과하면 되고, 아키텍처 문서를 끝까지 읽을 필요는 없습니다.

Q도대체 뭘 설치하는 건가요?

A: 웹사이트도 SDK도 아닙니다. 데스크톱 앱 + 로컬 Agent로, OAuth로 Gmail·Notion·GitHub 등을 연결해 데이터를 내 Mac의 메모리 트리와 Markdown vault(Obsidian으로 열 수 있음)에 쌓습니다. 기억은 로컬이지만, 채팅·일부 OAuth는 클라우드를 탈 수 있습니다. 로컬 우선 ≠ 완전 오프라인입니다. 지금 할 일: tinyhumans 버전인지 확인한 뒤 설치.

Q설치 전 준비물? 어떤 파일을 받나요?

A: 매일 쓰는 Mac/PC, 인터넷, 수 GB 디스크, Gmail 등 OAuth 읽기 권한에 대한 이해가 필요합니다. 초보는 공식 DMG/EXE가 안전합니다. 터미널은 공식 install.sh도 있으나, 메인 머신은 스크립트를 먼저 읽거나 설치 패키지만 쓰세요. 지금 할 일: 설치 후 로그인 화면까지 진행.

QOS가 막는 이유는?

A: macOS Gatekeeper와 Windows SmartScreen은 스토어 밖 앱을 차단합니다. 「개인 정보 보호 및 보안」에서 열기를 선택하고, 공식 사이트 패키지만 쓰며 Release 버전을 대조하세요. 지금 할 일: 차단을 통과한 뒤 앱 실행.

Q로그인 뒤에 또 뭘 하나요?

A: OAuth 로그인은 「누구인지·구독 여부」만 확인합니다. 기본 대화·연동 프록시는 호스팅 백엔드를 쓸 수 있습니다. 이어서 ① 모델 선택 ② Integrations에서 Connect. 지금 할 일: 로그인 → 모델 → 연동 순서. 아직 채팅은 보류.

Q모델은 어떻게 고르나요? API Key 필수인가요?

A: 필수는 아닙니다. BYOK(Bring Your Own Key)는 클라우드 키를 직접 넣어 쓰는 방식(종량 과금). 구독 + TokenJuice로 컨텍스트를 압축해 토큰을 줄일 수도 있고, Ollama는 로컬 추론입니다. M 시리즈 Mac은 24GB+ RAM이 더 안정적입니다. 키는 Git에 넣지 마세요. 「안녕」 한 마디로 모델을 검증하세요. 지금 할 일: 과금 방식 하나 정하고 모델 통과 확인.

Q연동은 왜 또 따로 승인하나요?

A: 앱 로그인과 Gmail 연결은 OAuth가 두 번입니다. 권한 범위가 다르고, 언제든 끊을 수 있습니다. 118+ 커넥터 중 auto-fetch 자동 입고는 Gmail·Notion·Slack 등이 대표이며, 나머지는 공식 GitBook 기준입니다. 지금 할 일: Gmail + 익숙한 소스 하나만 먼저 연결.

Q기억은 언제 보이나요?

A: 활성 연동은 약 20분마다 가져와 저장합니다. 첫 라운드는 한 주기를 채울 때까지 기다리는 경우가 많습니다. 검증: 독특한 제목의 테스트 메일 발송 → 20~40분 대기 → vault에서 제목 검색 → Agent에게 세부 인용 요청. 지금 할 일: 이 네 단계로 확인.

Q첫 작업과 실패 시 어떻게 보나요?

A: 읽기 전용 요약부터, 예: 「Gmail에서 ○○ 프로젝트 최근 메일 3통 요약」. 실패 시 순서대로: 앱/버전 → 로그인·모델 → 연동 Expired 여부 → 20분 대기·vault에 새 .md → 잘못된 계정 연결 → GitHub Issues. 비용은 구독·BYOK·Ollama 리소스를 구분하세요. 지금 할 일: 읽기 전용 Q&A 한 번 통과 후 연동 확장.

추Mac mini에서 OpenHuman 상시 운영

기억 DB와 auto-fetch는 조용히 24시간 켜 두기에 맞습니다. Mac mini M4 통합 메모리는 Ollama에 유리하고, macOS SIP·FileVault는 개인 맥락 보관에 적합하며, 대기 전력은 약 4W 수준입니다. Agent가 7×24로 기억을 쌓게 하려면 Mac mini M4가 비용 대비 좋은 출발점입니다. 지금 구성을 알아보세요.