fix timeout

Signed-off-by: ale <ale@manalejandro.com>

README.md

@@ -89,6 +89,11 @@ CUDAQ_PYTHON_PATH=/usr/local/bin/python3
 CUDAQ_DEFAULT_TARGET=qpp-cpu
 CUDAQ_LOG_LEVEL=info
 
+# Python Bridge Timeout (milliseconds)
+# Default: 300000 (5 minutes)
+# Increase for complex operations or slower hardware
+PYTHON_TIMEOUT=300000
+
 # GPU Configuration
 CUDA_VISIBLE_DEVICES=0
 CUDAQ_ENABLE_GPU=true
@@ -487,13 +492,19 @@ Solution:
 
 #### Python Bridge Timeout
 ```bash
-Error: Python command timeout
+Error: Python command timeout after Xms
 Solution: 
-1. Increase timeout in config
-2. Check Python path in .env
-3. Ensure CUDA Quantum installation
+1. Increase timeout with environment variable:
+   export PYTHON_TIMEOUT=600000  # 10 minutes in milliseconds
+2. Check Python path in .env:
+   CUDAQ_PYTHON_PATH=/usr/local/bin/python3
+3. Ensure CUDA Quantum is properly installed:
+   python3 -c "import cudaq; print(cudaq.__version__)"
+4. Check for Python process errors in logs
 ```
 
+**Note**: The default timeout is 300,000ms (5 minutes). Complex quantum operations or slower hardware may require increasing this value via the `PYTHON_TIMEOUT` environment variable.
+
 ### Debug Mode
 
 Enable debug logging: