tinyhumansai/openhuman

OpenHuman은 개인 AI 슈퍼 인텔리전스입니다: 로컬 메모리, 필요한 곳에서 관리형 서비스, 간단하고 강력합니다.

초기 베타: 활발히 개발 중입니다. 거친 부분이 있을 수 있습니다.

로컬 + 관리형 서비스, 미리 공개: OpenHuman은 메모리 트리, Obsidian 스타일의 Markdown 볼트, 작업 공간 구성 및 로컬 런타임 상태를 사용자 기기에 저장합니다. 기본 관리형 환경은 여전히 계정 로그인, 모델 라우팅, 웹 검색 프록시, Composio 커넥터 계층을 통한 관리형 통합/OAuth 흐름에 OpenHuman 호스팅 서비스를 사용합니다. 자체 모델, 검색 또는 Composio 자격 증명을 사용하려면 사용자 지정/로컬 설정을 선택하십시오. 일부 실시간 트리거 및 호스팅 기능은 여전히 관리형 백엔드가 필요합니다.

설치

tinyhumans.ai/openhuman 또는 GitHub Releases 페이지에서 설치 프로그램을 다운로드하십시오. 터미널 설치의 경우 아래 기본 패키지 경로가 선호됩니다. OS 패키지 관리자의 서명 체인을 사용합니다.

권장 설치 (기본 패키지)

이 경로는 OS 패키지 관리자의 서명 체인(Homebrew bottle 해시, 서명된 apt 저장소, MSI 서명)을 통해 아티팩트를 확인합니다.

macOS (Homebrew tap):

brew tap tinyhumansai/core
brew install openhuman

Linux (Debian/Ubuntu — 서명된 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

Linux (Arch — AUR): openhuman-bin AUR 레시피가 저장소에 있습니다. 게시되면 Arch 사용자는 yay -S openhuman-bin으로 설치할 수 있습니다.

Windows: 최신 릴리스에서 서명된 .msi를 다운로드하여 실행하십시오.

수동 .dmg / .deb / .AppImage / .msi: 최신 릴리스 페이지에서 플랫폼에 맞는 설치 프로그램을 직접 가져오십시오.

Linux: AppImage는 Wayland에서 (그리고 sharun: Interpreter not found! 오류가 있는 Arch 기반 배포판에서) 시작 시 충돌할 수 있습니다. 원인과 환경 변수 해결 방법은 #2463을 참조하십시오. 위의 .deb 패키지는 Debian/Ubuntu에서 이러한 실패 모드를 피합니다.

대안: 스크립트 설치 (무결성 검사 없음)

경고 — 확인되지 않은 설치. 이 스크립트는 raw.githubusercontent.com에서 실시간으로 제공되며 별도의 서명을 제공하지 않으므로 curl … | bash 및 irm … | iex는 스크립트 바이트 변조를 감지할 방법이 없습니다. 가능하면 위의 기본 패키지 경로를 선호하십시오. 스크립트를 사용해야 하는 경우 "확인된 스크립트 설치"를 참조하십시오.

# macOS 또는 Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

확인된 스크립트 설치 상태

별도로 서명된 스크립트 설치 경로는 현재 사용할 수 없습니다. 기본 패키지 경로가 승격된 후 #2620 이슈가 종료되었지만, 현재 릴리스 자산에는 사전 실행 스크립트 확인을 위한 install.sh.asc / install.ps1.asc가 포함되어 있지 않습니다. 스크립트 설치 경로를 확인되지 않은 것으로 간주하고 가능하면 위의 기본 패키지 옵션을 선호하십시오.

OpenHuman이란 무엇인가?

OpenHuman은 일상 생활에서 당신과 통합되도록 설계된 오픈 소스 에이전트 어시스턴트입니다. 각 항목은 문서의 자세한 설명으로 연결됩니다.

• 간단하고 UI 우선이며 인간적인 깔끔한 데스크톱 경험과 짧은 온보딩 경로를 통해 설치에서 작동하는 에이전트까지 몇 번의 클릭으로 완료할 수 있습니다. 구성 우선 설정이나 터미널이 필요하지 않습니다. 에이전트에는 얼굴이 있습니다: 말하고, 주변 환경에 반응하고, Google Meet에 실제 참가자로 참여하고, 몇 주 동안 당신을 기억하며, 입력을 중단한 후에도 백그라운드에서 계속 생각하는 데스크톱 마스코트입니다.

• 100개 이상의 원클릭 OAuth 통합, 5,000개 이상의 MCP 서버, 90,000개 이상의 스킬: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira 및 나머지 스택에 원클릭 OAuth로 연결하십시오. Composio 계층을 통해 중개되는 100개 이상의 큐레이션된 커넥터입니다. 그 외에도 OpenHuman은 오픈 Model Context Protocol 생태계(Smithery + 공식 MCP 레지스트리 — 수천 개의 서버)와 90,000개 항목의 스킬 카탈로그를 탐색하여 에이전트가 요청 시 새로운 유형의 도구와 스킬을 설치할 수 있습니다. 모든 연결은 유형화된 도구가 되며, 20분마다 자동 가져오기가 각 활성 연결을 순회하고 새 데이터를 메모리 트리로 가져옵니다. 프롬프트나 작성해야 할 폴링 루프가 없으므로 에이전트는 이미 아침에 내일의 컨텍스트를 가지고 있습니다.

관리형 통합은 OpenHuman의 Composio 커넥터 계층을 사용합니다. OAuth 핸드셰이크 및 통합 도구 호출은 기본적으로 관리형 백엔드를 통해 프록시됩니다. 대신 Composio를 직접 실행하려면 자체 Composio API 키로 직접 모드를 구성하십시오. 그러면 실시간 트리거 웹훅을 직접 호스팅하고 연결해야 합니다.

• 메모리 트리 + Obsidian Wiki: 데이터와 활동을 기반으로 구축된 로컬 우선 지식 베이스입니다. 연결된 모든 것은 ≤3k 토큰 Markdown 청크로 정규화되고, 점수가 매겨지며, 사용자 기기의 SQLite에 저장된 계층적 요약 트리로 접힙니다. 동일한 청크는 Obsidian 호환 볼트에 .md 파일로 저장되어 열고, 탐색하고, 편집할 수 있습니다. Karpathy의 obsidian-wiki 워크플로에서 영감을 받았습니다.

• SuperContext: 새 채팅이 빈 상태로 시작해서는 안 됩니다. SuperContext가 활성화되면, 하네스는 모든 새 스레드의 첫 번째 턴에서 읽기 전용 contextscout을 결정론적으로 생성합니다. 메모리 트리, 파일 및 연결된 데이터를 훑고, 제한된 컨텍스트 번들을 조립한 다음, 모델이 읽기 전에 메시지 앞에 추가합니다. 기다릴 도구 호출이나 "찾아보겠습니다" 왕복이 없습니다. 에이전트는 이미 관련 배경 지식을 알고 첫 번째 메시지에 응답합니다. 컴포저 또는 context.supercontext_enabled에서 전환하십시오.

• 목표 및 할 일: OpenHuman은 에이전트가 중요한 것에 집중하도록 유지합니다. 메모리에 저장된 짧고 사람이 편집 가능한 장기 목표 목록(MEMORY_GOALS.md)은 최근 활동에 대해 스스로 반성할 수 있습니다. 각 스레드는 선택적 토큰 예산이 있는 단일 지속 목표를 가질 수 있으며, 에이전트는 턴, 인터럽트 및 유휴 기간(자율 유휴 지속)에 걸쳐 작업합니다. 모든 대화는 사용자와 에이전트가 함께 구축하는 할 일의 칸반 작업 보드를 호스팅합니다. 계획, 승인 기준, 승인 게이트 등이 포함됩니다. 또한 개인 작업 목록도 있습니다.