# offline-voice

Скилл offline-voice для Claude Code объясняет настройку локального движка озвучки VieNeu-TTS и клонирования голоса. Включается при отладке маршрутов /api/tts и озвучки видео.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 147 у репозитория
- Автор: notivn
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/notivn/AIEVv2/tree/HEAD/.claude/skills/offline-voice/SKILL.md
- Обновлён: 2026-11-13
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/offline-voice

## Что делает

Описывает устройство локального синтеза речи VieNeu-TTS v3 Turbo и клонирования по 3–8 секундам сэмпла, разделяя бесплатный офлайн-движок и вызовы к облачному API Gemini.

Разделяет установку на два независимых уровня. Для воспроизведения пресетов нужен пакет `pip install vieneu` на базе ONNX Runtime без Torch, что занимает около 30 МБ. Клонирование голоса требует дополнительной установки пакетов `torch` и `torchaudio` весом 2–3 ГБ. Первый запуск синтеза скачивает веса модели объёмом около 1 ГБ из Hugging Face.

Содержит готовые решения известных системных сбоев: подмену `torchaudio.load` через библиотеку `soundfile` для обхода ошибки `TorchCodec` на статических сборках FFmpeg, ограничение версии `av>=11,<17` для работы `faster-whisper` и позиционный парсинг региональных меток во избежание омонимов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add notivn/AIEVv2 --skill offline-voice -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/offline-voice/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/offline-voice/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add notivn/AIEVv2 --skill offline-voice -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/offline-voice/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add notivn/AIEVv2 --skill offline-voice -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/offline-voice/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install notivn/AIEVv2 .claude/skills/offline-voice
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/offline-voice/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add notivn/AIEVv2 --skill offline-voice -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/notivn/AIEVv2 --path .claude/skills/offline-voice
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/offline-voice/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/notivn/AIEVv2/tree/HEAD/.claude/skills/offline-voice/SKILL.md

## Когда брать
- настроить локальную озвучку VieNeu-TTS без облачных API
- обойти ошибку TorchCodec при клонировании голоса
- устранить конфликт библиотек PyAV и faster-whisper
- разобрать метаданные голосов без путаницы региона и пола

## Примеры запросов агенту
- Почему генерация голоса VieNeu возвращает ошибку 503 LOAD_FAILED?
- Как настроить клонирование голоса в /api/tts без установки пакетов Torch для всех пользователей?
- Примени monkeypatch для torchaudio через soundfile при загрузке референсного аудио.

## Похожие
- [voicebox-voice-synthesis](https://affpapa.org/nevibecode/skills/voicebox-voice-synthesis.md) — скилл · 1400 установок
- [resemble-chatterbox](https://affpapa.org/nevibecode/skills/resemble-chatterbox.md) — скилл · 175 установок
- [venice-audio-speech](https://affpapa.org/nevibecode/skills/veniceai-venice-audio-speech.md) — скилл · ★ 176 у репозитория
- [listenhub-voice](https://affpapa.org/nevibecode/skills/listenhub-voice.md) — скилл · 174 установки
- [voice-clone](https://affpapa.org/nevibecode/skills/voice-clone.md) — скилл · 105 установок
- [chat-with-anyone](https://affpapa.org/nevibecode/skills/chat-with-anyone.md) — скилл · 2100 установок

Из того же набора: [notivn/aievv2](https://affpapa.org/nevibecode/by/notivn/aievv2.md) — 15 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
