PhysicsWallah · AI Innovation · IOI (Institute of Innovation)

Tools, Technologies, Frameworks & Methodologies

Internship work — two production systems for the PW IOI admissions & onboarding teams.

Period: June – August 2026  ·  Systems: PW Intelligence (admissions analytics + forecasting) & IOI Onboarding Portal (fee reconciliation)  ·  Both live and in daily use.

01Programming Languages

Python 3.12Primary language for both systems — data ingestion, the AI agent, the forecasting engine, backend APIs, and automation.
SQLThe analytical core — hand-written and AI-generated queries across two dialects (DuckDB and PostgreSQL). ~205 tables/views modelled.
JavaScript (vanilla)Front-end interactivity and charts with no build step or framework — deliberately lightweight.
HTML / CSSResponsive, theme-aware UI for the dashboards and chat interface.

02AI / ML Models & Techniques

Google Gemini 2.5LLM family (flash / pro / flash-lite) powering natural-language → SQL translation, reasoning, and narration of results.
Agentic ReAct architectureA reason → act → observe loop with read-only database tools: the agent investigates, cross-checks sources, flags mismatches, then answers — not a single prompt.
Retrieval-Augmented GenerationA curated store of verified question→SQL "golden" examples injected as few-shot context — the single biggest accuracy lever in NL→SQL.
Deterministic forecastingA 3-method ensemble (pipeline-inventory × conversion-lag curves, seasonal-pace, momentum) — structure over statistics, so every number is explainable and reproducible.
Grounding & guardrailsA numeric grounding guard (answers must tie to query results), a pinned metric registry (same question → same number), and prompt-injection hardening.
EvaluationLLM-as-judge red-team harness (100+ graded queries) plus a forecast back-testing harness that replays the engine against history.

03Data Tools & Storage

DuckDBIn-process analytical database (~205 tables, 550k+ rows) — the query engine behind PW Intelligence.
PostgreSQL (Supabase)Cloud operational database (ap-south-1) for the onboarding portal and the analytics clone.
Google Sheets API (gspread)Live ingestion of 9+ source sheets, header-drift–resilient, on a scheduled sync.
Frappe / ERP REST APILive student, fee, and hostel data pulled from PW's ERP (whole cohort in 3 bulk requests).
sqlglotSQL parsing & validation — the deterministic guard that keeps the AI's queries read-only and safe.
Identity reconciliationCross-source matching (ERP ↔ Medhavi/MSU ↔ loan) by ID → email → mobile to unify each student's payment status.

04Backend, Web & Design Frameworks

FastAPI + UvicornAsync (ASGI) web framework for both systems' APIs and pages.
Jinja2 + Tailwind CSSServer-rendered UI for the onboarding portal (no Node build).
Chart.jsInteractive dashboards, funnels, and forecast trajectory charts.
Server-Sent EventsLive streaming of the agent's reasoning steps to the chat UI.
Auth & securitySession-cookie auth (itsdangerous), PBKDF2 password hashing, role-based access control (4 roles), append-only audit logs.

05Cloud, DevOps & Deployment

GitHub + GitHub ActionsVersion control and CI/CD, incl. a scheduled Action that rebuilds the analytical dataset and publishes it to cloud storage.
VercelServerless hosting for both systems (region-co-located with the database for 20–30× faster responses).
SupabaseManaged Postgres + object Storage + Cron (scheduled background jobs).
CloudflareTunnels (secure VM exposure, no open ports), Pages (static hosting), and DNS.
pm2Process management for the VM-hosted services (web, data-sync, automations, tunnels).

06Methodologies & Engineering Practices

Agentic AI designTool-using LLM agents with strict read-only boundaries, self-healing on errors, and human-in-the-loop feedback that writes back correction rules.
ReproducibilityTemperature-0 generation + deterministic answer caching — the same question always returns the same, audited number (critical for leadership trust).
Test & validation-drivenpytest unit tests, a red-team eval harness, and forecast back-testing (measured ~1% day-of admissions error) before any number reaches leadership.
Data governanceReal student PII handled under DPDP-aware practices — read-only sources, no raw rows in logs/output, secrets isolated and gitignored.
Graceful degradationEvery external source (sheets, ERP, LLM) degrades to last-good data instead of failing, with alerting.
Incremental migrationZero-downtime SQLite→Postgres and VM→cloud migrations via thin compatibility shims and env-gated, backwards-compatible code.
AI-assisted developmentBuilt using agentic coding tools (Claude Code) with a "ship the simplest thing that works" discipline and rigorous review.
Prepared for the PW AI Innovation internship review. Both systems are live, in daily use by the PW IOI team, and deployed on PhysicsWallah's own cloud accounts (GitHub · Vercel · Supabase).