OpenPetsHQ/openpets

해결하는 문제

OpenPets는 작업 환경의 외로움을 줄이고, 실용적인 생산성 도구로 전환할 수 있는 애니메이션 디스크톱 동물을 추가할 수 있는 방법을 제공합니다. 단순한 데스크톱 펫과 AI 기반 에이전트 사이의 격차를 메우며, Claude Code나 Cursor와 같은 코드 에이전트의 상태와 반응을 화면에 물리적인 존재감으로 시각화할 수 있게 해줍니다.

작동 방식

이 플랫폼은 애니메이션 동물을 렌더링하는 Electron 기반 데스크톱 애플리케이션으로 구성되어 있으며, 세 가지 주요 계층으로 구성된 모듈식 아키텍처를 사용합니다:

1. 플러그인 시스템: 사전에 격리된 JavaScript/TypeScript 런타임(SDK v3)을 통해 개발자가 사용자 정의 동작을 만들 수 있습니다. 플러그인은 애니메이션을 트리거하거나 HUD를 표시하며 스케줄을 관리할 수 있지만, 권한이 부여되지 않으면 시스템에 직접 접근할 수 없습니다.
2. 에이전트 통합: Model Context Protocol(MCP)를 사용하여 OpenPets는 AI 에이전트가 호출할 수 있는 서버 역할을 합니다. 이로 인해 에이전트가 특정 반응(예: "생각 중" 또는 "성공")을 트리거하거나, 현재 작업에 따라 데스크톱 펫에 대화창을 표시할 수 있습니다.
3. 로컬 우선 설계: 모든 AI 통합과 데이터는 로컬에서 처리됩니다. 사용자는 OpenAI나 Anthropic 등의 제공자용 API 키를 자체 설정하고, 보안 토큰을 사용한 로컬 소켓을 통해 통신합니다.

대상 사용자

• 일반 사용자: 포모도로 타이머와 수분 섭취 알림과 같은 내장 도구가 있는 귀여운 인터랙티브한 데스크톱 동반자를 원하는 사람.
• 개발자: 제공된 SDK를 사용해 사용자 정의 펫 행동을 구축하고 싶은 사람.
• AI 전문 사용자: AI 코드 에이전트를 사용하면서 시각적이고 방해가 되지 않는 방식으로 에이전트의 활동과 반응을 모니터링하고 싶은 개발자.

주요 특징

• MCP 지원: Claude Code, Cursor 및 기타 MCP 클라이언트와의 네이티브 통합을 통해 펫의 반응을 제어할 수 있습니다.
• 사전 격리된 SDK: 전용 CLI를 갖춘 안전한 플러그인 환경으로, 플러그인의 템플릿 생성, 검증, 테스트가 가능합니다.
• 개인정보 중심: 로컬 전용 IPC, SSRF 보호, AI 생성 대화의 엄격한 정제를 통해 기밀 정보나 코드 유출을 방지합니다.
• 풍부한 공식 플러그인: "가상 펫"(타마고치 스타일), Focus Buddy, Launch Buddy 등 다양한 사전 제작 도구를 포함합니다.