Will not install

[OldComputerGuy]

On installation: using "pip install stable-audio-tools" in an active env.
The installer tries to install the dep for "PyWavelet 1.4.1", which is not found and causes an error. (See Below)
--- Console Log ---
(venv) C:\Users\Test\Desktop\StableAudioOpen>pip install stable-audio-tools
Collecting stable-audio-tools
Using cached stable_audio_tools-0.0.19-py3-none-any.whl.metadata (1.3 kB)
Collecting alias-free-torch==0.0.6 (from stable-audio-tools)
Using cached alias_free_torch-0.0.6-py3-none-any.whl.metadata (3.8 kB)
Collecting auraloss==0.4.0 (from stable-audio-tools)
Using cached auraloss-0.4.0-py3-none-any.whl.metadata (8.0 kB)
Collecting descript-audio-codec==1.0.0 (from stable-audio-tools)
Using cached descript_audio_codec-1.0.0-py3-none-any.whl.metadata (7.8 kB)
Collecting einops (from stable-audio-tools)
Using cached einops-0.8.1-py3-none-any.whl.metadata (13 kB)
Collecting einops-exts (from stable-audio-tools)
Using cached einops_exts-0.0.4-py3-none-any.whl.metadata (621 bytes)
Collecting ema-pytorch==0.2.3 (from stable-audio-tools)
Using cached ema_pytorch-0.2.3-py3-none-any.whl.metadata (693 bytes)
Collecting encodec==0.1.1 (from stable-audio-tools)
Using cached encodec-0.1.1.tar.gz (3.7 MB)
Preparing metadata (setup.py) ... done
Collecting gradio>=5.20.0 (from stable-audio-tools)
Using cached gradio-5.29.1-py3-none-any.whl.metadata (16 kB)
Collecting huggingface_hub (from stable-audio-tools)
Using cached huggingface_hub-0.31.2-py3-none-any.whl.metadata (13 kB)
Collecting importlib-resources==5.12.0 (from stable-audio-tools)
Using cached importlib_resources-5.12.0-py3-none-any.whl.metadata (4.1 kB)
Collecting k-diffusion==0.1.1 (from stable-audio-tools)
Using cached k_diffusion-0.1.1-py3-none-any.whl.metadata (3.9 kB)
Collecting laion-clap==1.1.4 (from stable-audio-tools)
Using cached laion_clap-1.1.4-py3-none-any.whl.metadata (26 kB)
Collecting local-attention==1.8.6 (from stable-audio-tools)
Using cached local_attention-1.8.6-py3-none-any.whl.metadata (684 bytes)
Collecting pandas==2.0.2 (from stable-audio-tools)
Using cached pandas-2.0.2.tar.gz (5.3 MB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Preparing metadata (pyproject.toml) ... done
Collecting prefigure==0.0.9 (from stable-audio-tools)
Using cached prefigure-0.0.9-py3-none-any.whl.metadata (5.9 kB)
Collecting pytorch_lightning==2.1.0 (from stable-audio-tools)
Using cached pytorch_lightning-2.1.0-py3-none-any.whl.metadata (23 kB)
Collecting PyWavelets==1.4.1 (from stable-audio-tools)
Using cached PyWavelets-1.4.1.tar.gz (4.6 MB)
Installing build dependencies ... done
Getting requirements to build wheel ... error
error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> [33 lines of output]
Traceback (most recent call last):
File "C:\Users\Test\Desktop\StableAudioOpen\venv\Lib\site-packages\pip_vendor\pyproject_hooks_in_process_in_process.py", line 389, in
main()
File "C:\Users\Test\Desktop\StableAudioOpen\venv\Lib\site-packages\pip_vendor\pyproject_hooks_in_process_in_process.py", line 373, in main
json_out["return_val"] = hook(**hook_input["kwargs"])
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\Test\Desktop\StableAudioOpen\venv\Lib\site-packages\pip_vendor\pyproject_hooks_in_process_in_process.py", line 137, in get_requires_for_build_wheel
backend = _build_backend()
^^^^^^^^^^^^^^^^
File "C:\Users\Test\Desktop\StableAudioOpen\venv\Lib\site-packages\pip_vendor\pyproject_hooks_in_process_in_process.py", line 70, in build_backend
obj = import_module(mod_path)
^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Python312\Lib\importlib_init.py", line 90, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "", line 1387, in _gcd_import
File "", line 1360, in _find_and_load
File "", line 1310, in _find_and_load_unlocked
File "", line 488, in _call_with_frames_removed
File "", line 1387, in _gcd_import
File "", line 1360, in _find_and_load
File "", line 1331, in _find_and_load_unlocked
File "", line 935, in load_unlocked
File "", line 995, in exec_module
File "", line 488, in call_with_frames_removed
File "C:\Users\Test\AppData\Local\Temp\pip-build-env-mhz29vx7\overlay\Lib\site-packages\setuptools_init.py", line 16, in
import setuptools.version
File "C:\Users\Test\AppData\Local\Temp\pip-build-env-mhz29vx7\overlay\Lib\site-packages\setuptools\version.py", line 1, in
import pkg_resources
File "C:\Users\Test\AppData\Local\Temp\pip-build-env-mhz29vx7\overlay\Lib\site-packages\pkg_resources_init.py", line 2191, in
register_finder(pkgutil.ImpImporter, find_on_path)
^^^^^^^^^^^^^^^^^^^
AttributeError: module 'pkgutil' has no attribute 'ImpImporter'. Did you mean: 'zipimporter'?
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

--- End Console Log ---

[dattazigzag]

System

                    'c.          saurabhdatta@Mac.lan
                 ,xNMM.          --------------------
               .OMMMMo           OS: macOS 15.4.1 24E263 arm64
               OMMM0,            Host: Mac15,10
     .;loddo:' loolloddol;.      Kernel: 24.4.0
   cKMMMMMMMMMMNWMMMMMMMMMM0:    Uptime: 17 days, 1 hour, 1 min
 .KMMMMMMMMMMMMMMMMMMMMMMMWd.    Packages: 252 (brew)
 XMMMMMMMMMMMMMMMMMMMMMMMX.      Shell: fish 4.0.2
;MMMMMMMMMMMMMMMMMMMMMMMM:       Resolution: 1920x1080, 1080x1920, 1920x1080, 1280x1024
:MMMMMMMMMMMMMMMMMMMMMMMM:       DE: Aqua
.MMMMMMMMMMMMMMMMMMMMMMMMX.      WM: Quartz Compositor
 kMMMMMMMMMMMMMMMMMMMMMMMMWd.    WM Theme: Green (Dark)
 .XMMMMMMMMMMMMMMMMMMMMMMMMMMk   Terminal: iTerm2
  .XMMMMMMMMMMMMMMMMMMMMMMMMK.   Terminal Font: RobotoMonoNFM-Rg 12
    kMMMMMMMMMMMMMMMMMMMMMMd     CPU: Apple M3 Max
     ;KMMMMMMMWXXWMMMMMMMk.      GPU: Apple M3 Max
       .cooc,.    .,coo:.        Memory: 5927MiB / 36864MiB

Issue

Up-until recently I used uv to install stable-audio-tools. But now it fails.

I used python 3.11 (Although it says to use 3.10) but it worked before

Before, the below worked

# brew install uv
# Initialize with python3.11
uv init -p 3.11 # Must be less than 3.12 as of 26.04.2025
uv add colorama
source .venv/bin/activate.fish
uv add pip sounddevice soundfile 
uv add stable-audio-tools

But now it throws error:

Resolved 207 packages in 944ms
  × Failed to build `numba==0.47.0`
  ├─▶ The build backend returned an error
  ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit status: 1)

      [stdout]
      TBB not found
      OpenMP disabled
      running bdist_wheel
      running build
      got version from file /Users/saurabhdatta/.cache/uv/sdists-v9/pypi/numba/0.47.0/NF-1jKizopqH8IVUrY6HV/src/numba/_version.py
      {'version': '0.47.0', 'full': '4eb9cf875969ef7f099b292e0c5a8bb852f6fc7f'}
      running build_py
...
...
...

      INFO: compile options: '-I/Users/saurabhdatta/.cache/uv/builds-v0/.tmpQXpNkT/lib/python3.11/site-packages/numpy/_core/include
      -I/Users/saurabhdatta/.cache/uv/builds-v0/.tmpQXpNkT/include
      -I/Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11 -c'
      INFO: clang: numba/_dispatcherimpl.cpp
      INFO: clang: numba/_dispatcher.c
      INFO: clang: numba/typeconv/typeconv.cpp
      INFO: clang: numba/_hashtable.c
      INFO: clang: numba/_typeof.c

      [stderr]
      <string>:96: DeprecationWarning:

        `numpy.distutils` is deprecated since NumPy 1.23.0, as a result
        of the deprecation of `distutils` itself. It will be removed for
        Python >= 3.12. For older Python versions it will remain present.
        It is recommended to use `setuptools < 60.0` for those Python versions.
        For more details, see:
          https://numpy.org/devdocs/reference/distutils_status_migration.html


      /Users/saurabhdatta/.cache/uv/builds-v0/.tmpQXpNkT/lib/python3.11/site-packages/setuptools/dist.py:759:
      SetuptoolsDeprecationWarning: License classifiers are deprecated.
      !!

              ********************************************************************************
              Please consider removing the following classifiers in favor of a SPDX license expression:

              License :: OSI Approved :: BSD License

              See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license for details.
              ********************************************************************************

      !!
        self._finalize_license_expression()
      numba/_dispatcher.c:26:13: error: no member named 'use_tracing' in 'struct _ts'
         26 |     tstate->use_tracing = 0;
            |     ~~~~~~  ^
      numba/_dispatcher.c:28:13: error: no member named 'use_tracing' in 'struct _ts'
         28 |     tstate->use_tracing = ((tstate->c_tracefunc != NULL)
            |     ~~~~~~  ^
      numba/_dispatcher.c:301:17: error: no member named 'use_tracing' in 'struct _ts'
        301 |     if (tstate->use_tracing && tstate->c_profilefunc)
            |         ~~~~~~  ^
      numba/_dispatcher.c:333:25: error: incomplete definition of type 'PyFrameObject' (aka 'struct _frame')
        333 |         Py_XDECREF(frame->f_locals);
            |                    ~~~~~^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/object.h:606:52: note:
      expanded from macro 'Py_XDECREF'
        606 | #  define Py_XDECREF(op) Py_XDECREF(_PyObject_CAST(op))
            |                                                    ^~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/object.h:107:49: note:
      expanded from macro '_PyObject_CAST'
        107 | #define _PyObject_CAST(op) _Py_CAST(PyObject*, (op))
            |                                                 ^~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pyport.h:24:38: note:
      expanded from macro '_Py_CAST'
         24 | #define _Py_CAST(type, expr) ((type)(expr))
            |                                      ^~~~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pytypedefs.h:22:16: note:
      forward declaration of 'struct _frame'
         22 | typedef struct _frame PyFrameObject;
            |                ^
      numba/_dispatcher.c:334:14: error: incomplete definition of type 'PyFrameObject' (aka 'struct _frame')
        334 |         frame->f_locals = locals;
            |         ~~~~~^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pytypedefs.h:22:16: note:
      forward declaration of 'struct _frame'
         22 | typedef struct _frame PyFrameObject;
            |                ^
      numba/_dispatcher.c:335:25: error: incomplete definition of type 'PyFrameObject' (aka 'struct _frame')
        335 |         Py_XINCREF(frame->f_locals);
            |                    ~~~~~^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/object.h:596:52: note:
      expanded from macro 'Py_XINCREF'
        596 | #  define Py_XINCREF(op) Py_XINCREF(_PyObject_CAST(op))
            |                                                    ^~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/object.h:107:49: note:
      expanded from macro '_PyObject_CAST'
        107 | #define _PyObject_CAST(op) _Py_CAST(PyObject*, (op))
            |                                                 ^~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pyport.h:24:38: note:
      expanded from macro '_Py_CAST'
         24 | #define _Py_CAST(type, expr) ((type)(expr))
            |                                      ^~~~
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pytypedefs.h:22:16: note:
      forward declaration of 'struct _frame'
         22 | typedef struct _frame PyFrameObject;
            |                ^
      numba/_dispatcher.c:337:17: error: no member named 'frame' in 'struct _ts'; did you mean 'cframe'?
        337 |         tstate->frame = frame;
            |                 ^~~~~
            |                 cframe
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/cpython/pystate.h:110:16:
      note: 'cframe' declared here
        110 |     _PyCFrame *cframe;
            |                ^
      numba/_dispatcher.c:338:9: error: no member named 'frame' in 'struct _ts'; did you mean 'cframe'?
        338 |         C_TRACE(result, fn(PyCFunction_GET_SELF(cfunc), args, kws));
            |         ^
      numba/_dispatcher.c:71:32: note: expanded from macro 'C_TRACE'
         71 |                tstate, tstate->frame, PyTrace_CALL, cfunc))     \
            |                                ^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/cpython/pystate.h:110:16:
      note: 'cframe' declared here
        110 |     _PyCFrame *cframe;
            |                ^
      numba/_dispatcher.c:338:9: error: no member named 'frame' in 'struct _ts'; did you mean 'cframe'?
        338 |         C_TRACE(result, fn(PyCFunction_GET_SELF(cfunc), args, kws));
            |         ^
      numba/_dispatcher.c:82:50: note: expanded from macro 'C_TRACE'
         82 |                                  tstate, tstate->frame,         \
            |                                                  ^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/cpython/pystate.h:110:16:
      note: 'cframe' declared here
        110 |     _PyCFrame *cframe;
            |                ^
      numba/_dispatcher.c:338:9: error: no member named 'frame' in 'struct _ts'; did you mean 'cframe'?
        338 |         C_TRACE(result, fn(PyCFunction_GET_SELF(cfunc), args, kws));
            |         ^
      numba/_dispatcher.c:90:44: note: expanded from macro 'C_TRACE'
         90 |                            tstate, tstate->frame,               \
            |                                            ^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/cpython/pystate.h:110:16:
      note: 'cframe' declared here
        110 |     _PyCFrame *cframe;
            |                ^
      numba/_dispatcher.c:339:30: error: incomplete definition of type 'PyFrameObject' (aka 'struct _frame')
        339 |         tstate->frame = frame->f_back;
            |                         ~~~~~^
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/pytypedefs.h:22:16: note:
      forward declaration of 'struct _frame'
         22 | typedef struct _frame PyFrameObject;
            |                ^
      numba/_dispatcher.c:339:17: error: no member named 'frame' in 'struct _ts'; did you mean 'cframe'?
        339 |         tstate->frame = frame->f_back;
            |                 ^~~~~
            |                 cframe
      /Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11/cpython/pystate.h:110:16:
      note: 'cframe' declared here
        110 |     _PyCFrame *cframe;
            |                ^
      numba/_dispatcher.c:507:13: error: no member named 'use_tracing' in 'struct _ts'
        507 |     if (ts->use_tracing && ts->c_profilefunc)
            |         ~~  ^
      13 errors generated.
      numba/_typeof.c:231:57: error: no member named 'c_metadata' in 'struct _PyArray_Descr'
        231 |         md = &(((PyArray_DatetimeDTypeMetaData *)descr->c_metadata)->meta);
            |                                                  ~~~~~  ^
      1 error generated.
      error: Command "/opt/homebrew/opt/llvm/bin/clang -DNDEBUG -g -fwrapv -O3 -Wall -arch arm64 -mmacosx-version-min=11.0
      -Wno-nullability-completeness -Wno-expansion-to-defined -Wno-undef-prefix -fPIC -I/opt/homebrew/opt/llvm/include
      -I/Users/saurabhdatta/.cache/uv/builds-v0/.tmpQXpNkT/lib/python3.11/site-packages/numpy/_core/include
      -I/Users/saurabhdatta/.cache/uv/builds-v0/.tmpQXpNkT/include
      -I/Users/saurabhdatta/.local/share/uv/python/cpython-3.11.12-macos-aarch64-none/include/python3.11 -c numba/_dispatcher.c
      -o build/temp.macosx-11.0-arm64-cpython-311/numba/_dispatcher.o" failed with exit status 1

      hint: This usually indicates a problem with the package or the build environment.
  help: If you want to add the package regardless of the failed resolution, provide the `--frozen` flag to skip locking and
        syncing.

Temporary solution

But now using just venv and pip for python 3.11.12, it works

I do do as follows:

# Use pyenv to set global python to python 3.11.12
# Setup pyenv for your shell
pyenv install -v 3.11.12
pyenv global 3.11.12
pyenv versions
python
# ctrl+d to exit

python -m venv .venv
source .venv/bin/activate.fish # or your shell specific script (I use fish)
pip install stable-audio-tools 
# upgrade pip if needed
pip install sounddevice soundfile colorama. # some other additional packages

WORKS!

[AbrahamSanders]

Seems the issue for python 3.12 was fixed in PyWavelets==1.5.0: PyWavelets/pywt#695

Any chance of upgrading that version pin?

[sskalnik]

We need to know the OS version and Python version if you're still encountering this issue.

A lot of things will probably not play nice if you use Python 3.12+. Python 3.11.x works fine.

@OldComputerGuy This is the issue:
File "C:\Python312\Lib\importlib_init.py", line 90, in import_module
Use Python 3.11, not Python 3.12.

[carolekon]

No way i'm downgrading the whole environment that will break half the comfy nodes and i will be a week just hating python trying to set everything right again. Or reinstalling dunno what's worse. Checking os alternatives and if there is none then elevenlabs... they got the best models in fact because they don't use synthetic datasets to train their checkpoints.

[sskalnik]

You need to use Python 3.11.x or else you will have issues.

Also, afaik SAO did not use synthetic datasets for training.