openpets
starsforks
How to install openpets?
alvinunreal/openpets
$git clone https://github.com/alvinunreal/openpets---
README.md
| 1 | <p align="center"> |
| 2 | <img src="assets/openpets.png" alt="OpenPets desktop companion platform" width="100%" /> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <strong>A desktop companion platform with pets, plugins, and optional local agent integrations.</strong> |
| 7 | </p> |
| 8 | |
| 9 | <p align="center"> |
| 10 | OpenPets puts an animated companion on your desktop, then lets plugins turn it into a focus buddy, reminder system, tiny game, launcher, or coding-agent sidekick. |
| 11 | </p> |
| 12 | |
| 13 | <p align="center"> |
| 14 | <img src="assets/intro.png" alt="OpenPets reacting across multiple coding agent sessions" width="100%" /> |
| 15 | </p> |
| 16 | |
| 17 | <div align="center"> |
| 18 | <p><sub>by <b>Boring Dystopia Development</b></sub></p> |
| 19 | <p> |
| 20 | <a href="https://boringdystopia.ai/"><img src="https://img.shields.io/badge/boringdystopia.ai-111111?style=for-the-badge&logo=vercel&logoColor=white" alt="boringdystopia.ai"></a> |
| 21 | <a href="https://x.com/alvinunreal"><img src="https://img.shields.io/badge/X-@alvinunreal-000000?style=for-the-badge&logo=x&logoColor=white" alt="X @alvinunreal"></a> |
| 22 | <a href="https://t.me/boringdystopiadevelopment"><img src="https://img.shields.io/badge/Telegram-Join%20channel-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram Join channel"></a> |
| 23 | </p> |
| 24 | </div> |
| 25 | |
| 26 | <p align="center"> |
| 27 | Read this in: <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a> | <a href="README.zh-Hans.md">简体中文</a> | <a href="README.zh-Hant.md">繁體中文</a> | <a href="README.pt-BR.md">Português (Brasil)</a> | <a href="README.es-419.md">Español (LatAm)</a> |
| 28 | </p> |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | ## Download OpenPets |
| 33 | |
| 34 | **[Download the latest OpenPets desktop release](https://github.com/alvinunreal/openpets/releases/latest)** and launch it. A pet appears immediately; no agent setup required. |
| 35 | |
| 36 | - **Desktop pets**: animated companions that idle, wander, react, and keep your workspace from feeling empty. |
| 37 | - **Official plugins**: focus timers, reminders, mood check-ins, mini games, launch shortcuts, hydration nudges, and virtual-pet stats. |
| 38 | - **Plugin SDK v3**: a sandboxed JavaScript/TypeScript runtime for building new pet abilities with permissions, quotas, storage, schedules, commands, panels, events, audio, notifications, and more. |
| 39 | - **Optional agent layer**: Claude Code, OpenCode, Cursor, Pi, and MCP clients can drive local pet reactions without exposing prompts, code, paths, logs, or secrets in speech bubbles. |
| 40 | |
| 41 | --- |
| 42 | |
| 43 | ## Star OpenPets |
| 44 | |
| 45 | If OpenPets makes your coding setup or desktop workspace a little more fun, please give the repo a star. |
| 46 | |
| 47 | <p align="center"> |
| 48 | <img src="assets/star-repo.gif" alt="Starring the OpenPets repository" width="100%" /> |
| 49 | </p> |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## For Users: Getting Started |
| 54 | |
| 55 | You do not need to be a developer or connect any AI agents to enjoy OpenPets. The desktop app is fully functional out of the box with the official plugin lineup. |
| 56 | |
| 57 | ### 1. Install OpenPets Desktop |
| 58 | |
| 59 | Download the package for your operating system from [OpenPets Releases](https://github.com/alvinunreal/openpets/releases/latest): |
| 60 | |
| 61 | - **macOS Apple Silicon**: `OpenPets-*-mac-arm64.dmg` |
| 62 | - **macOS Intel**: `OpenPets-*-mac-x64.dmg` |
| 63 | - **Windows**: `OpenPets-*-win-x64-setup.exe` |
| 64 | - **Linux**: `OpenPets-*-linux-x86_64.AppImage` |
| 65 | |
| 66 | > Note: Windows release installers are signed. macOS builds may still be unsigned and can trigger a security warning; if macOS blocks execution, remove the quarantine flag via terminal: |
| 67 | > ```bash |
| 68 | > xattr -dr com.apple.quarantine /Applications/OpenPets.app |
| 69 | > ``` |
| 70 | |
| 71 | ### 2. Manage and Customize Pets |
| 72 | |
| 73 | Browse installed pets, preview their animation frames, and configure which pet monitors each workspace or agent window from the built-in **Pet Gallery**. |
| 74 | |
| 75 | <p align="center"> |
| 76 | <img src="assets/manage-pets.png" alt="Managing pets in the OpenPets desktop app" width="100%" /> |
| 77 | </p> |
| 78 | |
| 79 | ### 3. Enable Official Plugins |
| 80 | |
| 81 | OpenPets v3 ships with a modular **Official Plugin Catalog**. Enable or configure plugins via the desktop Control Center to add focus timers, reminders, and mini interactive games. |
| 82 | |
| 83 | #### Shippe |
People who liked this also viewed
6 picksType
- excel-mcpA Model Context Protocol (MCP) server for working with Excel (.xlsx) files without requiring Microsoft Excel. Enables AI assistants to create, read, modify, and format spreadsheets using openpyxl, fully in Python and cross-platform.MCP ServersOct 2025
- memories-with-lessons-mcp-serverI enhance the existing memory mcp server from the official mcp github, so big thanks and credits for creating thisMCP ServersFeb 2025
- anytype-mcpAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.MCP ServersJul 2026
- mcp-server-kubernetesMCP Server for kubernetes management commandsMCP ServersJul 2026
- thoughtboxThoughtbox is an intention ledger for agents. Evaluate AI's decisions against its decision-making.MCP ServersJul 2026
- google-drive-mcpA Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.MCP ServersJul 2026
