Skip to content

Repository files navigation

HackBridge

FastAPI React Google Gemini SQLite

A unified hackathon administration platform replacing fragmented coordination tools with a mathematically transparent API surface.


Unique Selling Proposition (USP) & Differentiation

100% Explainable Audit Trails
PulseForge entirely avoids "black-box" machine learning. Scoring, reviewer assignments, and group bias normalizations are calculated using transparent Z-scores and greedy multi-objective optimization, allowing organizers to trace, justify, and verify every single decision.

Resilient Local Fallback
Combines Google Gemini API skill extraction with a local regex-based fallback keyword parser. If external networks or API limits drop during judging, the application automatically switches to local parsing and continues running without interruption.


Technical Stack

Layer Technology Purpose
Backend FastAPI High-performance asynchronous REST API routing
Frontend React + Vite + TypeScript Responsive admin dashboard with Tailwind CSS styling
Database SQLite + SQLAlchemy Embedded relational storage with strict Repository isolation
Fuzzy Matching RapidFuzz Exact-email and fuzzy-name matching algorithms
AI Integration Google Gemini API Adaptive participant skill extraction and taxonomy tagging

Pipeline Flow

[Registration] ──> [Fuzzy Duplicate Check] ──> [Skill Extraction] ──> [Reviewer Assignment] ──> [Bias Normalization]
  • Fuzzy Duplicate Check: Cross-references exact emails, fuzzy names (token sort ratio), and organization matches.
  • Skill Extraction: Standardizes participant bios into a clean technology taxonomy.
  • Reviewer Assignment: Greedy optimizer balancing expertise (40%), workload (30%), COI exclusion (20%), and diversity (10%).
  • Bias Normalization: Calculates reviewer-level Z-scores to normalize harsh/lenient evaluations across cohorts.

About

AI powered Hackathon management dashboard

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages