OpenHuman 소개
OpenHuman은 데스크톱에서 동작하는 에이전트형(agentic) AI 어시스턴트로, 메일·캘린더·문서·코드 도구를 한 자리에서 다루는 것을 목표로 합니다. 프로젝트는 자신을 "open-source agentic assistant designed to integrate with you in your daily life" 라고 소개하면서, "Personal AI super intelligence: local memory, managed services where needed, simple and powerful" 라는 한 줄로 핵심 콘셉트를 정리하고 있습니다.
OpenHuman의 가장 큰 차별점은 두 가지 저장 계층의 조합 입니다. 사용자가 연결한 외부 서비스의 데이터를 약 3,000 토큰 이하의 Markdown 청크로 정규화한 뒤, SQLite에 저장되는 계층적 요약 트리(memory tree)와 Obsidian과 호환되는 Markdown 볼트(Obsidian Wiki)에 동시에 보관합니다. 메모리 트리는 LLM이 빠르게 훑을 수 있는 형태이고, Obsidian 볼트는 사람이 직접 열어 보고 편집할 수 있는 형태입니다. 프로젝트는 이 구조가 Andrej Karpathy가 공유한 obsidian-wiki 워크플로우에서 영감을 받았다고 밝히고 있습니다.
기본 동작은 OpenHuman 측이 관리하는 백엔드(계정 로그인, 모델 라우팅, 웹 검색 프록시, OAuth/Composio 커넥터)에 의존하지만, 사용자가 자신의 모델·검색·Composio 자격증명을 직접 설정해 custom/local 모드 로 옮길 수 있습니다. 다만 실시간 트리거나 일부 hosted 기능은 managed 백엔드에 남아 있다고 본문 상단에서 명시하고 있습니다. 저장소는 "Early Beta — Under active development. Expect rough edges" 라는 안내가 함께 붙어 있는 활발한 개발 단계 프로젝트입니다.
OpenHuman의 동작 방식
OpenHuman은 연결된 메일·문서·메시지·코드 저장소를 자동 수집해 요약·압축한 뒤, 메모리 그래프 형태로 묶어 에이전트가 즉시 참조하도록 만듭니다. 다음 다이어그램은 외부 데이터가 어떻게 단일한 컨텍스트로 응축되는지를 한눈에 보여줍니다.
이 흐름의 핵심은 "context in minutes, not weeks" 라는 구호로 요약됩니다. 다른 에이전트가 사용자 스택을 학습하는 데 며칠에서 몇 주가 걸리는 반면, OpenHuman은 auto-fetch 루프가 20분마다 활성 커넥션을 한 번씩 돌면서 받은 데이터를 메모리 트리로 흘려보내고, 같은 청크가 Obsidian Wiki에도 .md 파일로 저장됩니다. 한 번의 동기화 패스만으로 에이전트가 받은 메일·캘린더·저장소·문서·메시지의 압축된 전체 컨텍스트를 갖춘다는 것이 OpenHuman의 설계 의도입니다.
이미 agentmemory를 다른 코딩 에이전트와 함께 셀프 호스팅하고 있다면, config.toml 에서 memory.backend = "agentmemory" 로 설정해 Claude Code, Cursor, Codex, OpenCode와 동일한 영속 메모리 저장소를 공유할 수 있습니다. 자세한 절차는 agentmemory 백엔드 가이드에 정리되어 있습니다.
OpenHuman의 주요 기능
OpenHuman의 기능은 다섯 가지 축으로 정리할 수 있습니다.
- 데스크톱 우선 UX와 마스코트 (Simple, UI-first & Human): 터미널이나 설정 파일 없이 설치 후 몇 번의 클릭으로 동작하는 GUI 어시스턴트를 지향합니다. 화면에 떠 있는 마스코트는 음성으로 응답하고, Google Meets에 실제 참가자처럼 합류하며, 사용자의 입력이 멈춘 뒤에도 백그라운드에서 사고를 이어 갑니다.
- 118개 이상의 서드파티 통합과 자동 수집: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira 등에 원클릭 OAuth로 연결합니다. 모든 연결은 타입이 부여된 도구(typed tool)로 노출되며, 코어가 20분마다 활성 커넥션을 순회하면서 최신 데이터를 메모리 트리에 추가합니다. 통합은 Composio 커넥터 계층을 거치며, 직접 호스팅하고 싶으면 자체 Composio API 키로 direct 모드를 설정할 수 있습니다.
- 메모리 트리와 Obsidian Wiki: 연결한 데이터를 약 3,000 토큰 이하의 Markdown 청크로 정규화한 뒤, 점수화하고 계층적 요약 트리로 접어 SQLite에 저장합니다. 같은 청크는 Obsidian 호환 볼트에
.md파일로도 저장되어 사용자가 직접 열어 편집할 수 있습니다. - TokenJuice 토큰 압축: HTML을 Markdown으로 변환하고, 긴 URL을 축약하며, 도구 출력의 중복을 규칙 기반으로 정리하는 압축 계층을 LLM 호출 직전에 일괄 적용합니다. CJK·이모지 같은 멀티바이트 텍스트는 grapheme 단위로 보존되며, 프로젝트는 "Reducing cost & latency by up to 80%" 라는 효과를 함께 안내합니다.
- 모델 라우팅과 메시징 채널: 기본적으로 OpenHuman 백엔드의 모델 라우팅이 reasoning, fast, vision 워크로드별로 적절한 LLM을 골라 프록시합니다. 한 개의 구독으로 여러 모델을 한꺼번에 쓰는 구조이며, 지원되는 워크로드에 한해 Ollama 기반 로컬 AI를 선택적으로 켤 수 있습니다. 메시징 채널은 사용자가 이미 쓰는 채널로 inbound/outbound를 처리하면서 워크플로우 데이터를 디바이스에 암호화해 보관합니다.
여기에 더해 웹 검색, 웹 페이지 스크레이퍼, 파일시스템·git·lint·test·grep 코딩 도구, STT/ElevenLabs TTS와 마스코트 립싱크가 결합된 네이티브 음성 도구가 기본 탑재되어 있습니다. 더 자세한 도구 카탈로그는 네이티브 도구 문서에서 확인할 수 있습니다.
OpenHuman의 설치 및 사용법
저장소는 OS 패키지 매니저의 서명 체인을 거치는 네이티브 패키지 경로 를 권장합니다. Homebrew bottle 해시, 서명된 apt 저장소, 서명된 MSI를 통한 무결성 검증이 가능한 경로입니다.
# macOS (Homebrew tap)
brew tap tinyhumansai/openhuman
brew install openhuman
# Linux (Debian / Ubuntu — signed apt repo)
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 openhuman
Arch Linux에서는 저장소의 packages/arch/openhuman-bin AUR 레시피가 준비되어 있어 공개 후 yay -S openhuman-bin 으로 설치할 수 있습니다. Windows에서는 GitHub Releases 페이지에서 서명된 .msi 를 받아 실행합니다. curl … | bash 또는 irm … | iex 스크립트 설치 경로도 제공되지만, 별도 서명이 함께 배포되지 않아 스크립트 바이트 변조를 탐지할 수 없다는 경고가 함께 붙어 있고, 네이티브 패키지를 우선 권장합니다.
소스 빌드로 기여하려면 Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0(rustfmt + clippy), CMake, Ninja, ripgrep과 플랫폼별 데스크톱 빌드 도구가 필요합니다. 포크 후 git submodule update --init --recursive 로 Tauri/CEF 서브모듈을 받은 다음 pnpm install 을 실행하고, 웹 UI 작업은 pnpm dev, 데스크톱 셸은 pnpm --filter openhuman-app dev:app 으로 띄울 수 있습니다. PR 전 검사는 pnpm typecheck, pnpm format:check, cargo check -p openhuman --lib 조합이 권장됩니다. 자세한 절차는 저장소의 CONTRIBUTING.md와 CONTRIBUTING-BEGINNERS.md에 정리되어 있습니다.
OpenHuman과 다른 에이전트 하니스 비교
저장소는 자신을 다른 에이전트 하니스와 비교하며 벤더 분산 최소화, 온디바이스 워크플로우 지식, 데이터에 대한 영속 메모리 를 차별점으로 내세웁니다. 다음 표는 저장소의 비교 섹션을 그대로 옮긴 것입니다.
| Claude Cowork | OpenClaw | Hermes Agent | OpenHuman | |
|---|---|---|---|---|
| 오픈소스 | Proprietary | MIT | MIT | GNU GPL-3.0 |
| 시작 난이도 | Desktop + CLI | Terminal-first | Terminal-first | Clean UI, minutes |
| 비용 구조 | Sub + add-ons | BYO models | BYO models | One sub + TokenJuice |
| 메모리 | Chat-scoped | Plugin-reliant | Self-learning | Memory Tree + Obsidian vault |
| 통합 | Few connectors | BYO | BYO | 118+ via OAuth |
| 자동 수집 | 없음 | 없음 | 없음 | 20-min sync |
| API 키 분산 | Extra keys | BYOK | Multi-vendor | One account |
| 모델 라우팅 | 단일 모델 | 수동 | 수동 | 빌트인 |
| 네이티브 도구 | 코드만 | 코드만 | 코드만 | 코드 + 검색 + 스크레이퍼 + 음성 |
비교 표의 평가는 OpenHuman 측의 시각이라는 점은 감안하되, 자동 수집·모델 라우팅·OAuth 통합 수에서 차별점이 분명하다는 점은 README의 일관된 주장입니다.
OpenHuman의 라이선스
OpenHuman은 GNU General Public License v3.0(GPL-3.0) 라이선스로 공개되어 있습니다. 파생 저작물을 배포할 때도 동일한 GPL-3.0 라이선스로 소스 코드를 공개해야 한다는 강한 카피레프트(copyleft) 조건이 따르므로, 사내 도구나 상용 서비스에 통합할 계획이 있다면 LICENSE 파일과 GPL-3.0 본문을 먼저 검토하기를 권장합니다.
더 읽어보기
- OpenHuman 공식 홈페이지 — 데스크톱 설치 파일 및 제품 소개
- OpenHuman 공식 문서(GitBook) — 메모리 트리, Obsidian Wiki, TokenJuice 등 기능별 상세 가이드
- OpenHuman GitHub 저장소 — 소스 코드, 릴리스, 이슈 트래커
- Andrej Karpathy의 obsidian-wiki 트윗 — OpenHuman의 메모리 트리 설계가 영감을 받은 원 출처
- agentmemory GitHub 저장소 — OpenHuman이 선택적으로 사용하는 외부 메모리 백엔드
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 