Настройка PortAudio (Микрофон)

Функция Живой перевод использует пакет Python sounddevice, который опирается на C-библиотеку PortAudio для доступа к микрофонам во всех операционных системах. Большинству пользователей необходимо установить эту системную зависимость.

Windows

Предварительно скомпилированные пакеты (wheels) для sounddevice и PyAudio обычно включают двоичный файл PortAudio в Windows. Ручная установка в системе обычно не требуется. Если вы столкнулись с ошибками, убедитесь, что ваши аудиодрайверы обновлены.

macOS

Используйте Homebrew для установки PortAudio:

brew install portaudio

Linux

Название пакета зависит от вашего дистрибутива. Пакет для разработки (обычно оканчивающийся на -dev или -devel) должен быть установлен, чтобы Python мог собрать привязки C, если предварительно скомпилированный wheel недоступен.

Ubuntu / Debian / MintFedora / RHELArch Linux

sudo apt-get install portaudio19-dev

sudo dnf install portaudio-devel

sudo pacman -S portaudio

Устранение неполадок

Если приложение продолжает сообщать, что не может получить доступ к микрофону после установки:

1. Убедитесь, что вашему приложению терминала (или среде рабочего стола) разрешен доступ к микрофону (особенно в macOS).
2. Перезапустите приложение (или терминал/сервер MCP), чтобы оно подхватило новый путь к библиотеке.