gptsovits-tts

Manage GPT-SoVITS v2pro TTS API lifecycle and model weights in WSL2+Windows.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/lxt070409/hermes-skills --skill gptsovits-tts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gptsovits-tts
Source: https://github.com/lxt070409/hermes-skills/tree/main/mlops/gptsovits-tts
Command: npx skills add https://github.com/lxt070409/hermes-skills --skill gptsovits-tts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the operation and debugging of GPT-SoVITS v2pro TTS in hybrid WSL2+Windows environments, providing API lifecycle management, model version conflict resolution, and troubleshooting guidance.

Core Features & Use Cases

  • API Lifecycle Management: Offers detailed instructions for starting, setting weights, and shutting down the TTS API.
  • Model Version Conflict Resolution: Provides a guide to resolve model version mismatches leading to errors.
  • Soundfile Workaround: Offers a solution for soundfile write failures on Windows.
  • Chinese Path Handling: Guides on handling Chinese character paths in API calls.
  • Use Case: Ideal for users who need to generate high-quality TTS output in Chinese with fine-grained control over the TTS process.

Quick Start

Use the gptsovits-tts skill to set the GPT weights for '爱莉希雅' character and generate a TTS output for the text '嗨想我了吗?不论何时何地,爱莉希雅都会回应你的期待。'.

Frequently Asked Questions about gptsovits-tts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage the GPT-SoVITS TTS API lifecycle in a WSL2 and Windows hybrid environment?

To manage the GPT-SoVITS TTS API lifecycle in a WSL2 and Windows hybrid environment, use this skill to handle API startup, model weight switching, and shutdown procedures. It provides detailed instructions for cross-platform operation and troubleshooting.

Why does GPT-SoVITS v2pro throw model version mismatch errors when switching weights?

GPT-SoVITS v2pro throws model version mismatch errors due to conflicts between loaded and target weights. This skill provides specific resolution guides to align model versions and successfully restore the TTS engine operation.

How do I fix soundfile write failures when running GPT-SoVITS TTS on Windows?

To fix soundfile write failures when running GPT-SoVITS TTS on Windows, apply the specific workaround provided within this skill. It addresses file system permission and path issues to ensure audio output saves correctly.

Can I use Chinese character paths in GPT-SoVITS API v2 calls?

Yes, you can use Chinese character paths in GPT-SoVITS API v2 calls. This skill offers specific guidance on handling and encoding Chinese paths to prevent request failures during cross-lingual TTS generation.

Do I need a specific Python environment to run GPT-SoVITS v2pro for cross-lingual TTS?

Yes, you need a configured Python environment and specific model weights to run GPT-SoVITS v2pro for cross-lingual TTS. This skill requires these dependencies to manage the API and generate high-quality Chinese audio.