skills-vault/skills/voice-generation/INSTALL.md

78 lines
2.0 KiB
Markdown

# Install voice-generation
`voice-generation` provides the `voice-gen` Python CLI and a Skill wrapper for Agentic tools.
## Conda Environment
Use the repository-level `skills-vault` Conda environment.
```powershell
conda env create -f environment.yml
conda activate skills-vault
```
If the environment already exists:
```powershell
conda activate skills-vault
```
This Skill does not currently require a dedicated Conda environment. Create one only if future dependencies conflict with the shared `skills-vault` environment.
## Install Python Package
From the repository root:
```powershell
pip install -e .\skills\voice-generation
```
If the current shell has not activated the environment, use the environment Python directly:
```powershell
C:\Users\wangq\.conda\envs\skills-vault\python.exe -m pip install -e .\skills\voice-generation
```
## External Requirements
Install and authenticate MiniMax `mmx`:
```powershell
npm install -g mmx-cli
mmx auth login
```
## Install Skill Wrapper
Use the repository installer from the repository root:
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -Skill voice-generation
```
Replace an existing installed copy after backing it up:
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -Skill voice-generation -Force -InstallClaudeLink
```
## Test
Testing is intentionally separate from migration.
Run unit tests only after installation is ready:
```powershell
New-Item -ItemType Directory -Force -Path .\tmp | Out-Null
python -m pytest .\skills\voice-generation\tests --basetemp .\tmp\pytest-voice-generation
```
Or without activating the environment:
```powershell
New-Item -ItemType Directory -Force -Path .\tmp | Out-Null
C:\Users\wangq\.conda\envs\skills-vault\python.exe -m pytest .\skills\voice-generation\tests --basetemp .\tmp\pytest-voice-generation
```
Smoke tests may call real MiniMax services and consume quota. Do not run them unless explicitly requested.