Installation

Clone the backend repository, create a virtual environment, and install the Python dependencies.

# Navigate to backend directory
cd KhelaDekho-API

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Copy environment variables template
cp .env.example .env

Navigate to the frontend directory, install NPM packages, and prepare your environment variables.

# Navigate to frontend directory
cd KhelaDekho

# Install dependencies
npm install

# Copy environment variables template
cp .env.example .env.local

Now that you have copied the templates, edit your .env.local (Frontend) file.

# Set in wrangler.toml under [vars]:
V1_HOME_URL=https://your-v1-provider.example
V2_HOME_URL=https://your-v2-provider.example
V4_HOME_URL=https://your-v4-provider.example
# XKEY is a secret: wrangler secret put XKEY

# --- Backend API ---
KHELADEKHO_API_URL=https://your-api.workers.dev
XKEY=your-xkey-here

# --- Telegram Contact Form ---
TELEGRAM_BOT_TOKEN=your-telegram-bot-token-here
TELEGRAM_CHAT_ID=your-telegram-chat-id-here

# --- GitHub (Optional) ---
GITHUB_TOKEN=

# --- Google Analytics 4 (Optional) ---
NEXT_PUBLIC_GA_MEASUREMENT_ID=

Open two separate terminal windows to run both servers simultaneously.

cd KhelaDekho-API
source venv/bin/activate
uvicorn app.main:app --reload --port 8000

cd KhelaDekho
npm run dev

> The backend also ships as a Cloudflare Worker (the production API). To run it instead of FastAPI, start the Wrangler dev server and point the frontend at it via KHELADEKHO_API_URL=http://localhost:8787.

cd KhelaDekho-API/worker
npm install
npm run dev        # http://localhost:8787
# deploy: npm run deploy  (set XKEY via: wrangler secret put XKEY)

> Open your browser and navigate to http://localhost:3000. You should see the KhelaDekho lobby. If the backend is running properly, the live matches and channels will populate automatically.