Skip to content

README.md

Latest commit

 

History

History
118 lines (95 loc) · 3.31 KB

README.md

File metadata and controls

118 lines (95 loc) · 3.31 KB

STEMForge - A Gamified STEM Learning Platform

STEMForge React FastAPI

A comprehensive gamified STEM learning platform with AI-powered career guidance for students in grades 8-12.

🚀 Features

🎮 Gamified Learning

  • Projectile Lab (Physics): Interactive canvas-based game to learn projectile motion
  • Logic Grid (Math): Pattern recognition puzzles with progressive difficulty
  • Element Match (Chemistry): Periodic table quiz with element properties

🏆 Gamification System

  • XP Points & Levels
  • Achievement Badges
  • Learning Streaks
  • Global Leaderboard

🤖 AI Career Guidance

Multi-agent AI system for personalized career recommendations:

  • Skill Profiling Agent: Analyzes learning progress and identifies strengths
  • Career Matching Agent: Maps students to suitable careers based on interests, skills, and grades
  • Learning Path Agent: Suggests personalized study paths and courses
  • Guidance Agent: Provides ongoing personalized recommendations

🗺️ Personalized Roadmaps

  • Career-specific learning paths
  • Recommended colleges and qualifications
  • Growth opportunity insights

🛠️ Tech Stack

Frontend

  • React 18 + Vite
  • React Router DOM
  • Vanilla CSS (Design System)
  • Canvas API for games

Backend

  • Python 3.11+
  • FastAPI
  • Pydantic
  • Uvicorn

📦 Installation

Frontend Setup

cd frontend
npm install
npm run dev

Frontend runs on: http://localhost:5173

Backend Setup

cd backend
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

Backend runs on: http://localhost:8000

📁 Project Structure

stemforge/
├── frontend/
│   ├── src/
│   │   ├── components/      # Layout, Navbar
│   │   ├── pages/           # Home, Dashboard, Games, CareerGuide
│   │   ├── games/           # ProjectileLab, LogicGrid, ElementMatch
│   │   ├── index.css        # Design System
│   │   └── App.jsx          # Routes
│   └── package.json
│
├── backend/
│   ├── services/
│   │   ├── career_engine.py    # Career Matching Agent
│   │   ├── skill_profiler.py   # Skill Profiling Agent
│   │   └── learning_path.py    # Learning Path Agent
│   ├── main.py                 # FastAPI app
│   └── requirements.txt
│
└── README.md

🎨 Design System

The platform uses a clean, white-themed design with teal/cyan accents:

  • Primary Background: #ffffff
  • Accent Color: #0891b2 (Teal)
  • No purple colors used
  • Glassmorphism effects for cards
  • Smooth micro-animations

🔌 API Endpoints

Method Endpoint Description
GET / API info
GET /health Health check
POST /api/career-guidance Get career recommendations
POST /api/game-score Submit game score
GET /api/games List available games
GET /api/leaderboard Get global leaderboard

👥 Team

Built for Hackathon 2026

STEMForge - Built for learning, powered by curiosity.