QUICK-START.md

Predictive Crowd Intelligence - Quick Start Commands

🚀 Quick Launch Scripts

Backend Server

Double-click or run:

start-backend.bat

• URL: http://localhost:8000
• API Docs: http://localhost:8000/docs
• Requirements: Python virtual environment already set up

Frontend Development Server

Double-click or run:

start-frontend-fixed.bat

• URL: http://localhost:5173
• Requirements: Node.js dependencies already installed

📋 Manual Commands (if batch files don't work)

Backend Manual Setup

# Open PowerShell Terminal 1
cd "C:\Users\gkhandpur\CascadeProjects\PredictiveCrowdIntelligence\Predictive-Crowd-Intelligence\backend"
$env:PYTHONPATH = "."
C:\Users\gkhandpur\CascadeProjects\PredictiveCrowdIntelligence\Predictive-Crowd-Intelligence\backend\.venv\Scripts\python.exe -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Frontend Manual Setup

# Open PowerShell Terminal 2 (separate from backend)
cd "C:\Users\gkhandpur\CascadeProjects\PredictiveCrowdIntelligence\Predictive-Crowd-Intelligence\frontend"
npm run dev

🔧 VS Code Integrated Terminal Commands

Backend in VS Code Terminal

cd backend
$env:PYTHONPATH = "."
.\.venv\Scripts\python.exe -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Frontend in VS Code Terminal

cd frontend
npm run dev

📊 System Status Checks

Check if Backend is Running

Invoke-RestMethod -Uri "http://localhost:8000" -Method Get

Check if Frontend is Running

netstat -ano | findstr :5173

🏗️ Environment Information

Python Environment

• Type: Virtual Environment (.venv)
• Python Version: 3.13.5
• Location: backend\.venv\Scripts\python.exe

Node.js Environment

• Package Manager: npm
• Build Tool: Vite 7.0.6
• Framework: React 18 + TypeScript

🎯 Key URLs

• Frontend Application: http://localhost:5173
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs
• API Health Check: http://localhost:8000

⚠️ Important Notes

1. Run in Separate Terminals: Always run backend and frontend in separate terminal windows/processes
2. Directory Paths: Commands are set up for the current workspace structure
3. Dependencies: All Python packages and Node.js modules are already installed
4. Mock Data: System runs with mock data (weather, events) - API keys needed for production
5. Auto-reload: Both servers support hot-reload for development

🔄 Restart Commands

If either server stops working:

Kill and Restart Backend

Get-Process | Where-Object {$_.ProcessName -eq "python"} | Stop-Process -Force
# Then run start-backend.bat

Kill and Restart Frontend

Get-Process | Where-Object {$_.ProcessName -like "*node*"} | Stop-Process -Force
# Then run start-frontend-fixed.bat