로컬 메모리·100개 이상 연동을 내장한 데스크톱 에이전트
로컬 우선 Memory Tree와 SuperContext, TokenJuice 토큰 압축을 통해 통합된 데스크톱 에이전트를 제공하며 기본 관리형 Composio 백엔드와의 하이브리드 설치를 지원한다.
TL;DR
OpenHuman은 로컬 퍼스트 Memory Tree와 Obsidian 호환 Markdown, 그리고 관리형 Composio 커넥터를 결합해 데스크톱 중심의 에이전트를 제공한다. 데이터는 ≤3k 토큰 청크로 canonicalize되어 SQLite에 계층적 요약 트리로 저장되며 Auto-fetch가 20분 주기로 최신 컨텍스트를 수집하고 SuperContext가 첫 턴부터 관련 컨텍스트 번들을 모델 입력에 미리 붙여 즉시 유의미한 응답을 생성하게 한다. TokenJuice 전처리 레이어는 HTML→Markdown 변환·URL 축약·중복 요약 등을 수행해 LLM에 전달되는 토큰을 최대 80%까지 줄여 비용과 지연을 낮추는 것을 목표로 한다. 기본 설치는 서명된 네이티브 패키지 경로를 권장하며 관리형 백엔드와 로컬 모델 호스팅(Ollama 등)을 혼합해 편의성과 자가호스팅 통제를 모두 제공하지만 AppImage의 Wayland 충돌이나 스크립트 무결성 문제 같은 운영상 고려사항이 존재한다.
주요 기능
- 데스크톱 UI를 통해 간단한 설치와 짧은 온보딩으로 에이전트를 실행하고 데스크톱 마스코트가 음성·미팅 참여 기능을 포함해 사용자 인터랙션을 지속적으로 유지한다. 에이전트의 상태와 설정은 로컬에 저장되며 Obsidian 호환 Markdown으로 편집 가능한 메모리 파일을 제공한다. 마스코트는 실시간 음성 출력과 입 모션 동기화를 포함하는 네이티브 보이스 기능을 지원한다.
- 여러 서비스에 대한 100개 이상의 원클릭 OAuth 커넥터와 5,000개 이상의 MCP 서버 레지스트리, 90,000개 이상의 Skills 카탈로그를 통해 도구 설치와 통합을 자동화한다. 각 연결은 타입화된 도구로 변환되며 에이전트가 필요에 따라 자동으로 도구를 설치하고 호출할 수 있다. 기본 모드에서는 Composio를 통해 OAuth와 통합 호출이 프록시되며 필요 시 직접 모드로 전환해 자체 Composio 키를 사용할 수 있다.
- 문서·이메일·채팅의 내용을 ≤3k 토큰 청크로 canonicalize하고 SQLite에 계층적 요약 트리로 보관하는 Memory Tree를 통해 장기간의 컨텍스트 보존 및 편집이 가능하다. Auto-fetch가 20분 루프로 데이터를 동기화하고 업데이트된 청크는 자동으로 요약되어 메모리로 흡수된다. Obsidian 호환 vault를 통해 외부 편집기에서 직접 메모리를 조작할 수 있다.
- 첫 턴에서 context_scout를 생성해 관련 메모리와 파일을 스윕하고 경계가 정해진 컨텍스트 번들을 조립해 모델 입력 앞에 미리 붙이는 SuperContext를 통해 첫 응답부터 관련 배경을 반영한다. 이 과정은 툴 콜을 기다리는 라운드트립을 생략해 대화 지연을 줄인다. SuperContext는 설정에서 토글 가능하다.
- 도구 호출 전 입력을 TokenJuice 레이어로 전처리해 HTML→Markdown 변환, 긴 URL 축약, 중복 출력 요약 등을 수행함으로써 LLM에 전달되는 토큰을 대폭 축소한다. README에는 최대 80%까지 비용과 지연을 줄인다고 명시되어 있다. 토큰 압축은 CJK와 이모지 같은 멀티바이트 텍스트를 문자 단위로 보존한다.
어떻게 동작하는가
OpenHuman은 로컬 퍼스트 스토리지에 Memory Tree를 SQLite와 Obsidian 호환 Markdown으로 유지하면서 연결된 서비스에서 주기적으로 데이터를 가져와 청크화하고 계층적 요약 트리에 적재한다. 첫 대화 턴마다 context_scout 프로세스가 실행되어 관련 메모리와 파일을 스윕하고 경계가 정해진 컨텍스트 번들을 조립해 모델 입력 앞에 미리 삽입함으로써 라운드트립을 생략한다. 모델 라우팅은 기본적으로 OpenHuman 백엔드를 통해 프록시되며 사용자가 원하면 Ollama 같은 로컬 런타임으로 전환해 모델을 호스팅할 수 있다.
해결 문제
에이전트가 '콜드 스타트' 상태에서 쓸모 있게 되기까지 수일 또는 수주가 걸리는 문제를 해소한다. 연결된 계정과 문서를 20분 간격으로 자동 수집하고 요약 트리에 편입해 첫 대화부터 관련 상황을 반영하게 한다. 이로 인해 별도 플러그인 개발 없이도 다양한 도구와 문맥을 곧바로 활용할 수 있다.
지금 주목받는 이유
레포지토리가 33,376개의 스타를 보유하고 있으며 README에 최신 릴리스와 다국어 문서를 제공하는 등 활발한 커뮤니티 관심과 배포 채널을 갖추고 있다. 에이전트 허니콤 통합과 대규모 커넥터·Skills 카탈로그 같은 실무 친화적 기능이 주목을 받았다. 또한 데스크톱 중심의 로컬 퍼스트 접근과 관리형 백엔드의 하이브리드 모델이 실무자 관심을 유도하고 있다.
차별점
- 로컬 중심의 영구 메모리 표현을 Obsidian 호환 Markdown과 SQLite로 결합해 사용자가 메모리 파일을 직접 열어 편집하고 검증할 수 있도록 설계했다. 많은 경쟁 제품이 클라우드 전용 상태 저장을 택하는 반면 OpenHuman은 로컬 가시성과 통제권을 우선시한다. 이 방식은 프라이버시 제어와 판별 가능한 데이터 소유권 관리를 가능하게 한다.
- Composio 커넥터 레이어를 통해 관리형 OAuth와 MCP 레지스트리 통합을 기본으로 제공하며 대규모 커넥터와 Skills 카탈로그를 원클릭으로 연결할 수 있다. 기본 환경은 관리형 백엔드를 사용해 복잡한 통합을 간소화하며 필요 시 사용자가 직접 Composio 키로 로컬 모드를 구성할 수 있다. 이 하이브리드 설계는 즉시 사용 가능한 통합 편의성과 자가 호스팅 유연성 사이의 균형을 제공한다.
- SuperContext와 TokenJuice를 결합해 첫 응답부터 풍부한 컨텍스트를 전달하면서도 LLM 호출 비용과 지연을 줄이는 두 단계 접근을 채택했다. SuperContext는 컨텍스트 번들을 미리 조립해 툴 콜 라운드트립을 회피하고 TokenJuice는 입력을 압축해 토큰 소모를 낮춘다. 이러한 결합은 초기 응답 품질과 운영 비용을 동시에 개선하는 것을 목표로 한다.
사용 사례
- 개인 작업 흐름에서 이메일, 캘린더, 저장소, 메시징을 한곳에 모아 에이전트가 지속적으로 문맥을 유지하도록 해 빠른 질문에 즉시 답을 얻는 데 활용할 수 있다. Auto-fetch가 20분 간격으로 데이터를 동기화하므로 최신 상태가 유지된 컨텍스트 위에서 에이전트가 동작한다. Obsidian 호환 vault를 통해 수집된 지식을 직접 점검하고 수정할 수 있다.
- 개발팀에서 코드 리뷰, 이슈 추적, PR 요약 등 반복 업무를 자동화하려는 목적으로 사용하면 각 리포지토와 이슈의 핵심 정보를 Memory Tree 청크로 보관해 에이전트가 과거 변경사항을 기억하도록 만들 수 있다. 에이전트는 파일 시스템과 git 도구를 내장해 로컬 환경에서 직접 코드 관련 작업을 수행한다. Skills 카탈로그를 통해 필요한 툴을 온디멘드로 설치해 작업을 확장할 수 있다.
- 개인 비서 역할로 장기 목표와 할일 관리를 결합해 에이전트가 장기 목표에 맞춰 대화 중 우선순위를 유지하고 자동으로 할일을 생성·추적하게 할 수 있다. 각 스레드는 영구 목표를 포함할 수 있으며 에이전트는 토큰 예산을 설정해 자동 연속 실행과 중단을 관리한다. Kanban 보드와 승인 게이트를 통해 사람 중심의 검토와 자동화의 균형을 유지한다.
시작하기
권장 설치 경로는 플랫폼별 네이티브 패키지로, macOS는 Homebrew 탭을 추가해 설치하고 Debian/Ubuntu는 서명된 apt 저장소를 추가한 뒤 openhuman 패키지를 설치하는 방식이다. Windows 사용자는 최신 릴리스의 서명된 MSI를 다운로드해 설치할 수 있고 Arch 사용자는 제공된 AUR 레시피(openhuman-bin)를 통해 설치할 수 있다. README에서는 검증되지 않은 원격 설치 스크립트(curl | bash)를 비권장으로 표기하고 서명 기반 네이티브 패키지를 우선하라고 지시한다.
요구사항
- 데스크톱 클라이언트를 위한 표준 플랫폼 지원으로 macOS, Debian/Ubuntu 계열의 Linux, Arch(AUR), 그리고 Windows용 MSI 설치가 README에 명시되어 있다. 플랫폼별 아티팩트는 OS 패키지 매니저의 서명 체인을 통해 무결성 검증이 가능하도록 제공되며 APK 형식 대신 AppImage 등도 존재한다.
- 로컬 AI 옵션을 사용하려면 Ollama와 같은 지원되는 로컬 런타임을 별도로 설치해 모델을 호스팅할 수 있으며, 기본 모델 라우팅은 OpenHuman 백엔드를 통해 프록시되므로 네트워크 연결과 계정이 필요하다. TTS나 STT 같은 네이티브 보이스 기능은 ElevenLabs 같은 외부 서비스와의 연동을 전제로 하며 해당 서비스 자격증명이 필요하다.
- Linux AppImage는 Wayland 환경에서 충돌 가능성이 있으며 README에서 관련 이슈(#2463)를 참고해 환경변수 기반 우회가 필요함이 명시되어 있다. 스크립트 설치 경로는 서명이 제공되지 않아 무결성 보장이 불가능하므로 보안 정책에 따라 사용을 피하는 것이 권장된다.
벤치마크
| 벤치마크 | 지표 | 값 | 비교 |
|---|---|---|---|
| Token compression | token reduction | up to 80% | — |
| Integrations coverage | connectors / mcp servers / skills | 100+ connectors, 5,000+ MCP servers, 90,000+ Skills | — |
이미지 분석

.png)
35.5k
Stars
3.5k
Forks
+209
Trending
138
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.