# 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.