Процесс сборки колеса для pyaudio (pyproject.toml) не завершился успешно.

Вопрос или проблема

C:\Users\Admin>pip install pyaudio
По умолчанию установка для пользователя, так как обычные site-packages недоступны для записи
Сборка pyaudio
  Используется кэшированный PyAudio-0.2.14.tar.gz (47 кБ)
  Установка зависимостей сборки ... завершено
  Получение требований для сборки колеса ... завершено
  Подготовка метаданных (pyproject.toml) ... завершено
Сборка колес для собранных пакетов: pyaudio
  Создание колеса для pyaudio (pyproject.toml) ... ошибка
  ошибка: подпроцесс завершился с ошибкой

  × Создание колеса для pyaudio (pyproject.toml) не прошло успешно.
  │ Код выхода: 1
  ╰─> [9 строк вывода]
      WARNING:root:Предупреждение: переменная окружения VCPKG_PATH не установлена.
      INFO:root:Запуск bdist_wheel
      INFO:root:Запуск сборки
      INFO:root:Запуск build_py
      INFO:root:Создание build\lib.win-amd64-cpython-313\pyaudio
      INFO:root:Копирование src\pyaudio\__init__.py -> build\lib.win-amd64-cpython-313\pyaudio
      INFO:root:Запуск build_ext
      INFO:root:Сборка расширения 'pyaudio._portaudio'
      ошибка: требуется Microsoft Visual C++ 14.0 или новее. Получите его с помощью "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
      [конец вывода]

  Примечание: Эта ошибка возникла из подпроцесса и, вероятно, не является проблемой с pip.
  ERROR: Не удалось собрать колесо для pyaudio
Не удалось собрать pyaudio
ERROR: ERROR: Не удалось собрать устанавливаемые колеса для некоторых проектов на основе pyproject.toml (pyaudio)

Ответ или решение

Установка библиотеки PyAudio может вызывать сложности у разработчиков, особенно если они пытаются установить её через pip в среде Windows. Ваша ошибка указывает на то, что сборка колеса (wheel) для PyAudio не удалась из-за отсутствия необходимых инструментов для сборки. Давайте разберёмся с этой проблемой шаг за шагом.

Причины ошибки

Сначала важно понять, что PyAudio зависит от библиотеки PortAudio, и для её сборки требуется компилятор C++. В частности, сообщение об ошибке гласит следующее:

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

Это означает, что недостаточно просто установить PyAudio; вам необходимо также установить Microsoft Visual C++ Build Tools для компиляции исходного кода.

Решение проблемы

1. Установка Microsoft Visual C++ Build Tools:

   • Перейдите по ссылке на Visual Studio.
   • Скачайте и установите инструменты сборки.
   • Во время установки выберите компоненты, относящиеся к "Desktop development with C++", включая MSVC v142 или новее.

2. Безопасный альтернативный метод установки:
   Если установка компилятора по каким-то причинам невозможна или вы хотите упростить процесс, рекомендуется воспользоваться уже скомпилированным пакетом PyAudio, который можно установить с помощью pip:

   • Перейдите на сайт Unofficial Windows Binaries for Python Extension Packages.
   • Скачайте соответствующий .whl файл для вашей версии Python и архитектуры (x86 или x64).
   • Установите пакет, используя pip:

     pip install путь_к_скачанному_файлу.whl

3. Проверка установки:
   После завершения установки PyAudio, рекомендуется проверить, правильно ли он установлен:

   import pyaudio

   Если при выполнении этого кода не возникает ошибок, значит установка прошла успешно.

Вывод

Установка PyAudio может стать проблемой из-за отсутствия необходимых инструментов для его сборки. Убедитесь, что у вас установлены Microsoft Visual C++ Build Tools, или воспользуйтесь предварительно скомпилированными библиотеками для ускорения и упрощения процесса установки. Следуя вышеописанным шагам, вы сможете успешно справиться с этой проблемой и продолжить работу над вашим проектом.