diff --git a/requirements.txt b/requirements.txt
index 5a205df..8f057c6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,7 +1,8 @@
 # Core dependencies - required for all functionality
+# Version constraints chosen for ComfyUI compatibility
 torch>=2.0.0
-numpy>=1.20.0
-pillow>=9.0.0
+numpy>=1.23.5,<2.0.0  # numpy 2.x breaks compatibility with many ComfyUI packages
+pillow>=9.0.0,<11.0.0  # pillow 11+ breaks compatibility with gradio
 
 # Multi-channel EXR support (for CG professionals)
 OpenImageIO>=2.4.0