From c71e3f8db8f8b59818db4cf63e5fd11c4bb5f9b6 Mon Sep 17 00:00:00 2001 From: Sai Sasank Kurnella Date: Mon, 19 Jan 2026 22:26:37 -0500 Subject: [PATCH] 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. --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index c56e05d075e5..fe222a61da33 100644 --- a/README.md +++ b/README.md @@ -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