agentvibes 2.0.17 → 2.0.18

package/docs/ai-optimized-documentation-standards.md

@@ -20,6 +20,37 @@ Every file must begin with a comprehensive context header that provides AI assis
 
 ```javascript
 /**
+ * File: [path/to/file.js]
+ *
+ * AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+ * Website: https://agentvibes.org
+ * Repository: https://github.com/paulpreibisch/AgentVibes
+ *
+ * Co-created by Paul Preibisch with Claude AI
+ * Copyright (c) 2025 Paul Preibisch
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * express or implied, including but not limited to the warranties of
+ * merchantability, fitness for a particular purpose and noninfringement.
+ * In no event shall the authors or copyright holders be liable for any claim,
+ * damages or other liability, whether in an action of contract, tort or
+ * otherwise, arising from, out of or in connection with the software or the
+ * use or other dealings in the software.
+ *
+ * ---
+ *
  * @fileoverview [Brief description]
  * @context [Why this exists, what problem it solves]
  * @architecture [How it fits in the system, patterns used]
@@ -58,6 +89,33 @@ Every file must begin with a comprehensive context header that provides AI assis
 
 ```bash
 #!/bin/bash
+#
+# File: .claude/hooks/play-tts-elevenlabs.sh
+#
+# AgentVibes - Professional Text-to-Speech for AI Assistants
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied. Use at your own risk. See the Apache License for details.
+#
+# ---
+#
 # @fileoverview ElevenLabs TTS provider implementation
 # @context Handles all ElevenLabs API interactions for voice synthesis
 # @architecture Provider interface implementation, follows play-tts.sh contract
@@ -297,10 +355,26 @@ When writing new code:
 
 - **Source PRD**: `docs/prd.md` (Multi-Provider TTS System)
 - **Example Implementation**: `.claude/hooks/play-tts.sh`, `provider-manager.sh`
-- **GitHub Issue**: #25 (Multi-Provider TTS Feature)
+- **GitHub Repository**: https://github.com/paulpreibisch/AgentVibes
+- **Project Website**: https://agentvibes.org
 
 ---
 
-**Generated from**: AgentVibes Multi-Provider TTS System PRD v1.0
-**Extracted by**: John (PM)
-**Date**: 2025-01-05
+## Document Information
+
+**AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!**
+
+- **Website**: https://agentvibes.org
+- **Repository**: https://github.com/paulpreibisch/AgentVibes
+- **Co-created by**: Paul Preibisch with Claude AI
+- **Copyright**: © 2025 Paul Preibisch
+- **License**: Apache-2.0
+- **Version**: 1.0
+- **Last Updated**: 2025-01-17
+
+---
+
+**DISCLAIMER**: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
+
+For full license terms, see the LICENSE file in the project root or visit:
+http://www.apache.org/licenses/LICENSE-2.0

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