Hackalyze is designed to streamline the hackathon management process, making it easier for organizers, participants, and judges to collaborate efficiently.
Evaluating student ideas at scale is challenging, especially when submissions are unstructured and lack clarity. Teachers also struggle with conducting personalized assessments in classrooms, making it difficult to gauge student understanding and provide targeted feedback.
Click the image or this link to watch the demo video.
graph TD;
A[Hackathon Creation & Management] --> B[Student Registration & Collaboration]
B --> C[Project Submission & Evaluation]
C --> D[Leaderboard & Performance Analytics]
D --> E[Set Manual Criteria]
E --> F[Automated Judging & Results Calculation]
F -->|Final Results| G[Winners & Recognition]
subgraph AI Integration
E --> AI[AI Chatbot]
F --> ML[AI-Driven Evaluation]
C --> S3[Cloud Storage for Submissions]
D --> DB[Leaderboard Data Storage]
end
- Hackathon Creation & Management
- Team Registration & Collaboration
- Project Submission & Evaluation
- Leaderboard & Performance Analytics
- Mentorship & Support Integration
- Automated Judging & Results Calculation
The project leverages a modern tech stack along with AI capabilities for seamless performance and intelligent automation.
- React.js – For building an interactive UI
- Tailwind CSS – For rapid and responsive styling
- Node.js & Express.js – Server-side logic for handling requests
- MongoDB – NoSQL database for efficient data storage
- Google Gemini – AI-driven assistance for various tasks
- Tesseract OCR (Python) – Optical character recognition for text extraction
- Canva and Figma – For designing UI elements and media assets
- MERN Stack – Full-stack development with MongoDB, Express.js, React.js, and Node.js
Hackalyze follows a microservices-based modular architecture:
- User Authentication – Secure login and registration
- Hackathon Setup – Organizers create and configure events
- Custom Criteria – Judges assess projects based on predefined rubrics for manual, Automated evaluation using machine learning models for AI powered scoring.
- Judging & Evaluation – Judges assess projects based on predefined criteria
- Leaderboard & Insights – Real-time leaderboard updates
graph TD;
A[User Registration/Login] -->|JWT Authentication| B[Dashboard];
B --> C[Teacher Side];
C --> K[Create Hackathon];
B --> D[Student Side];
D --> L[Join Hackathon];
D --> E[Submit Project];
E --> F[Evaluation by Judges];
F --> G[Leaderboard Generation];
G --> H[Final Results & Awards];
Follow these steps to set up Hackalyze locally:
git clone https://github.com/your-repo/Hackalyze.git
cd Hackalyzenpm install # Install dependencies for frontend & backendCreate a .env file in the root of your project and add the following configuration:
# 🛠 Database Configuration
MONGO_URL="your_mongodb_connection_string"
PORT="your_port_number"
# 🔐 Security & Authentication
CORS_ORIGIN="your_frontend_url"
ACCESS_TOKEN_SECRET="your_access_token_secret"
ACCESS_TOKEN_EXPIRY="your_access_token_expiry"
REFRESH_TOKEN_SECRET="your_refresh_token_secret"
REFRESH_TOKEN_EXPIRY="your_refresh_token_expiry"
# ☁️ Cloudinary Configuration (For Media Uploads)
CLOUDINARY_CLOUD_NAME="your_cloudinary_cloud_name"
CLOUDINARY_API_KEY="your_cloudinary_api_key"
CLOUDINARY_API_SECRET="your_cloudinary_api_secret"
# 📧 Email Service (SMTP Configuration)
GMAIL_PASS="your_gmail_app_password" # Securely store and do not expose publicly
# 🔥 Google Gemini AI Configuration
GEMINI_API_KEY="your_google_gemini_api_key"
GEMINI_MODEL="your_gemini_model_name"
GOOGLE_APPLICATION_CREDENTIALS="path_to_your_configuration_json_file"
# 🛑 Note:
# Never share your environment variables publicly.
# Store sensitive values securely using a .env file or a vault service.
### **4️⃣ Start Development Server**
```sh
npm run devThe guide in CONFIG.md will help you set up a cloud service required for running the AI features in this project
- 🎓 Student Support Chatbot – AI-powered chatbot for instant student assistance.
- 📧 Enhanced Email Support – Faster and structured responses
- 📱 Mobile Optimization – Improved accessibility on all devices
- 📝 Enchanced Feedback Analysis – Structured feedback with AI-driven insights.
- 📂 URL Option for Docs & Links – Easy access to documentation and resources.
- 🛠 Zip File Support – Allow students to upload/download multiple files efficiently.
- 🔊 Auto Problem Statement Summary – AI-driven summarization & reading
- Yash Arya
- Vaishnavi Tiwari
- Samudraneel Sarkar
- Akriti Gaur
- Trishita Kesarwani
- Kratika Bhadauria