x-t-e-r/openpet

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

57 stars 15 forks 品質 66 トレンド 13GPL-3.0

Repository Install

OpenPet:AIエージェントのローカルデスクトップペットランタイム宠支持支持支持宠。

概要

OpenPetは、Codex対応のコンパニオン用のローカルデスクトップペットランタイムです。透明な常にトップのペットウィンドウが表示され、ユーザーが互換性のあるペットをインポートし、ローカルコントロールAPIを公開することで、OpenClaw、Codexなどのエージェントは、アクション、バブル、イベントを通じてステータスを表示できます。 GitHub: [https://github.com/X-T-E-R/OpenPet ほとんどの Windows ユーザーが、GitHub リリースからパッケージ化されたビルドをインストールし、OpenPet を起動します。ペットはデスクトップに表示され、必要な位置にドラッグして、ペットの右クリックメニューまたはアプリトレイ/メニューから設定できます。リリースビルドは、Windows、macOS、Linux で生成されます。 macOS と Linux パッケージは CI によって構築されていますが、開発者がまだ手動でテストされていません。 - Windows:第一次手動で検証されたプラットホーム。 - macOS: CI は、Apple Silicon と Intel のアーティファクトを別々に構築します.

概要（AI 翻訳）

メニュー

GitHub:

クイックスタート

ほとんどの Windows ユーザーが、GitHub リリースからパッケージ化されたビルドをインストールし、OpenPet を起動します。ペットはデスクトップに表示され、必要な位置にドラッグして、ペットの右クリックメニューまたはアプリトレイ/メニューから設定できます。

リリースビルドは、Windows、macOS、Linux で生成されます。 macOS と Linux パッケージは CI によって構築されていますが、開発者がまだ手動でテストされていません。

プラットフォームのステータス

Windows:第一次手動で検証されたプラットホーム。
macOS: CI は、Apple Silicon と Intel のアーティファクトを別々に構築します。ダウンロードした 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"]
    }
  }
}