agentvibes 5.3.0 → 5.4.0

package/.agentvibes/bmad/bmad-voices.md

@@ -1,69 +1,69 @@
----
-plugin: bmad-voices
-version: 2.0.0
-enabled: true
-description: Provider-aware voice mappings for BMAD agents
----
-
-# BMAD Voice Plugin
-
-This plugin automatically assigns voices to BMAD agents based on their role and active TTS provider.
-
-## Agent Voice Mappings (Provider-Aware)
-
-| Agent ID | Agent Name | Intro | Piper TTS Voice | Piper Voice | Personality |
-|----------|------------|-------|------------------|-------------|-------------|
-| pm | John (Product Manager) | John, Product Manager here | Matthew Schmitz | en_US-john-medium | professional |
-| dev | Amelia (Developer) | Amelia, Developer here | Aria | en_US-amy-medium | normal |
-| analyst | Mary (Business Analyst) | Mary, Business Analyst here | Jessica Anne Bogart | en_US-kristin-medium | normal |
-| architect | Winston (Architect) | Winston, Architect here | Michael | en_GB-alan-medium | normal |
-| sm | Bob (Scrum Master) | Bob, Scrum Master here | Matthew Schmitz | en_US-joe-medium | professional |
-| tea | Murat (Test Architect) | Murat, Test Architect here | Michael | en_US-kusal-medium | normal |
-| tech-writer | Paige (Technical Writer) | Paige, Technical Writer here | Aria | en_US-lessac-medium | normal |
-| ux-designer | Sally (UX Designer) | Sally, UX Designer here | Jessica Anne Bogart | en_US-lessac-high | normal |
-| frame-expert | Saif (Visual Designer) | Saif, Visual Designer here | Matthew Schmitz | en_GB-alan-medium | normal |
-| bmad-master | BMad Master | BMad Master here | Michael | en_US-libritts-high | zen |
-| quick-flow-solo-dev | Barry (Quick Flow Solo Dev) | Barry, Quick Flow Solo Dev here | Matthew Schmitz | en_US-john-medium | professional |
-
-## How It Works
-
-The voice manager automatically selects the appropriate voice based on your active TTS provider:
-- **Piper TTS active**: Uses voices from the "Piper TTS Voice" column
-- **Piper active**: Uses voices from the "Piper Voice" column
-
-This ensures BMAD agents work seamlessly regardless of which provider you're using.
-
-### Supports Both Display Names and Agent IDs
-
-The `bmad-speak.sh` script accepts both formats:
-
-**Party Mode** (multiple agents, uses display names):
-```bash
-.claude/hooks/bmad-speak.sh "Winston" "I recommend microservices for scalability"
-```
-
-**Individual Agents** (single agent sessions, uses agent IDs):
-```bash
-.claude/hooks/bmad-speak.sh "architect" "I recommend microservices for scalability"
-```
-
-Both formats map to the same voice configuration based on the agent ID in the table above. This allows BMAD to use customizable display names while maintaining stable voice mappings.
-
-## How to Edit
-
-Simply edit the table above to change voice mappings. The format is:
-- **Agent ID**: Must match BMAD's `agent.id` field (pm, dev, qa, etc.)
-- **Agent Name**: Display name (for reference only)
-- **Intro**: Text spoken before agent's message (e.g., "John, Product Manager here"). Leave empty to disable.
-- **Piper TTS Voice**: Voice name for Piper TTS provider
-- **Piper Voice**: Voice model name for Piper provider
-- **Personality**: Optional personality to apply (or "normal" for none)
-
-## Commands
-
-- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
-- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
-- `/agent-vibes:bmad status` - Show plugin status
-- `/agent-vibes:bmad edit` - Open this file for editing
-- `/agent-vibes:bmad list` - List all agent voice mappings
-- `/agent-vibes:bmad set <agent-id> <piper-voice> <piper-voice> [personality]` - Set voices for specific agent
+---
+plugin: bmad-voices
+version: 2.0.0
+enabled: true
+description: Provider-aware voice mappings for BMAD agents
+---
+
+# BMAD Voice Plugin
+
+This plugin automatically assigns voices to BMAD agents based on their role and active TTS provider.
+
+## Agent Voice Mappings (Provider-Aware)
+
+| Agent ID | Agent Name | Intro | Piper TTS Voice | Piper Voice | Personality |
+|----------|------------|-------|------------------|-------------|-------------|
+| pm | John (Product Manager) | John, Product Manager here | Matthew Schmitz | en_US-john-medium | professional |
+| dev | Amelia (Developer) | Amelia, Developer here | Aria | en_US-amy-medium | normal |
+| analyst | Mary (Business Analyst) | Mary, Business Analyst here | Jessica Anne Bogart | en_US-kristin-medium | normal |
+| architect | Winston (Architect) | Winston, Architect here | Michael | en_GB-alan-medium | normal |
+| sm | Bob (Scrum Master) | Bob, Scrum Master here | Matthew Schmitz | en_US-joe-medium | professional |
+| tea | Murat (Test Architect) | Murat, Test Architect here | Michael | en_US-kusal-medium | normal |
+| tech-writer | Paige (Technical Writer) | Paige, Technical Writer here | Aria | en_US-lessac-medium | normal |
+| ux-designer | Sally (UX Designer) | Sally, UX Designer here | Jessica Anne Bogart | en_US-lessac-high | normal |
+| frame-expert | Saif (Visual Designer) | Saif, Visual Designer here | Matthew Schmitz | en_GB-alan-medium | normal |
+| bmad-master | BMad Master | BMad Master here | Michael | en_US-libritts-high | zen |
+| quick-flow-solo-dev | Barry (Quick Flow Solo Dev) | Barry, Quick Flow Solo Dev here | Matthew Schmitz | en_US-john-medium | professional |
+
+## How It Works
+
+The voice manager automatically selects the appropriate voice based on your active TTS provider:
+- **Piper TTS active**: Uses voices from the "Piper TTS Voice" column
+- **Piper active**: Uses voices from the "Piper Voice" column
+
+This ensures BMAD agents work seamlessly regardless of which provider you're using.
+
+### Supports Both Display Names and Agent IDs
+
+The `bmad-speak.sh` script accepts both formats:
+
+**Party Mode** (multiple agents, uses display names):
+```bash
+.claude/hooks/bmad-speak.sh "Winston" "I recommend microservices for scalability"
+```
+
+**Individual Agents** (single agent sessions, uses agent IDs):
+```bash
+.claude/hooks/bmad-speak.sh "architect" "I recommend microservices for scalability"
+```
+
+Both formats map to the same voice configuration based on the agent ID in the table above. This allows BMAD to use customizable display names while maintaining stable voice mappings.
+
+## How to Edit
+
+Simply edit the table above to change voice mappings. The format is:
+- **Agent ID**: Must match BMAD's `agent.id` field (pm, dev, qa, etc.)
+- **Agent Name**: Display name (for reference only)
+- **Intro**: Text spoken before agent's message (e.g., "John, Product Manager here"). Leave empty to disable.
+- **Piper TTS Voice**: Voice name for Piper TTS provider
+- **Piper Voice**: Voice model name for Piper provider
+- **Personality**: Optional personality to apply (or "normal" for none)
+
+## Commands
+
+- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
+- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
+- `/agent-vibes:bmad status` - Show plugin status
+- `/agent-vibes:bmad edit` - Open this file for editing
+- `/agent-vibes:bmad list` - List all agent voice mappings
+- `/agent-vibes:bmad set <agent-id> <piper-voice> <piper-voice> [personality]` - Set voices for specific agent

package/.agentvibes/config/README-personality-defaults.md

@@ -0,0 +1,162 @@
+# Personality Voice Defaults
+
+## What is this?
+
+This configuration file (`personality-voice-defaults.json`) maps each AgentVibes personality to a specific Piper TTS voice that sounds best for that character.
+
+## How it works for new users
+
+When someone installs AgentVibes with Piper TTS:
+
+### 1. Installation Process
+
+```bash
+# User installs Piper
+.claude/hooks/piper-installer.sh
+```
+
+**What happens:**
+- Piper TTS binary gets installed via `pipx`
+- User is asked: "Download voice models now?"
+- If yes, runs `piper-download-voices.sh` which downloads:
+  - **16Speakers** (~25MB) - Multi-voice model with 16 speakers
+  - **en_GB-alan-medium** (~25MB) - British male voice
+  - **en_GB-semaine-medium** (~25MB) - British female voice
+  - Plus a few other standard voices
+- Default personality mappings are installed automatically
+
+### 2. What gets downloaded
+
+**Required voices for personality defaults:**
+- ✅ **16Speakers** (1 file) - Provides 16 different speakers:
+  - #0: Cori Samuel (female) - Used for: flirty, dramatic, dry_humor, sassy
+  - #2: Kristin Hughes (female) - Used for: poetic, sarcastic
+  - #4: Mike Pelton (male) - Used for: grandpa
+  - #8: Rose Ibex (female) - Used for: moody
+  - #13: Jennifer Dorr (female) - Used for: millennial
+  - #14: Emily Cripps (female) - Used for: zen
+  - #15: Martin Clifton (male) - Used for: pirate
+
+- ✅ **en_GB-alan-medium** - British male voice
+  - Used for: angry, professional, surfer_dude
+
+- ✅ **en_GB-semaine-medium** - British female voice
+  - Used for: funny
+
+**Total download size: ~75MB** (3 voice models)
+
+### 3. First time using a personality
+
+```bash
+# User switches personality
+/agent-vibes:personality flirty
+```
+
+**What happens:**
+1. AgentVibes reads `personality-voice-defaults.json`
+2. Finds that "flirty" → "16Speakers#0" (Cori Samuel)
+3. Checks if 16Speakers is downloaded
+4. **If not downloaded:**
+   - Prompts: "Voice model not found: 16Speakers. Download? [y/N]"
+   - User says yes → Downloads automatically from HuggingFace
+   - Only happens once per voice model
+5. **If already downloaded:**
+   - Switches to the voice immediately
+   - Plays personality-appropriate TTS
+
+### 4. Graceful fallbacks
+
+If a user:
+- Skips voice downloads during install → On-demand download when needed
+- Deletes the defaults file → Falls back to basic `en_US-lessac-medium`
+- Uses a personality without a mapping → Uses default voice
+
+## For power users
+
+### Customizing defaults
+
+Edit `.claude/personality-voice-defaults.json`:
+
+```json
+{
+  "mappings": {
+    "flirty": {
+      "voice": "16Speakers#0",
+      "rating": 10,
+      "display_name": "Cori Samuel"
+    }
+  }
+}
+```
+
+Change the `voice` field to any Piper voice name.
+
+### Using the voice tester
+
+1. Run the voice tester (in `voice-tester/` folder)
+2. Rate voices for each personality
+3. Export ratings as JSON
+4. Import with: `./import-voice-ratings.sh my-ratings.json`
+
+### Available voices
+
+List all Piper voices: https://huggingface.co/rhasspy/piper-voices
+
+Any voice can be used - AgentVibes will download it on first use.
+
+## FAQ
+
+**Q: Do new users need to download all voices upfront?**
+A: No! Only 3 files (~75MB total) are recommended. Others download on-demand.
+
+**Q: What if a user doesn't download any voices?**
+A: First personality switch will prompt to download the needed voice.
+
+**Q: Can users change the defaults?**
+A: Yes! Edit the JSON file or use the voice tester to rate and export new preferences.
+
+**Q: What if 16Speakers isn't available?**
+A: It's hosted on AgentVibes HuggingFace and included in the download script.
+
+**Q: What happens on slow connections?**
+A: Each voice is ~25MB. Downloads are one-time only and optional.
+
+## Architecture
+
+```
+Installation Flow:
+1. User runs piper-installer.sh
+   ↓
+2. Piper binary installed via pipx
+   ↓
+3. Ask: "Download voices?" → Yes
+   ↓
+4. piper-download-voices.sh runs
+   - Downloads 16Speakers (custom, HuggingFace)
+   - Downloads en_GB-alan-medium (official Piper)
+   - Downloads en_GB-semaine-medium (official Piper)
+   - Downloads other optional voices
+   ↓
+5. install-personality-defaults.sh runs
+   - Copies personality-voice-defaults.json to user config
+   ↓
+6. Ready! Personalities now auto-select best voices
+
+Runtime Flow:
+User: /agent-vibes:personality flirty
+   ↓
+personality-manager.sh checks:
+   1. User defaults (.claude/personality-voice-defaults.json)
+   2. Personality file (piper_voice: field)
+   3. Global default (en_US-lessac-medium)
+   ↓
+Found: 16Speakers#0
+   ↓
+Check if downloaded → Yes
+   ↓
+Switch to voice & play TTS!
+```
+
+## Credits
+
+Voice selections curated by Paul Preibisch based on extensive testing with the AgentVibes voice tester (16 personalities × 19 voices).

package/.agentvibes/config/mode.txt

@@ -0,0 +1 @@
+full

package/.agentvibes/config/personality-voice-defaults.default.json

@@ -0,0 +1,21 @@
+{
+  "version": "1.0",
+  "description": "Default Piper voice assignments for each personality",
+  "mappings": {
+    "angry": {"voice": "en_GB-alan-medium", "rating": 10, "display_name": "English GB - Alan"},
+    "dramatic": {"voice": "16Speakers#0", "rating": 10, "display_name": "Cori Samuel"},
+    "dry_humor": {"voice": "16Speakers#0", "rating": 10, "display_name": "Cori Samuel"},
+    "flirty": {"voice": "16Speakers#0", "rating": 10, "display_name": "Cori Samuel"},
+    "funny": {"voice": "en_GB-semaine-medium", "rating": 10, "display_name": "English GB - Semaine"},
+    "grandpa": {"voice": "16Speakers#4", "rating": 10, "display_name": "Mike Pelton"},
+    "millennial": {"voice": "16Speakers#13", "rating": 10, "display_name": "Jennifer Dorr"},
+    "moody": {"voice": "16Speakers#8", "rating": 10, "display_name": "Rose Ibex"},
+    "pirate": {"voice": "16Speakers#15", "rating": 10, "display_name": "Martin Clifton"},
+    "poetic": {"voice": "16Speakers#2", "rating": 10, "display_name": "Kristin Hughes"},
+    "professional": {"voice": "en_GB-alan-medium", "rating": 10, "display_name": "English GB - Alan"},
+    "sarcastic": {"voice": "16Speakers#2", "rating": 10, "display_name": "Kristin Hughes"},
+    "sassy": {"voice": "16Speakers#0", "rating": 10, "display_name": "Cori Samuel"},
+    "surfer_dude": {"voice": "en_GB-alan-medium", "rating": 10, "display_name": "English GB - Alan"},
+    "zen": {"voice": "16Speakers#14", "rating": 10, "display_name": "Emily Cripps"}
+  }
+}

package/.agentvibes/config/save-audio.txt

@@ -0,0 +1 @@
+true

package/.agentvibes/config/voice-metadata.json

@@ -0,0 +1,160 @@
+{
+  "version": "1.0.0",
+  "provider": "piper",
+  "voices": {
+    "ryan": {
+      "id": "en_US-ryan-high",
+      "displayName": "Ryan",
+      "gender": "male",
+      "accent": "American",
+      "region": "US",
+      "quality": "high",
+      "sampleRate": "22050Hz",
+      "personality": ["professional", "clear", "confident", "authoritative"],
+      "recommendedFor": ["business", "technical", "presentations", "narrator"],
+      "description": "Professional American male voice with clear articulation",
+      "sampleFile": "ryan.wav"
+    },
+    "joe": {
+      "id": "en_US-joe-medium",
+      "displayName": "Joe",
+      "gender": "male",
+      "accent": "American",
+      "region": "US",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["warm", "friendly", "casual", "approachable"],
+      "recommendedFor": ["casual", "friendly", "conversational", "assistant"],
+      "description": "Warm and friendly American male voice",
+      "sampleFile": "joe.wav"
+    },
+    "alan": {
+      "id": "en_GB-alan-medium",
+      "displayName": "Alan",
+      "gender": "male",
+      "accent": "British",
+      "region": "GB",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["refined", "sophisticated", "intelligent", "articulate"],
+      "recommendedFor": ["formal", "educational", "architect", "expert"],
+      "description": "Refined British male voice with sophisticated tone",
+      "sampleFile": "alan.wav"
+    },
+    "marcus": {
+      "id": "en_US-kusal-medium",
+      "displayName": "Marcus",
+      "gender": "male",
+      "accent": "American",
+      "region": "US",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["steady", "reliable", "focused", "analytical"],
+      "recommendedFor": ["testing", "QA", "technical", "documentation"],
+      "description": "Steady and reliable American male voice",
+      "sampleFile": "marcus.wav"
+    },
+    "john": {
+      "id": "en_US-john-medium",
+      "displayName": "John",
+      "gender": "male",
+      "accent": "American",
+      "region": "US",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["energetic", "enthusiastic", "engaging", "dynamic"],
+      "recommendedFor": ["product-management", "leadership", "motivational", "presentations"],
+      "description": "Energetic and enthusiastic American male voice",
+      "sampleFile": "john.wav"
+    },
+    "katherine": {
+      "id": "en_US-lessac-high",
+      "displayName": "Katherine",
+      "gender": "female",
+      "accent": "American",
+      "region": "US",
+      "quality": "high",
+      "sampleRate": "22050Hz",
+      "personality": ["professional", "articulate", "polished", "executive"],
+      "recommendedFor": ["business", "executive", "formal", "professional"],
+      "description": "Professional American female voice with executive presence",
+      "sampleFile": "katherine.wav"
+    },
+    "linda": {
+      "id": "en_US-ljspeech-high",
+      "displayName": "Linda",
+      "gender": "female",
+      "accent": "American",
+      "region": "US",
+      "quality": "high",
+      "sampleRate": "22050Hz",
+      "personality": ["clear", "neutral", "precise", "informative"],
+      "recommendedFor": ["narrator", "audiobooks", "educational", "news"],
+      "description": "Clear and precise American female narrator voice",
+      "sampleFile": "linda.wav"
+    },
+    "amy": {
+      "id": "en_US-amy-medium",
+      "displayName": "Amy",
+      "gender": "female",
+      "accent": "American",
+      "region": "US",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["friendly", "approachable", "helpful", "cheerful"],
+      "recommendedFor": ["assistant", "notifications", "casual", "friendly"],
+      "description": "Friendly and approachable American female voice",
+      "sampleFile": "amy.wav"
+    },
+    "kristin": {
+      "id": "en_US-kristin-medium",
+      "displayName": "Kristin",
+      "gender": "female",
+      "accent": "American",
+      "region": "US",
+      "quality": "medium",
+      "sampleRate": "22050Hz",
+      "personality": ["analytical", "thoughtful", "intelligent", "insightful"],
+      "recommendedFor": ["analyst", "research", "strategy", "consulting"],
+      "description": "Thoughtful and analytical American female voice",
+      "sampleFile": "kristin.wav"
+    },
+    "charlotte": {
+      "id": "en_GB-southern_english_female-low",
+      "displayName": "Charlotte",
+      "gender": "female",
+      "accent": "British",
+      "region": "GB",
+      "quality": "low",
+      "sampleRate": "16000Hz",
+      "personality": ["elegant", "sophisticated", "cultured", "refined"],
+      "recommendedFor": ["formal", "sophisticated", "cultural", "narrator"],
+      "description": "Elegant British female voice with southern English accent",
+      "sampleFile": "charlotte.wav"
+    }
+  },
+  "defaultVoice": "ryan",
+  "installerVoices": [
+    "ryan",
+    "joe",
+    "alan",
+    "marcus",
+    "john",
+    "katherine",
+    "linda",
+    "amy",
+    "kristin",
+    "charlotte"
+  ],
+  "bmadAgentDefaults": {
+    "architect": "alan",
+    "analyst": "kristin",
+    "dev": "joe",
+    "pm": "john",
+    "sm": "amy",
+    "tea": "marcus",
+    "tech-writer": "linda",
+    "ux-designer": "charlotte",
+    "bmad-master": "ryan"
+  }
+}

package/.agentvibes/config.json

@@ -1,23 +1,32 @@
 {
+  "defaultVoice": "libritts-speaker-925",
+  "ttsProvider": "piper",
+  "provider": "soprano",
   "backgroundMusic": {
-    "track": "agent_vibes_chillwave_v2_loop.mp3",
+    "enabled": false,
+    "track": "agent_vibes_japanese_city_pop_v1_loop.mp3",
+    "volume": 20
+  },
+  "music": {
     "enabled": true,
-    "volume": 10
+    "track": "agentvibes_nature_sounds_rain.mp3"
   },
-  "voice": "en_US-libritts-high::Derek-6",
-  "pretext": "AgentVibes here",
-  "provider": "piper",
+  "musicFavorites": [
+    "agentvibes_blues_smooth_guitar.mp3",
+    "agentvibes_lofi_beats_coding.mp3",
+    "agentvibes_nature_sounds_rain.mp3",
+    "agent_vibes_ganawa_ambient_v2_loop.mp3"
+  ],
   "effects": {
-    "reverbPreset": "light"
+    "reverb": true,
+    "reverbAmount": 0.6,
+    "pitch": 2,
+    "reverbPreset": "medium"
   },
+  "verbosity": "high",
+  "personality": "grandpa",
+  "voice": "en_US-ljspeech-high",
+  "pretext": "Agent Vibes Here",
   "setupCompleted": true,
-  "thumbsUp": [
-    "en_US-libritts-high::Adam-10",
-    "en_US-libritts-high::Leo-7"
-  ],
-  "favorites": [
-    "en_US-libritts-high::Adam-10",
-    "en_US-libritts-high::Leo-7"
-  ],
-  "thumbsDown": []
+  "ttsEngine": "piper"
 }