n8n-nodes-kokoro

This is an n8n community node that integrates Kokoro TTS for high-quality text-to-speech synthesis.

n8n is a fair-code licensed workflow automation platform.

Features

• 🎙️ High-quality text-to-speech using Kokoro TTS (kokoro-js)
• 🗣️ Multiple voice options (11+ voices)
• 🌍 Multi-language support
• ⚡ Speed control
• 📦 Binary data output for easy workflow integration
• 💾 Optional file output mode
• 🔄 Batch processing support

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-kokoro in the npm package field
4. Click Install
5. Restart n8n

Manual Installation

For local development or custom n8n installations:

# Navigate to your n8n custom nodes directory
cd ~/.n8n/custom

# Clone or copy this repository
git clone https://github.com/yourusername/n8n-nodes-kokoro.git
cd n8n-nodes-kokoro

# Install dependencies
npm install

# Build the node
npm run build

Operations

Generate Speech

Converts text to speech using Kokoro TTS.

Parameters

• Text (required): The text to convert to speech
• Voice: Choose from 11+ available voices including:
  • American Female: Heart, Bella, Nicole, Sarah, Sky
  • American Male: Adam, Michael
  • British Female: Emma, Isabella
  • British Male: George, Lewis
• Output Mode:
  • Binary Data (recommended): Returns audio as binary data for use in workflows
  • Save to File: Saves audio to a specified file path

Additional Options

• Speed: Control speech speed (0.5x to 2.0x)
• Language: Specify language for better pronunciation (auto-detect by default)

Usage Examples

Example 1: Generate Speech and Save to Binary

1. Add Kokoro TTS node
2. Set Text: "Hello, this is a test of Kokoro TTS"
3. Select Voice: "AF (Heart)"
4. Set Output Mode: "Binary Data"
5. Connect to other nodes (e.g., Send Email, Upload to Cloud Storage)

Example 2: Batch Processing from Spreadsheet

1. Google Sheets node → Read rows with text
2. Kokoro TTS node → Generate speech for each row
3. Dropbox node → Upload audio files to Dropbox

Example 3: Voice Notifications

1. Webhook node → Receive notification text
2. Kokoro TTS node → Convert to speech
3. Twilio node → Send as voice message

Technical Details

• Uses kokoro-js library for TTS generation
• Runs on CPU with FP32 precision
• Outputs WAV format audio
• Model: onnx-community/Kokoro-82M-v1.0-ONNX

Compatibility

• n8n version: 1.0.0 or higher
• Node.js version: 18.0.0 or higher

Resources

• n8n community nodes documentation
• Kokoro TTS on Hugging Face
• kokoro-js GitHub

Development

Setup

npm install

Build

npm run build

Lint

npm run lint
npm run lintfix  # Auto-fix issues

Format

npm run format

Version History

1.0.0

• Initial release
• Text to speech generation
• Multiple voice support
• Binary data and file output modes
• Speed and language controls

License

MIT

Support

If you encounter issues or have questions:

1. Check the n8n documentation
2. Visit the n8n community forum
3. Create an issue on GitHub

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This is a community node and is not officially maintained by n8n. Use at your own discretion.