HSC Random Tools

About The Project

HSC Random Tools is a personal project I built to help NSW HSC students better understand their performance and make more informed decisions. It includes tools like a scaled mark predictor, which estimates final HSC marks using past scaling data, and a Band 6 comparison tool that lets students explore how different schools have performed across subjects and years.

Current features:

• Scaled Mark Predictor
• Band 6 School List
• Countdown to HSC English Paper 1
• More Coming Soon!

🔧 Built With

• 
• 
• 
• 
• 
• 
• 
• 
• 

🚀 Get Started

Follow these steps to run HSC Random Tools locally.

📦 Prerequisites

Make sure you have the following installed:

• Node.js (v18+ recommended)
• Python (v3.9+)
• pip
• virtualenv (optional but recommended)

---

🧠 Backend Setup (Flask + Python)

# Navigate to the backend folder
cd backend

# Create and activate a virtual environment (optional)
python -m venv venv
source venv/bin/activate     # On Windows: venv\Scripts\activate

# Install Python dependencies
pip install -r requirements.txt

# Run the Flask backend
flask run

🌐 Frontend Setup (React + Vite)

# Navigate to the frontend folder
cd frontend

# Install dependencies
npm install

# Run the development server
npm run dev

⚙️ Environment Variables

Create a .env file inside the frontend directory with the following content:

VITE_REACT_APP_BACKEND_URL=http://127.0.0.1:5000