---
How to install openpets?
alvinunreal/openpets
$git clone https://github.com/alvinunreal/openpetsInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install openpets by running `git clone https://github.com/alvinunreal/openpets`, then use it for the current task and follow its documentation at 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 |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
