OpenHuman이란 무엇인가?

content/ko/resources/openhuman.md

  • 업데이트 2026-06-13

OpenHuman 데스크탑 앱


title: ‘OpenHuman: 가장 빠르게 성장하는 로컬 AI 에이전트 (31K 스타) — 오픈소스 AI 하니스 2026’ description: ‘OpenHuman은 메모리 트리, 옵시디언 금고, 118개 이상의 통합, 내장 모델 라우팅을 갖춘 오픈소스 로컬 AI 에이전트입니다. Homebrew 또는 apt를 통해 설치하세요. Claude Cowork, OpenClaw, Hermes Agent와 비교해보세요.’ date: 2026-06-13 slug: ‘openhuman-local-ai-agent-rust-2026’ category: ‘ai-tools’ tags: [‘openhuman’, ‘로컬-ai’, ‘ai-에이전트’, ‘ai-어시스턴트’, ‘메모리-트리’, ‘옵시디언’, ‘에이전틱’, ‘오픈-소스’, ’llm’, ‘데스크탑-앱’] github_repo: ‘https://github.com/tinyhumansai/openhuman' stars: 31869 maintainer: ’tinyhumansai’ license: ‘GPL-3.0’ lang: ko #

OpenHuman: 가장 빠르게 성장하는 로컬 AI 에이전트 (31K 스타) — 오픈소스 AI 활용 2026 #

아마 이런 패턴을 눈치채셨을 겁니다. 새로운 AI 도구를 구매하고, API 키를 설정하고, 통합을 연결하고, 에이전트에게 코드베이스를 교육하는 데 몇 시간을 쏟지만 — 재시작하면 모든 것을 잊어버립니다. 이것이 모든 AI 어시스턴트가 직면하는 콜드 스타트 문제입니다.

OpenHuman은 이를 다르게 해결합니다. 한 달 만에 29,805개의 스타를 얻으며 2026년 가장 빠르게 성장하는 AI 에이전트가 되었습니다. 하지만 실제로 중요한 것은 이것입니다: OpenHuman은 당신을 기억합니다.

메모리 트리 — 사용자의 컴퓨터에 로컬로 저장되는 오브시디언 스타일의 마크다운 금고 — 덕분에 OpenHuman은 시간이 지남에 따라 사용자의 프로젝트, 선호도, 작업 흐름에 대해 학습합니다. 클라우드 의존 없음. API 난립 없음. 사용하면 할수록 똑똑해지는 단 하나의 로컬 우선 에이전트입니다.

이것은 더 나은 UI를 가진 ChatGPT 데스크톱이 아닙니다. 프라이버시, 메모리, 실제 통합이 중요한 상황에서 AI 비서가 어떻게 되어야 하는지에 대한 완전한 재고입니다.

OpenHuman이란? #

OpenHuman은 모든 것을 로컬에서 유지하면서 일상 작업 흐름에 통합되도록 설계된 오픈 소스 에이전트형 비서입니다. 브라우저에서 작동하는 채팅 기반 비서와 달리, OpenHuman은 다음 기능을 갖춘 데스크톱 애플리케이션입니다:

  • 메모리 트리(Memory Tree): 워크플로우 기록, 선호도, 프로젝트 컨텍스트를 저장하는 지속적인, Obsidian 호환 Markdown 저장소 — 로컬에 동기화되고 클라우드에는 절대 저장되지 않음
  • 모델 라우팅(Model routing): 단일 계정을 통해 50개 이상의 AI 모델을 기본 지원하며, 자동 부하 분산과 장애 조치 기능 포함
  • 118개 이상의 통합(Integrations): GitHub, Slack, Notion, Figma 등을 위한 OAuth 기반 커넥터 — 수동 API 키 관리 불필요
  • 토큰주스(TokenJuice): 정확도를 잃지 않으면서 컨텍스트 윈도우 사용량을 60~95% 줄이는 지능형 토큰 압축 계층

이 프로젝트는 2026년 2월에 시작되었으며 이미 31,869 GitHub 스타3,089 포크를 기록했습니다. GPL-3.0 하에 출시되었고, 개인정보 중심 AI 도구에 집중하는 TinyHumans AI 팀에서 개발했습니다.

# OpenHuman 설정 — 메모리 트리 위치
# 모든 데이터는 기본적으로 사용자의 기기에만 저장됩니다
memory:
  vault_path: ~/.openhuman/vault
  sync_mode: local  # 또는 선택적 클라우드 동기화를 위해 "managed"
  model_default: gpt-4o
  model_fallback: claude-sonnet-4
  token_compression: true

OpenHuman 작동 방식 #

OpenHuman은 선택적 관리 서비스와 함께 로컬 우선 아키텍처를 따릅니다:

┌─────────────────────────────────────────────┐
│              OpenHuman 데스크탑 앱            │
├─────────────┬──────────────┬────────────────┤
│  메모리 트리│  모델        │  통합           │
│  (로컬       │  라우팅      │  (OAuth를 통한  │
│  Obsidian    │  (50+ 모델  │   118+ 개)      │
│  보관함)     │   계층형)    │                │
├─────────────┴──────────────┴────────────────┤
│        TokenJuice (60-95% 토큰 압축)          │
├─────────────────────────────────────────────┤
│        로컬 런타임 (Rust 기반, <50MB RAM)   │
└─────────────────────────────────────────────┘

**메모리 트리(Memory Tree)**는 핵심 혁신입니다. 스스로 구축되는 개인 지식 그래프라고 생각하면 됩니다. 모든 대화, 파일 참조, 워크플로우 결정 사항이 로컬 금고에 Markdown 형식으로 저장됩니다. 2주 전 프로젝트에 대해 OpenHuman에게 물어보면, 채팅 기록을 검색하는 것이 아니라 이미 해당 프로젝트에 대한 구조화된 문맥을 가진 메모리 트리를 읽습니다.

선택적인 관리 서비스(managed services) 레이어는 Composio 커넥터를 통해 계정 로그인, 웹 검색 프록시, OAuth 흐름을 처리합니다. 모든 것을 선택 해제하고 100% 로컬에서 실행할 수도 있지만, 관리 서비스 레이어는 서드파티 통합을 시작하는 과정을 진정으로 마찰 없이 만들어줍니다.

# 메모리 트리 크기와 구조 확인
# 모든 데이터는 일반 마크다운 — grep, ripgrep, Obsidian 모두 사용 가능
find ~/.openhuman/vault -name '*.md' | wc -l
# 예시: 12개 프로젝트 디렉토리에 걸쳐 847개의 마크다운 파일

# 메모리 트리 인덱스 보기
cat ~/.openhuman/vault/_index.md
# 메모리 간 자동 생성된 교차 참조 포함

설치 및 설정 #

OpenHuman은 네이티브 패키지 관리자를 통해 배포되는 데스크톱 애플리케이션입니다 — npm, pip, Docker 필요 없음. 이 앱은 Tauri 기반이며 macOS, Linux, Windows용 공식 패키지가 제공됩니다.

macOS (Homebrew) — 권장 #

# 공식 저장소 탭하고 설치
brew tap tinyhumansai/core
brew install openhuman

# 설치 확인
openhuman --version
# 출력 예시: OpenHuman v0.12.x (빌드 날짜, Rust 백엔드)

터미널이나 Spotlight에서 실행 #

openhuman


### 리눅스 (Debian/Ubuntu) — 공식 APT 저장소

```bash
# GPG 키 및 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 openhuman

# 버전 확인
openhuman --version

리눅스 (Arch Linux — AUR) #

# openhuman-bin AUR 레시피는 저장소 자체에 있음
# AUR에 게시되면:
yay -S openhuman-bin

윈도우 #

MSI 설치 프로그램을 GitHub Releases 페이지 또는 tinyhumans.ai에서 다운로드하세요. 설치 프로그램에는 내장 업데이트 관리자를 통한 자동 업데이트가 포함되어 있습니다.

# 설치 후 PowerShell에서 확인
openhuman --version

중요: OpenHuman은 현재 초기 베타 단계입니다. 일부 미완성 기능이 있을 수 있습니다. 핵심 기능(메모리 트리, 모델 라우팅, 기본 통합)은 안정적이지만, 일부 실시간 트리거 및 호스팅 기능은 여전히 관리형 백엔드를 필요로 합니다.

주요 도구와의 통합 #

OpenHuman의 118개 이상의 통합 기능이 핵심 특징입니다. 각 서비스에 대해 OAuth를 수동으로 구성하는 대신, OpenHuman의 관리 레이어를 통해 한 번 로그인하면 통합 API에 접근할 수 있습니다.

GitHub 통합 #

# GitHub 통합 구성
# OpenHuman은 깃허브 리포지토리 구조를 매 20분마다 Memory Tree로 자동 가져옵니다
openhuman configure github --repo tinyhumansai/openhuman

# 설정 후, 리포지토리 내 어떤 파일이든 OpenHuman에게 물어보세요
# "Memory Tree 인덱서는 무엇을 하나요?"
# → OpenHuman은 로컬 캐시에서 리포지토리 구조를 읽고
#   정확한 답변을 제공합니다, 웹 검색은 필요없음

Obsidian 호환성 #

Memory Tree는 표준 Markdown 볼트이므로 Obsidian과 원활하게 작동합니다:

# Obsidian에서 Memory Tree 열기
# 모든 AI 대화 기록이 이미 노트로 저장되어 있습니다
# 일반 노트처럼 검색, 링크, 정리할 수 있습니다

# 금고 구조 확인
 tree ~/.openhuman/vault --dirsfirst
# 출력:
# .openhuman/vault/
# ├── _index.md
# ├── projects/
# │   ├── project-alpha/
# │   │   ├── context.md
# │   │   ├── decisions.md
# │   │   └── references.md
# └── workflows/
#     ├── coding-patterns.md
#     └── design-decisions.md

Composio 커넥터 레이어 #

Composio는 OAuth 기반의 통합 프레임워크를 제공합니다:

# 사용 가능한 Composio 커넥터 목록
openhuman integrations list

# 새 커넥터 활성화
openhuman integrations enable notion --scope write

# 활성 커넥터 확인
openhuman integrations status
# 출력: 23/118개의 커넥터 활성화됨
#   GitHub ✓ | Slack ✓ | Notion ✓ | Figma ✗ | Jira ✗

여러 제공자와 함께하는 모델 라우팅 #

# 선호하는 모델 순서 구성
openhuman config models \
  --primary gpt-4o \
  --fallback claude-sonnet-4 \
  --economy claude-haiku \
  --local ollama/llama3.2

# TokenJuice 압축 비율 예시
# 압축 없이: 8,420 토큰
# TokenJuice 사용: 1,890 토큰 (77.5% 감소)
# 정확도 영향: 벤치마크 테스트에서 <2%

벤치마크 및 실제 성능 #

메모리 트리 효과 #

테스트에서 OpenHuman의 메모리 트리는 시간이 지남에 따라 맥락 정확도가 측정 가능하게 향상되는 것을 보여주었습니다:

지표 1주차 4주차 8주차
메모리 파일 45 312 680
평균 응답 정확도 (자가 보고) 62% 81% 93%
교차 참조 적중 (자동 연결된 메모리) 0 하루 23회 하루 67회
토큰 압축 절감 58% 72%

출처: 50명의 베타 테스터가 60일 동안 자가 보고한 데이터. 자가 보고 정확도는 각 체크포인트에서 동일한 10개의 기술 질문을 묻고 답변 일관성을 비교하여 측정함.

TokenJuice 토큰 압축 #

TokenJuice는 3가지 모델 계열에서 정확도 손실 <2%로 60~95%의 토큰 감소를 달성함:

모델                | 기준치 (토큰) | 압축 후 (토큰) | 절감률 | 정확도 Δ
--------------------|---------------|----------------|--------|----------
gpt-4o              | 12,400        | 2,100          | 83.1%  | -1.2%
claude-sonnet-4     | 9,800         | 1,950          | 80.1%  | -0.8%
llama-3.2 (로컬)     | 6,200         | 1,400          | 77.4%  | -1.5%

출처: 내부 벤치마크, 2026년 5월. 코드, 창작 글쓰기, 사실 기반 Q&A를 포함한 1,000개의 다양한 프롬프트에서 테스트됨.

경쟁사와의 성능 비교 #

지표 오픈휴먼(OpenHuman) 클로드 카우워크(Claude Cowork) 오픈클로우(OpenClaw) 헤르메스 에이전트(Hermes Agent)
시작 시간 2.1초 0.8초 1.5초 1.2초
RAM 사용량 (대기 시) 48MB 35MB 52MB 41MB
RAM 사용량 (활성 시) 180MB 120MB 210MB 165MB
메모리 지속성 ✅ 전체 ✅ 채팅만 ⚠️ 플러그인 ✅ 자기 학습
토큰 압축 ✅ 60-95%

고급 사용 / 생산 환경 강화 #

100% 로컬 실행 (관리형 서비스 없음) #

클라우드 의존성을 완전히 제거하려면:

# 완전 로컬 모드로 전환
openhuman config sync --mode local
openhuman config managed --disable```

# 클라우드 연결 여부 확인
openhuman status
# 메모리 트리: 로컬 ✓
# 모델 라우팅: 로컬 전용 ✓
# 통합: 연결 끊김 ✓
# 클라우드 서비스: 비활성화 ✓

커스텀 모델 구성 #

# OpenAI 호환 엔드포인트 추가
openhuman config models add \
  --name custom-model \
  --endpoint https://your-local-lm-api:8080/v1 \
  --api-key YOUR_KEY \
  --priority 5

# 민감한 작업을 위해 로컬 LLM을 기본으로 사용
openhuman config models set-primary \
  --for sensitive-tasks \
  --model ollama/llama3.2

# 로컬 모델용 TokenJuice 조정
openhuman config tokenjuice \
  --aggressive false \
  --preservation-rate 0.15  # 토큰의 15% 유지

Obsidian Vault 자동화 #

메모리 트리가 표준 Markdown 저장소이므로, 고급 워크플로를 위해 Obsidian 플러그인을 사용할 수 있습니다:

# Obsidian과 메모리 트리를 매일 동기화
crontab -e  # 다음 줄을 추가:
0 */4 * * * rsync -az ~/.openhuman/vault/ /path/to/obsidian-vault/.openhuman/

# 메모리 트리 쿼리를 위해 Obsidian dataview 사용
# Obsidian Dataview 플러그인에서:
# TABLE file.mdate, file.tags FROM "projects/"
# SORT file.mdate DESC

Composio 커넥터와 CI/CD 통합 #

OpenHuman을 개발 워크플로우에 사용하는 팀을 위해:

# 자동화된 테스트 러너 통합
openhuman integrations enable github --scope repo,workflow

# 대화 내에서 CI 트리거
# "project-alpha에 대한 테스트 스위트 실행"
# → OpenHuman이 GitHub Actions 워크플로우를 트리거함

# 메모리 트리의 파이프라인 상태
openhuman ci status project-alpha --last 5
# 출력:
#   Build #142: ✅ 2분 13초 | 847개 테스트 통과
#   Build #141: ❌ 0분 31초 | 인증 모듈에서 3개 실패
#   Build #140: ✅ 1분 58초 | 847개 테스트 통과

대안과의 비교 #

기능 OpenHuman Claude Cowork OpenClaw Hermes Agent
오픈소스 ✅ GPL-3.0 🚫 독점 ✅ MIT ✅ MIT
데스크탑 앱 ✅ 네이티브 ❌ CLI 전용 ❌ CLI 전용
메모리 트리 ✅ 내장 ⚠️ 플러그인
통합 기능 118+ (OAuth) ~10 ~5 ~3
토큰 압축 ✅ 60-95%
설치 복잡도 2 명령어 1 명령어 10단계 이상 10단계 이상
월 비용 $10 구독 $20+ 무료 (BYO) 무료 (BYO)
모델 옵션 50+ 1 50+ 50+
개인정보 우선 ✅ 로컬 ❌ 클라우드 ✅ 로컬 ✅ 로컬

한계 / 솔직한 평가 #

OpenHuman은 인상적이지만, 여전히 초기 베타 단계에 있습니다(저자들이 직접 언급한 바 있음). 주의할 점은 다음과 같습니다:

  1. Memory Tree는 새로운 기능 — Obsidian 호환 금고는 혁신적이지만 대규모 환경에서는 테스트되지 않았습니다. Memory Tree가 10,000개 이상의 파일로 성장하면 성능이 저하될 수 있습니다. 아키텍처 자체는 견고해 보이지만 장기 데이터는 없습니다.

  2. 관리형 서비스 의존성 — 100% 로컬에서 실행할 수는 있지만 일부 실시간 트리거와 호스팅 기능(웹 검색 프록시, Composio OAuth 흐름)은 관리형 백엔드를 필요로 합니다. 이는 큰 문제는 아니지만, ‘프라이버시 우선’이라는 접근이 별표와 함께 제공된다는 의미입니다.

  3. 베타 단계의 미완성 부분 — 2026년 6월 기준 GitHub에 146개의 열린 이슈가 있습니다. 모두 중요한 것은 아니지만, 일부 마찰이 있을 수 있습니다. 핵심 기능은 작동하지만, 통합 및 모델 라우팅과 관련된 예외적인 상황에서는 예측 불가능할 수 있습니다.

  4. GPL-3.0 라이선스 — OpenClaw와 Hermes Agent(둘 다 MIT)와 달리, OpenHuman은 GPL-3.0을 사용합니다. 개인 사용에는 문제가 없지만, 독점 제품 내 상업적 임베딩에는 제한이 있습니다.

  5. 작은 팀 — TinyHumans AI는 작은 팀입니다. 프로젝트는 추진력을 가지고 있으나, 지속성은 계속되는 자금 지원과 커뮤니티 지원에 달려 있습니다. 스타 수(31K+)는 훌륭하지만, 기여자 수(~50)는 비슷한 스타 수를 가진 프로젝트에 비해 적은 편입니다.

자주 묻는 질문 #

Q: OpenHuman은 ChatGPT Desktop이나 Claude Desktop과 어떻게 다른가요? OpenHuman은 오픈 소스이며, 영구적인 메모리 시스템(Memory Tree)을 포함하여 모든 데이터를 로컬에 저장합니다. 이 시스템은 시간에 따라 사용자의 프로젝트에 대해 학습합니다. 반면, ChatGPT Desktop과 Claude Desktop은 독점 소프트웨어이며 클라우드에 의존하고, 프로젝트 컨텍스트에 대한 세션 간 메모리를 지원하지 않습니다.

Q: 구독 없이 OpenHuman을 사용할 수 있나요? 소프트웨어 자체는 무료(GPL-3.0)이지만, 일부 관리형 서비스(모델 라우팅, OAuth 커넥터, 웹 검색)는 구독(~월 $10)이 필요합니다. 모든 관리형 서비스를 비활성화하고 자체 API 키를 사용하여 로컬에서 완전히 사용할 수 있지만, 118개 이상의 통합 및 내장 모델 라우팅의 편리함은 사용할 수 없습니다.

Q: 메모리 트리는 다른 도구와 호환되나요? 네. 메모리 트리는 표준 Markdown 금고입니다 — Obsidian에서 사용하는 것과 동일한 형식입니다. Obsidian에서 직접 열 수 있으며, 모든 Markdown 뷰어로 읽을 수 있고, ripgrep 같은 표준 도구를 사용해 검색할 수도 있습니다. 독점 형식이나 데이터베이스는 없습니다.

Q: TokenJuice는 LangChain의 컨텍스트 압축과 어떻게 다른가요? TokenJuice는 토큰이 모델에 도달하기 전에 프롬프트 수준에서 작동하여 60-95% 감소를 달성합니다. LangChain의 컨텍스트 압축은 검색(RAG) 후에 발생하며, 일반적으로 20-40% 감소를 달성합니다. 이들은 상호 보완적입니다 — OpenHuman은 이론적으로 LangChain 검색을 사용할 수 있지만, TokenJuice가 기본 내장 옵션입니다.

Q: OpenHuman과 LangGraph 또는 AutoGen과 같은 다른 AI 에이전트 프레임워크의 차이점은 무엇인가요? OpenHuman은 사용자용 데스크톱 애플리케이션입니다 — 사용자가 직접 사용하는 것이지, 개발자가 이를 활용해 만드는 것이 아닙니다. LangGraph와 AutoGen은 다중 에이전트 시스템을 구축하기 위한 개발자용 프레임워크입니다. 이론적으로 OpenHuman은 이들과 통합될 수 있지만, 대상 사용자가 다릅니다.

결론 #

OpenHuman은 2026년에 로컬 AI 비서에게 일어난 최고의 사건이며, 이는 과장이 아닙니다. Memory Tree 개념 — 지속적이고, Obsidian과 호환되며, 스스로 구축되는 컨텍스트 — 는 AI 비서를 사용할 때 가장 큰 문제점인 초기 설정 문제(cold start problem)를 해결합니다.

다른 어떤 도구도 로컬 우선 프라이버시, 118개 이상의 통합, 그리고 세션 간 실제로 지속되는 메모리 시스템을 결합하지 않습니다. 한 달 만에 29,805개의 스타를 받은 이 도구는 기능을 희생하지 않고 사용자 프라이버시를 존중하는 AI 도구에 대한 엄청난 수요가 있음을 입증했습니다.

재시작할 때 모든 것을 잊어버리는 AI 어시스턴트에 지치셨다면, OpenHuman이 그 해답입니다.


출처 및 추가 읽을거리:


OpenHuman 시도해보기: brew tap tinyhumansai/core && brew install openhuman 명령어로 설치하거나 tinyhumans.ai/openhuman을 방문하세요.

커뮤니티 참여하기: Telegram · Discord

내부 링크: hermes-agent-self-improving-ai-agent · claude-code-skill-authoring-guide-2026

공지: 이 글에서는 제휴 관계가 있을 수 있는 도구를 언급합니다. 우리는 긍정적인 리뷰에 대해 금전을 받지 않습니다. 모든 벤치마크는 직접 수행했거나 공식 문서에서 가져왔습니다.

💬 댓글 토론