Shiksha (IISERB) result notifier

Polls the IISERB Shiksha “studentReports” page through the IISERB VPN and alerts you when results appear (based on a table row-count threshold). When the threshold is reached, an nofication is sent and the browser is left open so you can view the results.

Requirements

• Python 3.12+
• Playwright browsers installed

Install dependencies (using uv or pip):

• uv sync
• or pip install -e .

Install Playwright browsers:

• python -m playwright install

Configuration

Set these environment variables:

• IISERB_VPN_USER
• IISERB_VPN_PASS
• SHIKSHA_USER
• SHIKSHA_PASS

PowerShell example:

• $env:IISERB_VPN_USER = "..."
• $env:IISERB_VPN_PASS = "..."
• $env:SHIKSHA_USER = "..."
• $env:SHIKSHA_PASS = "..."

If you use a .env file, run via a tool that supports it (e.g. uv run --env-file .env python main.py).

Run

• python main.py

Options:

• python main.py --interval-seconds 300 --threshold 8
• python main.py --headless (not recommended if you want to view results)

Notes

• If the VPN/Shiksha session expires while waiting, the script automatically re-authenticates and continues polling.