docs: Add Linux Python build requirements for bzip2 and lzma

Fixes #3219

Documents that Linux users building Python from source need to install
libbz2-dev and liblzma-dev (Debian/Ubuntu) or bzip2-devel and xz-devel
(RHEL/Fedora/CentOS) before building Python to ensure the _bz2 and
_lzma standard library modules are available.

This helps users who install Python via pyenv, asdf, or compile from
source avoid cryptic import errors when running ComfyUI.
This commit is contained in:
Sai Sasank Kurnella 2026-01-19 22:26:37 -05:00
parent 0da5a0fe58
commit c71e3f8db8

View File

@ -288,6 +288,22 @@ Install the dependencies by opening your terminal inside the ComfyUI folder and:
After this you should have everything installed and can proceed to running ComfyUI.
#### Linux: Python Build Requirements
If you are building Python from source on Linux (e.g., using pyenv, asdf, or compiling manually), ensure the following development libraries are installed **before** building Python. These are required for the `_bz2` and `_lzma` standard library modules:
**Debian/Ubuntu:**
```bash
sudo apt install libbz2-dev liblzma-dev
```
**RHEL/Fedora/CentOS:**
```bash
sudo dnf install bzip2-devel xz-devel
```
After installing these packages, rebuild Python to include the `_bz2` and `_lzma` modules.
### Others:
#### Apple Mac silicon