Menthub 👥📘

Menthub is a full-stack web platform designed to bridge the gap between college students seeking guidance (mentees) and those offering support (mentors) — all within the same academic environment.

It enables seamless mentor-mentee connections, encourages peer-driven learning, and promotes a culture of collaboration and growth.

🚀 Project Overview

Navigating college life — from academics and internships to placements and time management — can be challenging. Menthub was created to:

• Help students get guidance from peers in relevant areas.
• Enable students to volunteer as mentors based on their strengths.
• Provide a smart profile-based matching system using machine learning.
• Build a positive environment of support and shared growth.

Whether you're a first-year looking for advice or a final-year student ready to guide others — Menthub is for you.

🛠 Tech Stack

Layer	Technologies Used
Frontend	HTML, CSS, JavaScript
Backend	Python, Flask
Database	PostgreSQL, SQLAlchemy ORM
ML Matching	Scikit-learn (Profile-based recommendation)
Others	Git, GitHub, Jinja2 (Templating), Flask-WTF

📦 Installation Instructions

✅ Prerequisites:

• Python 3.10+
• PostgreSQL
• pip (Python package manager)

🛠️ Steps:

Step 1: Clone the repository

git clone https://github.com/yourusername/menthub.git cd menthub

Step 2: Create and activate virtual environment

python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Set up PostgreSQL

Create a database named 'menthub_db' in PostgreSQL

Update your .env file with DB connection string

Example: postgresql://username:password@localhost/menthub_db

Step 5: Set environment variables

Create a .env file in the root directory: FLASK_APP=app.py
FLASK_ENV=development
DATABASE_URL=your_postgres_connection_string

Step 6: Run database migrations (if any)

flask db upgrade

Step 7: Run the Flask app

flask run

📁 Project Structure

menthub/
│
├── app.py                 # Main Flask app
├── models/                # SQLAlchemy models
├── routes/                # Flask route handlers
├── static/                # Static files (CSS, JS, images)
├── templates/             # HTML templates (Jinja2)
├── ml_model/              # Matching model files
├── forms.py               # Flask-WTF forms
├── requirements.txt       # Python dependencies
└── .env                   # Environment variables (excluded in Git)

---

🧠 Features

• 👥 Role-based login for mentors and mentees.
• 🎯 Intelligent profile-based matching system using ML.
• 📊 Mentor profiles with skill ratings, availability, and achievements.
• 📬 Request & Scheduling system for mentees to connect with mentors.
• 🛡 Admin dashboard to manage users and reports.

---

💡 Contribution Guidelines

We welcome contributions! Here’s how you can help:

1. Fork the repository
2. Create a new branch (git checkout -b feature-xyz)
3. Make your changes and commit (git commit -m 'Add feature xyz')
4. Push to your fork and submit a Pull Request

For more detailed contribution steps, refer to CONTRIBUTING.md (if present or can be added).

---

🐛 Found a Bug? Want a Feature?

• Raise an Issue with proper labels (bug, enhancement, good first issue, etc.)
• Use the issue template for clarity
• You can also suggest features using discussions tab

---

📌 License

This project is licensed under the MIT License. See LICENSE for more information.

---

👥 Acknowledgements

• Flask & SQLAlchemy for backend development
• scikit-learn for recommendation logic
• PostgreSQL for data management
• Everyone contributing to this project ❤️

⬆️ Back to Top