agentvibes 2.0.20 → 2.0.22

package/agentvibes.org/content/blog/discovering-new-piper-voices.mdx

@@ -1,253 +0,0 @@
----
-title: "Discovering 16 New Piper Voices - Free, High-Quality TTS for Everyone"
-description: "We found amazing new Piper TTS voices from talented creators and made them available to AgentVibes users through Hugging Face. Try them all with live audio previews!"
-date: "2025-10-17"
-author: "Paul Preibisch"
-tags: ["release", "voices", "piper", "open-source"]
----
-
-# Discovering New Piper Voices
-
-Today we went on an exciting journey to find new Piper TTS voices for AgentVibes, and we struck gold! 🎉
-
-## The Search for Quality Free Voices
-
-We've always believed that high-quality text-to-speech shouldn't require an expensive API subscription. While ElevenLabs offers incredible premium voices, we wanted to expand our free Piper TTS options to give everyone access to professional-sounding AI voices.
-
-During our search, we discovered some incredible resources and talented creators who have contributed their custom-trained Piper voices to the open-source community. We found websites with custom voice models, learned about the licensing requirements, and even discovered how to create your own custom voices!
-
-## Meet Bryce Beattie
-
-One standout discovery was [Bryce Beattie's collection](https://brycebeattie.com/files/tts/) of high-quality Piper voices. Bryce is a developer and AI enthusiast who has generously made his custom-trained TTS voices available to the community. On his website, he states:
-
-> "Note: Feel free to use these for any legal and ethical purpose. If somebody wants to upload these to HuggingFace or somewhere similar, you have my blessing."
-
-We took him up on that offer! These voices are exceptionally well-trained and sound natural and professional. We're incredibly thankful to Bryce for making these available to the community and helping democratize access to quality TTS technology.
-
-## Why Hugging Face?
-
-You might be wondering: what is Hugging Face, and why did we choose to host these voices there?
-
-**Hugging Face** is the GitHub of AI models. It's the world's largest platform for sharing and discovering machine learning models, datasets, and AI applications. Think of it as a central hub where AI researchers, developers, and enthusiasts can:
-
-- **Share models** - Upload and distribute trained AI models
-- **Version control** - Track changes and improvements over time
-- **Easy access** - Simple download links and APIs for integration
-- **Community trust** - Verified models with proper licensing and attribution
-- **Free hosting** - No cost for hosting open-source models
-
-We chose Hugging Face because it's the industry standard for distributing AI models. It provides:
-
-✅ **Reliable hosting** - Fast, global CDN with 99.9% uptime
-✅ **Proper attribution** - Built-in licensing and credit system
-✅ **Version tracking** - Easy updates and improvements
-✅ **Community standards** - Trusted by millions of AI developers
-✅ **Free forever** - No hosting costs passed to users
-
-You can find our AgentVibes Piper voices repository on Hugging Face, where all these new voices are hosted with proper attribution and licensing information.
-
-## Introducing 16 New Voices
-
-We've added **16 amazing new voices** to AgentVibes v2.0.18, released today! Each voice has its own unique character and style. Listen to samples below and find your new favorite voice.
-
-### Voice Previews
-
-<div className="my-8 space-y-4">
-  <div className="rounded-2xl border-2 border-purple-500 p-6">
-    <h4 className="mb-6 text-center text-xl font-semibold text-indigo-400">
-      Try All 16 New Voices
-    </h4>
-
-    <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3">
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Cori Samuel</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_0_Cori_Samuel.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Kara Shallenberg</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_1_Kara_Shallenberg.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Kristin Hughes</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_2_Kristin_Hughes.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Maria Kasper</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_3_Maria_Kasper.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Mike Pelton</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_4_Mike_Pelton.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Mark Nelson</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_5_Mark_Nelson.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Michael Scherer</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_6_Michael_Scherer.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">James K White</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_7_James_K_White.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Rose Ibex</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_8_Rose_Ibex.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">ProgressingAmerica</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_9_progressingamerica.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Steve C</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_10_Steve_C.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Owlivia</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_11_Owlivia.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Paul Hampton</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_12_Paul_Hampton.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Jennifer Dorr</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_13_Jennifer_Dorr.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Emily Cripps</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_14_Emily_Cripps.wav" type="audio/wav" />
-        </audio>
-      </div>
-
-      <div className="flex flex-col items-center rounded-lg bg-gray-800/50 p-4">
-        <span className="mb-2 font-medium text-gray-300">Martin Clifton</span>
-        <audio controls className="w-full">
-          <source src="/audio/piper-voices/speaker_15_Martin_Clifton.wav" type="audio/wav" />
-        </audio>
-      </div>
-    </div>
-  </div>
-</div>
-
-## How to Use These Voices
-
-These voices are available in **AgentVibes v2.0.18** (released today, October 17, 2025). To use them:
-
-### 1. Update to v2.0.18
-
-```bash
-npm install -g agentvibes@latest
-```
-
-### 2. Switch to Piper Provider
-
-```bash
-/agent-vibes:provider switch piper
-```
-
-### 3. List Available Voices
-
-```bash
-/agent-vibes:list
-```
-
-You'll see all 16 new voices in the list!
-
-### 4. Try a New Voice
-
-```bash
-/agent-vibes:switch "Kara Shallenberg"
-/agent-vibes:switch "James K White"
-```
-
-Or use the preview command to hear samples before choosing:
-
-```bash
-/agent-vibes:preview
-```
-
-## Licensing & Attribution
-
-All voices hosted on our Hugging Face repository include proper licensing information:
-
-- **Bryce Beattie's voices** - Free for any legal and ethical purpose
-- **Other community voices** - Attribution licenses clearly specified
-- **Full transparency** - License files included with each voice model
-
-We're committed to respecting creators' rights while making quality TTS accessible to everyone.
-
-## What's Next?
-
-This is just the beginning! We're excited about:
-
-- **More voice discoveries** - Continuing to find and curate quality free voices
-- **Custom voice training** - Exploring tools to help users create their own voices
-- **Community contributions** - Accepting voice submissions from the community
-- **Improved voice management** - Better organization and categorization
-
-## Try Them Today!
-
-Update to AgentVibes v2.0.18 and explore these 16 new voices. Each one brings unique character and quality to your AI interactions.
-
-**Huge thanks to:**
-- **Bryce Beattie** - For generously sharing his voice models
-- **The Piper TTS team** - For building an amazing open-source TTS engine
-- **The Hugging Face community** - For providing the infrastructure
-- **All voice contributors** - For making quality TTS accessible
-
----
-
-**Ready to try the new voices?** Update AgentVibes now!
-
-```bash
-npm install -g agentvibes@latest
-/agent-vibes:provider switch piper
-/agent-vibes:list
-```
-
-[View on Hugging Face](#) | [Download AgentVibes](https://github.com/paulpreibisch/AgentVibes)

package/agentvibes.org/content/blog/getting-started-agentvibes.mdx

@@ -1,228 +0,0 @@
----
-title: "Getting Started with AgentVibes - Quick Installation Guide"
-description: "Learn how to install and configure AgentVibes in minutes. This step-by-step guide covers installation, setup, and your first voice-enabled AI session."
-date: "2025-10-17"
-author: "Paul Preibisch"
-tags: ["tutorial", "installation", "getting-started"]
----
-
-# Getting Started with AgentVibes
-
-Ready to give your AI assistant a voice with personality? AgentVibes brings professional text-to-speech to your coding sessions!
-
-## What is AgentVibes?
-
-AgentVibes was originally built for [Claude Code](https://docs.claude.com/claude-code) using slash commands - a plugin system that lets you extend your AI assistant's capabilities. But we've evolved beyond that.
-
-**Introducing MCP Server Support** - We now include an MCP (Model Context Protocol) server, which is essentially a plugin for AI assistants that enables **natural language control**. Instead of typing slash commands like `/agent-vibes:switch Aria`, you can simply say *"Switch to Aria voice"* and your AI assistant will understand.
-
-This breakthrough means AgentVibes now works with:
-- **Claude Code** - Anthropic's official CLI tool (using slash commands OR MCP)
-- **[Claude Desktop](https://claude.ai/download)** - Anthropic's desktop app (using MCP)
-- **Warp Terminal** - Advanced terminal with AI features (using slash commands)
-
-Think of it as giving your AI assistant the ability to talk back with 150+ voices, 30+ languages, and 19 unique personalities!
-
-## Choose Your Installation Path
-
-### Option 1: Claude Code (Quick Install)
-
-For Claude Code users, installation is a single command:
-
-```bash
-npx agentvibes install
-```
-
-This automatically installs:
-- All slash commands in `.claude/commands/`
-- Voice management hooks in `.claude/hooks/`
-- 19 built-in personalities
-- AgentVibes output style
-
-### Option 2: Claude Desktop (MCP Server)
-
-For Claude Desktop users, you'll need to install as an MCP server.
-
-**Requirements:**
-- Node.js (v14 or higher)
-- Claude Desktop installed
-- ElevenLabs API Key (optional - for premium voices) OR Piper TTS (free)
-
-**Quick setup:**
-- Windows users: Follow the [Windows Installation Guide](https://github.com/paulpreibisch/AgentVibes#windows-installation)
-- Mac/Linux users: Configure the MCP server in your Claude Desktop settings
-
-For detailed MCP setup instructions, see the [GitHub repo installation guide](https://github.com/paulpreibisch/AgentVibes#installation).
-
-### Step 2: Set Your API Key
-
-If you're using ElevenLabs (premium voices), set your API key:
-
-```bash
-export ELEVENLABS_API_KEY="your-api-key-here"
-```
-
-Or add it to your shell profile:
-
-```bash
-echo 'export ELEVENLABS_API_KEY="your-api-key-here"' >> ~/.bashrc
-source ~/.bashrc
-```
-
-**Want to use free voices?** No problem! Switch to Piper TTS:
-
-```bash
-/agent-vibes:provider switch piper
-```
-
-### Step 3: Enable the Output Style
-
-Activate AgentVibes in Claude Code:
-
-```bash
-/output-style agent-vibes
-```
-
-## Your First Voice Session
-
-Now test it out! Ask Claude to do something:
-
-```
-You: "Check git status"
-Claude: "I'll check that git status for you" 🔊
-```
-
-You should hear Claude's response!
-
-## Configuration
-
-### Switch Voices
-
-Try different voices:
-
-```bash
-# List all available voices
-/agent-vibes:list
-
-# Switch to a specific voice
-/agent-vibes:switch Aria
-
-# Preview voices before choosing
-/agent-vibes:preview
-```
-
-### Add Personality
-
-Make Claude more fun:
-
-```bash
-# See all personalities
-/agent-vibes:personality list
-
-# Switch to pirate personality
-/agent-vibes:personality pirate
-
-# Or try sarcastic
-/agent-vibes:personality sarcastic
-```
-
-### Multilingual Support
-
-Want to code in another language?
-
-```javascript
-// Set language
-/agent-vibes:set-language spanish
-
-// Now Claude speaks Spanish!
-// "Voy a revisar ese estado de git para ti"
-```
-
-## MCP Setup (Natural Language Control)
-
-For the best experience, install the AgentVibes MCP server. This lets you control AgentVibes with natural language instead of slash commands.
-
-Add to your `.mcp-minimal.json`:
-
-```json
-{
-  "mcpServers": {
-    "agentvibes": {
-      "command": "npx",
-      "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"],
-      "env": {
-        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
-      }
-    }
-  }
-}
-```
-
-Now just say:
-- "Switch to Northern Terry voice"
-- "Change personality to flirty"
-- "Speak in French"
-
-## Tips & Tricks
-
-### 1. Replay Audio
-
-Missed what Claude said?
-
-```bash
-/agent-vibes:replay
-```
-
-### 2. Adjust Speed
-
-Make it faster or slower:
-
-```bash
-/agent-vibes:set-speed 2x    # Double speed
-/agent-vibes:set-speed 0.5x  # Half speed
-```
-
-### 3. Project-Specific Settings
-
-Each project can have its own voice and personality! Settings are saved in `.claude/` directory.
-
-### 4. Custom Personalities
-
-Create your own:
-
-```bash
-/agent-vibes:personality add mycustom
-```
-
-Edit `.claude/personalities/mycustom.md` to customize.
-
-## Troubleshooting
-
-### No Audio?
-
-1. Check API key: `echo $ELEVENLABS_API_KEY`
-2. Enable output style: `/output-style agent-vibes`
-3. Test: `/agent-vibes:sample Aria`
-
-### Commands Not Found?
-
-Reinstall:
-
-```bash
-npx agentvibes install --yes
-```
-
-### Still Having Issues?
-
-Check our [troubleshooting guide](https://github.com/paulpreibisch/AgentVibes#troubleshooting) or [open an issue](https://github.com/paulpreibisch/AgentVibes/issues).
-
-## What's Next?
-
-- **Explore personalities**: Try all 19 built-in personalities
-- **Language learning**: Enable learning mode to learn Spanish while coding
-- **BMAD integration**: Auto voice switching for BMAD agents
-- **Custom voices**: Add your own ElevenLabs voices
-
----
-
-**Ready for more?** Check out our complete [documentation](https://github.com/paulpreibisch/AgentVibes) →