Open source · Web, macOS, Windows, and Linux

A playful companion for every screen.

Add a lively companion to your screen. The included pet is Shiro, a digital golden retriever who follows your cursor, takes naps, performs tricks, and is always ready to fetch another ball.

Play with Shiro Download for macOS
Zero runtime dependencies Works with any framework Free and open source
Close portrait of Shiro the golden retriever smiling
Inspired by the real Shiro A ball-loving golden retriever with a big personality and an even bigger collection of tricks.
Live playground

Ask Shiro to show you a trick.

The pet on this page is the actual package. Try a command, drag him around, or open his paw menu in the corner.

Fourteen trained commands, plus care and surprises.

Shiro can respond directly to visitors, react to the pointer, or choose his own behavior when everyone is busy.

Shiro is ready to play

All tricks and commands

Choose one and watch the digital Shiro on this page.

Choose a view
Built to feel alive

More companion than widget.

A lightweight animation engine gives Shiro personality without taking over your app or website.

01

Independent behavior

Shiro walks, runs, rests, watches the pointer, and chooses his own tricks when left alone.

02

Natural commands

Sit, down, jump, roll over, handshake, hi-five, salute, namaste, speak, quiet, sleep, and fetch.

03

Ball obsessed

A colorful ball collection and dedicated fetch animation capture the real Shiro's favorite pastime.

04

Website safe

Shadow DOM keeps styles isolated, while background-tab pausing and reduced-motion support keep performance responsible.

05

Visitor controlled

Drag to reposition, pick a size, hide Shiro, send him to sleep, or call any command through JavaScript.

06

Cross-platform

Use the Web Component in any framework or download the shared desktop pet for macOS, Windows, and Linux.

Shiro relaxing happily in a corner
The dog behind the code

His name is Shiro.

Shiro is a real golden retriever with long honey-gold fur, a happy face, a love for people, and more balls than anyone can count. This project brings a little of that personality to the screen.

Shiro is the default pet and the inspiration for the project. You can change his name for your own website, and future releases will add more ways to personalize your companion.

Read the real Shiro's adventures and daily life in Shiro's stories ↗, or visit Shiro's website ↗.

“Built from a real companion, designed to become yours.”
One package, any project

Drop Digital Pet into your stack.

The core is a dependency-free Web Component, so it works in plain HTML and stays easy to wrap in React, Vue, Angular, Svelte, Astro, or any framework that supports custom elements.

$ npm install @ranjeet447/digital-pet
HTML React Vue Nuxt Angular Svelte SvelteKit Next.js Astro 
<script type="module"
  src="https://ranjeet447.github.io/digital-pet/downloads/digital-pet-v0.3.0.js"></script>

<digital-pet
  size="normal"
  controls="true"
  renderer="3d"
></digital-pet>
Every screen

Web today. Desktop everywhere.

One shared personality and feature contract across browsers and native desktop applications.

Available

macOS app

Shared always-on-top desktop app with 2D and 3D views, sounds, care actions, all tricks, five sizes, and tray controls.

Download for macOS
Available

Windows app

Portable Windows x64 app with the same renderer, commands, sounds, care actions, sizes, and system tray controls.

Download for Windows
Available

Linux app

Portable Linux x64 AppImage with feature parity and tray controls on supported desktop environments.

Download for Linux
Meet the real Shiro

Golden, fluffy, and always smiling.

These photos guide the digital character's broad nose, feathered fur, warm coat, happy expression, and playful personality.

Close portrait of Shiro smiling
The smile behind the digital expression.
Shiro as a golden retriever puppy
Shiro's puppy days.
Adult Shiro sitting on a sofa
Full fur, bright eyes, and ready to play.
Shiro relaxing on a wooden floor
Expert in corner naps.

Bring Digital Pet to your screen.

Try the package or download the desktop app for macOS, Windows, or Linux. Follow development on GitHub and help shape future personalization releases.

View on GitHub Install the package