From 12f0e832cac0a52cc055a178e9194466d2c79272 Mon Sep 17 00:00:00 2001
From: Mahek Gupta <guptamahek761@gmail.com>
Date: Mon, 16 Feb 2026 22:24:21 +0530
Subject: [PATCH] Clarify supported Python versions and document CUDA
 dependency issues

---
 docs/INSTALL_GUIDE.md | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/docs/INSTALL_GUIDE.md b/docs/INSTALL_GUIDE.md
index 8849d5d..13b3b36 100644
--- a/docs/INSTALL_GUIDE.md
+++ b/docs/INSTALL_GUIDE.md
@@ -5,7 +5,10 @@ For Setup guide video tutorial go to [Devr Setup Guide](https://drive.google.com
 
 ## Prerequisites
 
--   [Python](https://www.python.org/) 3.9+ (version 3.10 is recommended)
+-   [Python](https://www.python.org/) >= 3.10 and < 3.13 (Python 3.11 is recommended)
+
+⚠️ Python 3.13 is currently not supported and may cause dependency installation errors (e.g., crewai or CUDA-related packages failing to install).
+
 -   [Node.js](https://nodejs.org/en) (latest LTS version)
 -   [Git](https://git-scm.com/) (any recent version)
 -   [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/) (for Weaviate database)
@@ -32,10 +35,34 @@ poetry --version  # Should show v2.0.0 or above
 
 3. **Install Python dependencies**
 ```sh
-poetry env use python3.10
+poetry env use python3.11
 poetry lock 
 poetry install --with dev
 ```
+### ⚠️ GPU / CUDA Dependency Notice
+
+The backend includes NVIDIA CUDA-related dependencies such as:
+
+- nvidia-cuda-runtime-cu12  
+- nvidia-cudnn-cu12  
+- nvidia-cufile-cu12  
+
+These may fail to install on systems without:
+
+- NVIDIA GPU  
+- Compatible CUDA drivers  
+
+If you encounter errors such as:
+
+```
+ERROR: No matching distribution found for nvidia-cufile-cu12
+```
+
+
+Consider:
+- Using a CUDA-enabled Linux environment  
+- Or running the project via Docker (recommended for consistent setup)
+
 
 4. **Activate the virtual environment**
 ```sh