agentvibes 2.0.17 → 2.0.20

package/docs/bryce-beattie-voice-licensing.md

@@ -0,0 +1,131 @@
+# Bryce Beattie Custom Piper Voices - Licensing Documentation
+
+**Source:** https://brycebeattie.com/files/tts/
+**Date Captured:** 2025-10-17
+**Purpose:** Legal documentation for including custom voices in AgentVibes repository
+
+---
+
+## Creator's Explicit Permission
+
+> "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."
+>
+> — Bryce Beattie
+
+**Source URL:** https://brycebeattie.com/files/tts/
+
+---
+
+## Voices We're Including
+
+### 1. Kristin
+- **Type:** US English female
+- **License:** Public Domain
+- **Training:** 2000 epochs on medium quality settings
+- **Dataset:** ~11.5 hours from public domain LibriVox.org recordings
+- **Download Links:**
+  - .onnx: https://sfo3.digitaloceanspaces.com/bkmdls/kristin.onnx
+  - .json: https://sfo3.digitaloceanspaces.com/bkmdls/kristin.onnx.json
+
+### 2. Jenny (Dioco)
+- **Type:** UK English female (Irish accent)
+- **License:** CC BY (Attribution required)
+- **Attribution Note:** Similar to Creative Commons Attribution
+- **Original Source:** Kaggle dataset (details on source page)
+- **Download Links:**
+  - .onnx: https://sfo3.digitaloceanspaces.com/bkmdls/jenny.onnx
+  - .json: https://sfo3.digitaloceanspaces.com/bkmdls/jenny.onnx.json
+
+### 3. ManyVoice
+- **Type:** Multi-speaker (16 voices: 12 US English, 4 UK English)
+- **License:** Public Domain
+- **Training:** 400 epochs on medium quality settings
+- **Dataset:** ~8 hours per voice from public domain LibriVox recordings with sound quality enhancements
+- **Download Links:**
+  - .onnx: https://sfo3.digitaloceanspaces.com/bkmdls/mv2.onnx
+  - .json: https://sfo3.digitaloceanspaces.com/bkmdls/mv2.onnx.json
+
+---
+
+## License Compatibility with Apache 2.0
+
+### Public Domain Voices (Kristin, ManyVoice)
+✅ **Fully compatible** - No restrictions on redistribution, modification, or commercial use
+
+### CC BY Licensed Voice (Jenny)
+✅ **Compatible** - Requires attribution:
+- Include credit to Bryce Beattie
+- Link to source: https://brycebeattie.com/files/tts/
+- Mention CC BY license
+- Already added to AgentVibes README and credits
+
+---
+
+## Legal Basis for Inclusion in AgentVibes Repository
+
+1. **Explicit Permission:** Creator granted blessing for redistribution
+2. **Public Domain:** Kristin and ManyVoice have no licensing restrictions
+3. **CC BY Compliance:** Jenny voice attributed properly in:
+   - README.md (Useful Links section)
+   - README.md (Credits/Special Thanks)
+   - VOICE_CREDITS.md (dedicated attribution file)
+4. **Apache 2.0 Compatibility:** All licenses compatible with our project license
+
+---
+
+## Attribution Requirements
+
+### For Jenny Voice (CC BY):
+```
+Jenny voice by Bryce Beattie
+Source: https://brycebeattie.com/files/tts/
+License: CC BY (Creative Commons Attribution)
+Original dataset: Dioco dataset (Kaggle)
+```
+
+### For Kristin and ManyVoice (Public Domain):
+```
+Kristin and ManyVoice by Bryce Beattie
+Source: https://brycebeattie.com/files/tts/
+License: Public Domain
+Dataset: LibriVox.org public domain recordings
+```
+
+---
+
+## File Locations in AgentVibes
+
+- Voice models: `mcp-server/voices/` (to be created)
+- Download script: `.claude/hooks/piper-download-voices.sh`
+- Credits: `README.md` and `VOICE_CREDITS.md`
+
+---
+
+## Additional Voices Available (Not Included)
+
+Other voices available from Bryce Beattie that we chose not to include:
+- LJSpeech (medium and high)
+- Cori (high and medium)
+- John
+- Norman
+- Clean 100 (excluded per user preference)
+
+---
+
+## Notes
+
+- All voice models are ONNX format for Piper TTS
+- Each voice includes .onnx model file and .onnx.json config file
+- Voices trained on LibriVox public domain audiobooks
+- Sound quality enhancements applied during training
+- Compatible with Piper TTS engine (https://github.com/rhasspy/piper)
+
+---
+
+## Legal Disclaimer
+
+This documentation represents our good-faith interpretation of the licensing information provided by Bryce Beattie. The explicit permission granted ("you have my blessing") combined with Public Domain and CC BY licenses provides clear legal basis for inclusion in the AgentVibes repository under Apache 2.0 license.
+
+**Date of Legal Review:** 2025-10-17
+**Reviewed By:** AgentVibes Project Team
+**Status:** ✅ Approved for inclusion with proper attribution

package/docs/commands.md

@@ -6,8 +6,9 @@ All commands are prefixed with `/agent-vibes:`
 
 | Command | AgentVibes MCP Equivalent | Description |
 |---------|----------------|-------------|
-| `/agent-vibes:list` | "List all voices" or "What voices are available?" | Show all available voices |
+| `/agent-vibes:list` | "List all voices" or "What voices are available?" | Show all available voices (expands multi-speaker voices) |
 | `/agent-vibes:switch <voice>` | "Switch to Aria voice" or "Change voice to Cowboy Bob" | Change to a different voice |
+| `/agent-vibes:switch <voice>#<speaker>` | "Switch to 16Speakers#15" or "Use Kristin from 16Speakers" | Switch to specific speaker in multi-speaker voice |
 | `/agent-vibes:whoami` | "What's my current voice?" or "Show my configuration" | Show current voice, sentiment & personality |
 | `/agent-vibes:preview [N]` | "Preview voices" or "Let me hear the first 5 voices" | Preview voices with audio samples |
 | `/agent-vibes:sample <voice>` | "Test Aria voice" or "Let me hear Cowboy Bob" | Test a specific voice |
@@ -15,6 +16,25 @@ All commands are prefixed with `/agent-vibes:`
 | `/agent-vibes:replay [N]` | "Replay last message" or "Replay the 3rd message" | Replay recent TTS audio |
 | `/agent-vibes:get` | "What voice am I using?" or "Get current voice" | Get currently selected voice |
 
+### Multi-Speaker Voices
+
+AgentVibes supports multi-speaker Piper voices that contain multiple voice personalities in one model:
+
+- **16Speakers** - Contains 16 different voices (Cori, Kara, Kristin, Maria, Mike, Mark, Michael, James, Rose, progressingamerica, Steve, Owlivia, Paul, Jennifer, Emily, Martin)
+
+**Usage:**
+```bash
+# List all speakers in a multi-speaker voice
+/agent-vibes:list
+
+# Switch to a specific speaker (0-based index)
+/agent-vibes:switch 16Speakers#0   # Cori Samuel
+/agent-vibes:switch 16Speakers#2   # Kristin Hughes
+/agent-vibes:switch 16Speakers#15  # Martin Clifton
+```
+
+The list command will show all available speakers with their names and IDs, marking your current selection with `▶`.
+
 ## System Commands
 
 | Command | AgentVibes MCP Equivalent | Description |

package/docs/mcp-setup.md

@@ -26,12 +26,7 @@ Instead of remembering slash commands like `/agent-vibes:switch Aria`, just say:
 
 ### For Claude Desktop
 
-**⚠️ IMPORTANT Requirements:**
-
-- **Windows:** WSL (Windows Subsystem for Linux) must be enabled
-- **Python 3:** Must be installed on your system ([Download Python](https://www.python.org/downloads/))
-  - The MCP server will automatically install Python packages (mcp, pipx, Piper TTS)
-  - But Python 3 itself must be installed first by you
+**📖 Read This First:** If you haven't installed Claude Desktop yet, [click here for the Windows Setup Guide](../mcp-server/WINDOWS_SETUP.md) - it covers WSL setup, Python installation, and all prerequisites.
 
 **Step 1: Set Your ElevenLabs API Key (Windows)**
 

package/github-star-reminder.txt

@@ -0,0 +1 @@
+20251017

package/linkedin/vibe-coding-and-pulseaudio.md

@@ -0,0 +1,121 @@
+# Vibe Coding: How PulseAudio Can Give Your Remote SSH Session a Voice!
+
+My mornings and late evenings are when I'm at my creative peak. I like to use this time for things that are fun—or at least that I think are fun. Since I recently created AgentVibes (a way to make my computer speak back to me), I wanted to solve a limitation I was experiencing while working on a remote server. That curiosity led me down the PulseAudio rabbit hole, and what I discovered fundamentally changed how I code with AI.
+
+## What is "Vibe Coding"?
+
+According to Gene Kim, a researcher and author featured in the DORA report, **"vibe coding"** is defined as any form of coding where you don't type out code by hand. Instead of manual typing, the code emerges from an **iterative conversation with an AI**.
+
+This is the future of software development. Not replacing developers, but amplifying our capabilities through natural dialogue.
+
+## If We're Going to Have a Conversation, Let's Use Voice
+
+When I discovered whisper typing several months ago, it fundamentally changed the way I use my computer. Rather than typing everything to my AI assistant, I now **talk** using whisper typing. The speed, the naturalness, the flow—it was transformative.
+
+But then a thought struck me: **If I can talk to my computer, why can't it talk back?**
+
+That question led me to create [**AgentVibes**](https://github.com/paulpreibisch/AgentVibes)—a plugin for Claude Code that brings professional text-to-speech narration to your AI coding sessions. Your AI assistant can now acknowledge your requests, confirm task completion, and provide feedback through voice.
+
+Imagine this workflow:
+- You speak your coding request using whisper typing
+- Your AI assistant acknowledges with voice: "I'll refactor that authentication module for you"
+- You continue working while hearing real-time progress updates
+- The AI confirms: "Refactoring complete, all tests passing"
+
+This is vibe coding at its finest—a natural, conversational flow between human and AI.
+
+## The Remote Server Problem
+
+But I discovered a limitation. Since text-to-speech typically executes on the computer you're programming on, **what happens when you're programming on a remote machine via SSH?**
+
+This is the reality for many developers:
+- Cloud development environments
+- Powerful remote servers
+- Team shared infrastructure
+- Corporate VDI setups
+
+The audio plays on the remote server—where you can't hear it. The conversational flow breaks down. The vibe is lost.
+
+## Enter PulseAudio: The Hidden Hero
+
+I went to task trying to figure out if there was a way to somehow play audio from a remote machine onto my local machine. That's when I was introduced to the true capabilities of **PulseAudio**.
+
+Now, I've been a Linux user for many years and have used PulseAudio forever. But little did I know that **PulseAudio can actually stream audio over a network**, allowing a client to play audio from a remote server.
+
+This completely blew my mind. 🤯
+
+Here's what makes this powerful:
+
+### The Architecture
+```
+Remote Linux Server (PulseAudio)
+    ↓ SSH Reverse Tunnel
+Windows Client (WSL/RDP Audio)
+    ↓
+Local Speakers 🔊
+```
+
+### What This Enables
+- Run AgentVibes on your remote server
+- Hear TTS announcements on your local speakers
+- Maintain the conversational flow of vibe coding
+- Work from anywhere with full audio feedback
+
+I'll tell you, I was **floored** that this was even possible.
+
+## The Game-Changing Impact
+
+The ability to have your AI assistant **acknowledge what you've typed and provide vocal confirmation** really does change the game when vibe coding.
+
+Here's why it matters:
+
+**1. Cognitive Offloading**
+You don't need to constantly check the terminal to see if your AI understood. Voice acknowledgment lets you focus on problem-solving.
+
+**2. Natural Flow State**
+Conversations have rhythm. When both parties speak and listen, you stay in flow. Text-only breaks that rhythm.
+
+**3. Active Guidance with Voice Feedback**
+Vibe coding doesn't mean you stop paying attention—quite the opposite. You're actively guiding the AI through the implementation, reviewing its decisions, and course-correcting in real-time. Voice acknowledgment keeps you in the loop while your hands stay free to sketch architecture, review documentation, or reference other code. The conversation is continuous, and if you're an experienced developer, the depth and precision of that conversation becomes truly transformative.
+
+**4. Reduced Context Switching**
+No need to constantly alt-tab between terminal and code. Your ears keep you updated.
+
+## Try It Yourself
+
+Want to experience vibe coding with remote audio? I've documented the entire setup process.
+
+**Check out AgentVibes:**
+📦 GitHub: [github.com/paulpreibisch/AgentVibes](https://github.com/paulpreibisch/AgentVibes)
+
+**Remote Audio Setup Guide:**
+📚 Complete documentation: [Remote Audio Setup](https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md)
+
+The setup includes:
+- Automated scripts for Linux and Windows
+- PulseAudio network configuration
+- SSH tunnel setup
+- Troubleshooting guides
+- VS Code Remote-SSH integration
+
+It took me a morning to figure out, but now you can set it up in 10 minutes.
+
+## The Bigger Picture
+
+This journey taught me something important: **The best developer tools emerge from solving real problems in your own workflow.**
+
+I didn't set out to become a PulseAudio expert. I just wanted my AI assistant to talk back when I'm working on remote servers. The solution required diving deep into audio streaming, SSH tunneling, and network protocols—but the result is worth it.
+
+Vibe coding isn't just about AI generating code. It's about creating an **environment where human and AI collaborate naturally**—through conversation, through voice, through continuous feedback loops.
+
+And sometimes, that requires discovering that the tools you've been using for years have hidden superpowers you never knew existed.
+
+---
+
+**What's your experience with AI-assisted development? Have you tried vibe coding? Let's discuss in the comments!**
+
+#VibeCoding #AI #DeveloperTools #SoftwareEngineering #PulseAudio #RemoteDevelopment #DevOps #AIAssisted #ClaudeCode #OpenSource
+
+---
+
+*P.S. - If you found this interesting, check out the AgentVibes project on GitHub. It's open source, supports multiple TTS providers (including free Piper TTS), and has 30+ professional AI voices. Star the repo if you find it useful!* ⭐