x-t-e-r/openpet

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

57 stars 15 forks 품질 66 트렌드 13GPL-3.0

Repository Install

OpenPet: AI 대리인을 위한 국부적으로 탁상용 애완 동물 런타임. 本地行行,,物 CLI CLI/MCP/HTTP API 。

개요

OpenPet는 Codex 호환 동반자를위한 로컬 데스크탑 애완 동물 런타임입니다. 그것은 투명 한 항상 탑 애완 동물 창을 보여줍니다, 사용자 수입 호환 애완 동물을하자, 그리고 로컬 컨트롤 API를 노출 OpenClaw, Codex, 다른 에이전트는 작업을 통해 상태를 표시 할 수 있습니다, 거품, 및 이벤트. GitHub: [T0] 대부분의 Windows 사용자는 GitHub 릴리스에서 패키지 빌드를 설치하고 OpenPet을 시작합니다. 애완 동물은 바탕 화면에 나타납니다, 원하는 위치에 끌 수 있으며 애완 동물 마우스 오른쪽 클릭 메뉴 또는 앱 트레이 / Menu에서 구성 할 수 있습니다. 빌드는 Windows, macOS 및 Linux에서 생성됩니다. 개발 및 수동 검증은 현재 Windows에서 발생합니다. macOS 및 Linux 패키지는 CI에 의해 구축되지만 아직 개발자가 수동으로 테스트되지 않았습니다. - Windows: 수동으로 검증된 플랫폼. - macOS: CI는 Apple Silicon 및 Intel artifacts를 별도로 구축합니다.

개요(AI 번역)

한국어

OpenPet는 Codex 호환 동반자를위한 로컬 데스크탑 애완 동물 런타임입니다. 그것은 투명 한 항상 탑 애완 동물 창을 보여줍니다, 사용자 수입 호환 애완 동물을하자, 그리고 로컬 컨트롤 API를 노출 OpenClaw, Codex, 다른 에이전트는 작업을 통해 상태를 표시 할 수 있습니다, 거품, 및 이벤트.

GitHub:

빠른 시작

대부분의 Windows 사용자는 GitHub 릴리스에서 패키지 빌드를 설치하고 OpenPet을 시작합니다. 애완 동물은 바탕 화면에 나타납니다, 원하는 위치에 끌 수 있으며 애완 동물 마우스 오른쪽 클릭 메뉴 또는 앱 트레이 / Menu에서 구성 할 수 있습니다.

빌드는 Windows, macOS 및 Linux에서 생성됩니다. 개발 및 수동 검증은 현재 Windows에서 발생합니다. macOS 및 Linux 패키지는 CI에 의해 구축되지만 아직 개발자가 수동으로 테스트되지 않았습니다.

플랫폼 상태

Windows: 수동으로 검증된 플랫폼.
macOS: CI는 Apple Silicon 및 Intel artifacts를 별도로 구축합니다. 다운로드 된 macOS 앱의 정상 출시는 Apple Developer ID 서명 및 식별이 필요합니다. 릴리스가 그 자격없이 구축 된 경우, Gatekeeper는 OpenPet이 손상되거나 확인 될 수 있음을 보여줄 수 있습니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

OpenPet

简体中文

OpenPet is a local desktop pet runtime for Codex-compatible companions. It shows a transparent always-on-top pet window, lets users import compatible pets, and exposes a local control API so OpenClaw, Codex, and other agents can show status through actions, bubbles, and events.

GitHub:

Quick Start

For most Windows users, install a packaged build from GitHub Releases and launch OpenPet. The pet appears on your desktop, can be dragged to the position you want, and can be configured from the pet right-click menu or the app tray/menu.

Release builds are generated for Windows, macOS, and Linux. Development and manual verification currently happen on Windows; macOS and Linux packages are built by CI but have not been manually tested by the developer yet.

Platform Status

Windows: primary manually verified platform.
macOS: CI builds Apple Silicon and Intel artifacts separately. Normal launch of a downloaded macOS app requires Apple Developer ID signing and notarization; if the release was built without those credentials, Gatekeeper may show that OpenPet is damaged or cannot be verified. Treat unsigned macOS artifacts as tester builds, not production-ready distribution.
Linux: CI builds .deb, .rpm, and .AppImage artifacts on Ubuntu, but runtime behavior has not been manually verified yet.

To run from source:

pnpm install
pnpm tauri:dev

Features

Transparent, borderless, always-on-top desktop pet window.
Click-to-act, drag-to-position, right-click pet menu, and app tray/menu controls.
Website import for compatible public Codex pet pages, with imported assets stored locally and served by OpenPet.
Local pet import through the running runtime API for agent and CLI workflows.
Companion events for thinking, tool-running, reviewing, success, failure, and attention.
Settings for English / Simplified Chinese UI, pet selection, click action mode, random click action pool, event reactions, event bubbles, idle self-play, autonomous walking, hover pause, walking speed, scale, reduced motion, and configurable HTTP API listen address / port.

Import Pets

Bundled pets live in public/pets//. Imported pets are stored in the app data directory and join the same runtime catalog. A Codex-compatible package should include:

pet.json
spritesheet.webp

The bundled nia pack uses a 1536x1872 spritesheet atlas with an 8x9 grid and 192x208 cells.

Open Settings to import from a supported website URL. Current compatibility targets:

Petdex: https://petdex.crafter.run/pets/
Codex Pets: https://codex-pets.net/share/ and https://codex-pets.net/#/pets/

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "openpet": {
      "command": "python",
      "args": ["skills/openpet-mcp/scripts/openpet_mcp_server.py"]
    }
  }
}