Skip to content

ali-haris/Eco-Mentor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌱 Green Mentor

🌱 Learn Green. Play Green. Live Green.
Empowering Young Minds to Build a Greener Future.


🌟 Core Features

  • 💬 Conventional Learning: Kids can ask questions like “How can I save water?” and receive age-appropriate answers.
  • 🧠 Interactive Quizzes: Fun, AI-generated quizzes to reinforce learning.
  • 🎯 Eco Challenges: Real-life tasks with rewards and digital points.
  • 🛡️ Safe & Simple UI: Kid-friendly design with large buttons and mascot avatar.

🚀 Advantages for Hackathon

  • 💡 Minimal UI with maximum functionality.
  • 🤖 GPT-5 powered, context-aware, and highly engaging.

🏆 Selected Among Top 30 Projects, AsterHacks 2025 Hackathon


🛠 Tech Stack

  • ⚙️ Backend: FastAPI, Python
  • 🎨 Frontend: React
  • 🌐 Hosting: Vercel (frontend), Railway (backend)
  • 🤖 AI: GPT-5 API

👥 Team Roles


🎨 UI & Visual Design

  • 🌿 Theme: Eco-green for primary color, blue for calm, orange for highlights.
  • 🦉 Mascot: Owl avatar in chat and badge icons.
  • 💬 Chat: Green bubbles for mentor, light blue for user.
  • 🏅 Badges: Circular with shine animation.

🎨 UI & Visual Design


📦 How to Run the App

  1. 📥 Clone the repo:
    git clone https://github.com/your-repo/eco-mentor.git
  2. 📂 Navigate to backend & install dependencies:
    cd backend && pip install -r requirements.txt
  3. ▶️ Run backend server:
    uvicorn app.main:app --reload
  4. 📂 Navigate to frontend & install dependencies:
    cd ../frontend && npm install
  5. ▶️ Run frontend:
    npm run dev
  6. 🌐 Open http://localhost:5173 in your browser.

© 2025 Eco Mentor • Built with ❤️ for our planet

About

A GPT-5-driven virtual mentor that helps children (and even adults) learn about sustainability through chat—delivering personalized eco-quests, quizzes, tips, and storytelling.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors