Skip to main content
SYS_INIT // DWARKESH.LAB
DWARKESHRAMANI
Computer Engineering · Full-Stack Engineer
INITIALIZING DWARKESH // BUILD SYSTEM...12%
04/Full-Stack AI Engineer·2026·SHIPPED

Class Intelligence System

Departmental RAG system with ChromaDB and Gemini citations.

FastAPINext.jsChromaDBGoogle Gemini 1.5 FlashBcrypt + SHA-256Tailwind CSSPython 3.11

01 // OVERVIEW

Departmental RAG system with ChromaDB and Gemini citations.

THE PROBLEM

University course materials are fragmented across unsearchable slide decks, scanned PDFs, and drive folders. Students struggle to find precise syllabus answers or exam concepts before deadlines.

THE IDEA & APPROACH

A high-precision Retrieval-Augmented Generation (RAG) platform tailored for academic departments, pairing chunked vector search with Google Gemini 1.5 Flash for grounded, cited answers.

02 // SYSTEM ARCHITECTURE & DATA FLOW

Document chunking and embedding pipeline indexed into ChromaDB, queried via FastAPI with cosine similarity thresholds and contextual prompt synthesis.

FIG 1.0 // SYSTEM TOPOLOGY & EXECUTION PIPELINEINGESTIONFASTAPI / AIPERSISTENCE
DETAILED EXECUTION SEQUENCE
01 →Faculty upload course syllabi, lecture slides, and past papers via authenticated portal
02 →Document parser extracts text, sanitizes formatting, and splits into semantic chunks
03 →ChromaDB indexes vector embeddings using domain-tuned similarity thresholds
04 →Student queries trigger hybrid vector retrieval to fetch top-k relevant source paragraphs
05 →Gemini 1.5 Flash synthesizes direct answer with exact slide / page citation badges

03 // TECHNICAL DECISIONS & TRADE-OFFS

DECISIONChromaDB for embedded local persistence
ALTERNATIVES CONSIDEREDVector Store Selection
WHY

Enables straightforward deployment without expensive managed vector database overhead for department-scale corpora.

DECISIONGemini 1.5 Flash
ALTERNATIVES CONSIDEREDModel Choice
WHY

Exceptional cost-performance ratio with low latency (sub-500ms) and large context window capability.

04 // CHALLENGES & RESOLUTIONS

CHALLENGE // 01

Extracting clean text and equations from low-resolution faculty PDF scans.

CHALLENGE // 02

Preventing hallucinations when questions fall outside the department syllabus scope.

05 // VERIFIED OUTCOMES

Production-ready deployment serving departmental course notes with source citations.

Custom authentication with pre-hashed SHA-256 passwords and role-based access control.

06 // LESSONS & TAKEAWAYS

Citing specific source pages is what transforms an AI system from an unreliable toy into a trusted educational tool.
STATUS: VERIFIED ON GITHUB