deepseek-pet: Keep an Interactive Blue Whale Pet in DeepSeek Harness
keleus/deepseek-pet
A Live2D-style blue whale pet for DeepSeek Harness that reacts to tasks with expressions.
Add a Live2D-style blue whale to the DeepSeek Harness web interface that switches expressions with task states and can be dragged and scaled, bringing fun and visual feedback to the Agent workbench.
dsh plugin --profile web add github:keleus/deepseek-pet- Category
- Entertainment
- Platform
- DSH-Plugin
- Author
- keleus
- Distribution
- Plugin
deepseek-pet Key Features
deepseek-pet Repository
deepseek-pet Repo Summary
DeepSeek Pet is an entertainment/fun DSH plugin for DeepSeek Harness that keeps a big blue whale as a desktop pet in your DSH web interface. The whale automatically changes expressions based on current tasks, tool calls, context usage, and active sessions, and presents Live2D-style effects through breathing, bouncing, tilting, parallax, and fade animations, making the otherwise dull Agent workbench lively and engaging. It primarily solves the problem of lacking visual feedback and fun during long observation of Agent execution, while helping developers intuitively grasp session progress through state visualization. Core capabilities include: expression switching based on task states, session focus and cascading display, bubble interactions for tool approval and user questions, context usage prompts, idle animations (hungry, sleepy, sleeping), time-based greetings, and an interactive pet that can be dragged, scaled, and collapsed.
What core features does the DeepSeek Pet DSH plugin support?
DeepSeek Pet offers rich state-aware and interactive features. It switches expressions based on scenarios such as analysis, answering, coding, web search, sub-agents, completion, and failure. During the answering phase, it cycles through working images like typing, thinking, and careful checking; during the thinking phase, it cycles through different status labels. When multiple sessions run in parallel, it enters a "super busy" state. When a tool awaits approval, you can allow or reject it directly in the bubble. User questions support options, custom input, submission, and rejection. Additionally, it shows "can eat a bit more" when context reaches 62%, and "full" at 82%; shows a blindfolded state when images are input; shows hungry after 10 minutes of no tasks, sleepy with a pillow after 30 minutes, and sleeping after 1 hour; displays greetings based on local time, gets sleepy after 23:00, and enters sleep state in the early morning. Above the character, a bubble carousel displays status phrases with a single-line horizontal typewriter effect following the latest output; below the character, a horizontal bar shows the focused session with a bright border, active sessions are arranged downward, and when more than three, they automatically cascade and collapse.
How to install DeepSeek Pet?
Installing DeepSeek Pet requires Node.js and pnpm. If you have the global dsh CLI installed, run the following command directly:
dsh plugin --profile web add github:keleus/deepseek-pet
If you don't have the global dsh command, you can execute it via npx without installing an extra CLI:
npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet
Both commands have the same effect and will pull the plugin from GitHub and install it to the Web profile. After installation, start or restart the web page (dsh web or npx @deepseek-ai/dsh web). If the page is already open, refresh it.
How to build and debug DeepSeek Pet from source?
To install from source, clone the repository, run npm install, npm run build, then link the local directory with dsh plugin --profile web add .. After modifying code and rebuilding, you can continue debugging. The development environment requires Node.js 22.19 or higher, plus Python 3 and Pillow. npm run assets generates transparent WebP expressions from source images and embeds them into the client code; npm run build generates lib/index.js and lib/client.js; npm test runs state mapping, interaction, and plugin loading tests.
How to update and uninstall DeepSeek Pet?
To update, simply re-run the install command to pull and install the latest remote version, then restart the web process and refresh the page. To uninstall, use dsh plugin --profile web remove deepseek-pet (or npx @deepseek-ai/dsh plugin --profile web remove deepseek-pet).
What interactions does DeepSeek Pet support?
You can drag the character to adjust its display position; hover the mouse over the character and scroll the wheel to adjust the pet size within 65%–140%; click the character to trigger a short phrase feedback matching the current state; double-click the character or click the "−" button to minimize it to a static icon in the bottom-right corner; click an active session to switch it to the focused session; when an approval or question card appears, you can select, input, allow, or reject directly.
DeepSeek Pet is maintained by keleus, licensed under MIT, and last updated in 2026-08. It is an actively maintained DSH plugin. It supports narrow-screen layouts and prefers-reduced-motion, and remembers the character's position and size.