Docs: add backend setup and dependency notes

README.md

@@ -89,6 +89,51 @@ Devr.AI utilizes a complex multi-service architecture with AI agents, message qu
 
 For detailed setup instructions, troubleshooting, and deployment guides, please refer to our [Installation Guide](./docs/INSTALL_GUIDE.md).
 
+Backend Setup (Development)
+
+This section describes how to run the backend locally for development.
+
+Prerequisites
+
+- Python 3.10+
+- Git
+- Virtual environment support (venv)
+
+Setup Steps :
+1. Clone the repository and navigate to the project root.
+2. Create and activate a virtual environment.
+
+PowerShell (Windows):
+python -m venv venv
+.\venv\Scripts\Activate.ps1
+
+Git Bash:
+python -m venv venv
+source venv/Scripts/activate
+
+3. Upgrade pip and install backend dependencies.
+pip install -U pip
+pip install -e .
+
+Required Runtime Dependencies
+While running the backend locally, the following runtime dependencies are required:
+
+- uvicorn
+- pydantic-settings
+- supabase
+- aiohttp
+- weaviate-client
+
+If these dependencies are missing, the backend may fail during startup with import or runtime errors.
+
+Running the Backend
+From the project root or backend directory:
+python backend/main.py
+
+Notes on Weaviate Client Compatibility
+The backend currently uses APIs from different major versions of the Weaviate Python client (v3 and v4).
+As a result, contributors may encounter startup errors depending on the installed client version.
+
 ## 🎯 Bot Commands
 
 - `/verify_github` - Link your GitHub account for enhanced personalization

pyproject.toml

@@ -25,7 +25,7 @@ dependencies = [
     "aio-pika (>=9.5.5,<10.0.0)",
     "uvicorn (>=0.38.0,<0.39.0)",
     "ddgs (>=9.0.2,<10.0.0)",
-    "fastmcp>=2.11.3,<3.0.0",
+    "fastmcp (>=2.11.3,<3.0.0)",
     "discord-py (>=2.4.0,<2.5.0)",
     "graphrag-sdk (>=0.8.1,<0.9.0)",
     "tree-sitter (>=0.25.2,<0.26.0)",