ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/src/core-skills/bmad-install-agentvibes/SKILL.md

2.2 KiB
Raw Blame History

name description
bmad-install-agentvibes Install AgentVibes TTS voice system for BMAD agents. Gives each agent a unique voice, personality, and audio effects. Use when user wants to add voice/TTS to their BMAD setup, or when bmad-party-mode is active and agents are silent.

Install AgentVibes

AgentVibes is an open-source Text-to-Speech system that gives BMAD agents unique voices, personalities, and audio effects. Once installed, party mode agents speak aloud — each with their own voice.

What AgentVibes Provides

  • Per-agent voices — each BMAD agent gets a distinct voice via bmad-voice-map.json
  • Cross-platform — Windows (SAPI + Piper), macOS, Linux, WSL
  • Personalities & effects — reverb, background music, speed, sentiment
  • Party mode integration — agents introduce themselves and speak sequentially

Installation

Run the installer in the terminal:

npx agentvibes install

Or if you prefer a global install first:

npm install -g agentvibes
agentvibes install

The installer will:

  1. Detect your platform (Windows/Mac/Linux/WSL)
  2. Install the appropriate TTS provider (Piper recommended for best quality, SAPI as zero-dependency fallback on Windows)
  3. Configure Claude Code hooks so agents speak automatically
  4. Set up bmad-speak.sh / bmad-speak.ps1 integration for party mode

Post-Install: Configure Agent Voices

After installing, configure per-agent voices for party mode:

/agent-vibes:bmad

This opens the BMAD voice configuration where you can assign each agent a distinct voice, personality, and effects profile.

Verify Installation

agentvibes whoami

Should display the active voice and provider. If party mode is active, agents will now speak when you run /bmad-party-mode.

Troubleshooting

  • Agents still silent after install: Run agentvibes install again — it is idempotent
  • Windows users: Ensure PowerShell execution policy allows scripts: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
  • Voice quality: Install Piper for neural TTS — agentvibes install will prompt you

More Info