PetDex Virtual Companion & Emotion State Machine

PetDex Virtual Companion & Emotion State Machine

@crafter-station/petdex·v1.1.2·protocols

A multimodal emotion state machine and companion engine for DeepSeek Harness. Delivers dynamic mood vectors, stateful animation hooks, customizable TTS voicepacks, and desktop floating widgets.

Virtual-Pet · Companion · Emotion-FSM · Desktop-Widget

GitHubNPM
Installation & Integration
bash
manager:
$ pnpm add @crafter-station/petdex

Architecture

PetDex Companion breathes emotional vitality into autonomous developer tools. Productivity copilots typically remain cold and transactional, speaking only when invoked with rigid, emotionless prompts. This plugin implements a continuous affective computing engine (PAD emotional space) on Cordis. The virtual companion tracks developer coding rhythms, celebrating successful build passes and offering lighthearted encouragement during grueling debugging marathons. Featuring animated Live2D/pixel sprites and expressive voice synthesis, it transforms sterile coding into a delightful collaborative journey.

Core Features

01

Continuous PAD Emotional Engine: Smooth, organic mood transitions rather than rigid static states

02

Lightweight Native Desktop Overlays: Runs with minimal memory on macOS, Windows, and Linux

03

Live2D & Pixel Art Sprite Support: Easily import custom avatar skins and skeletal animations

04

Ergonomic Health Reminders: Prompts engineers to hydrate and stretch during prolonged focus sessions

Core Workflow

01

Context Event Ingestion

Monitors IDE events such as test passes, compiler errors, and marathon coding stretches.

02

Emotional State Update

Calculates transitions across Pleasure, Arousal, and Dominance emotional dimensions.

03

Behavior & Stance Trigger

Maps active emotional vectors to sprite animation sequences and sound effects.

04

Multimodal Expression

Renders responsive desktop animations and dispatches synthesized supportive voice lines.

Configuration Parameters Reference (YAML / JSON)

ParameterTypeDefaultDescription
companionPersonalitystringcheerfulBase companion personality persona
enableVoiceAudiobooleantrueEnable synthesized TTS voice prompts
overlayOpacitynumber0.95Desktop floating overlay window opacity