Backend setup fails due to missing dependencies and incomplete setup instructions

[gauravsingh001-cyber]

Description

While setting up the ExtensionShield backend locally, I encountered multiple runtime errors due to missing dependencies.

The backend failed to start successfully, even after following the available setup steps.

Environment Details

OS: Windows (tested via VS Code terminal)
Python Version: 3.14
Setup Method: Manual run using uvicorn

Steps to Reproduce

Clone the repository

Navigate to backend folder:

cd src

Run:

python -m uvicorn extension_shield.api.main:app --reload --port 8007

Observed Behavior

The backend fails to start and throws multiple ModuleNotFoundError errors sequentially.

Errors Encountered
ModuleNotFoundError: No module named 'slowapi'
ModuleNotFoundError: No module named 'reportlab'
ModuleNotFoundError: No module named 'bs4'
ModuleNotFoundError: No module named 'langgraph'
ModuleNotFoundError: No module named 'dateutil'

Analysis

These errors indicate that required dependencies are not properly declared in the project.

Instead of failing once, the setup fails repeatedly with different missing modules, which makes onboarding difficult for new contributors.

Impact

Backend cannot be started directly
New contributors face repeated setup failures
Time-consuming manual debugging required
Poor developer onboarding experience

Suggested Improvements

Provide a complete dependency list (requirements.txt or pyproject.toml)
Ensure all required packages are installed during setup
Fix or document the make install process (currently depends on uv)
Add clear setup instructions for Windows users
Provide a fallback using pip

Additional Observation

The setup worked more smoothly on a Linux environment (Ubuntu), suggesting cross-platform inconsistencies.

[Stanzin7]

@gauravsingh001-cyber this is not a missing-dependencies bug in the repo. The packages you listed are already declared in pyproject.toml (line 8), and the documented setup uses uv sync from the project root, not running python -m uvicorn directly from src; see GET_STARTED.md (line 37). You also tested with Python 3.14, while this project is set up and CI-tested with Python 3.11; see ci.yml (line 31). If there is a docs improvement needed for Windows/manual setup, that should be filed separately, but this issue as written is not accurate.