Jbee-k/wim-matchmaking-platform2

Mentor-Mentee Matching Platform for Women in Manufacturing - Kenya Association of Manufacturers # Women In Manufacturing Matchmaking Platform **AI-Powered Mentor-Mentee Pairing System** **Version 1.0 | May 2026** --- ## Overview The WIM Matchmaking Platform is a standalone web application that automates the process of matching mentors and mentees for the KAM Women in Manufacturing Mentorship Programme. The platform combines intelligent algorithmic matching with human oversight, allowing KAM Admin to review, approve, reject, or manually adjust AI-suggested pairings with full transparency. **Key Features:** - ✅ Mentor and mentee intake questionnaires - ✅ EOS "Right Seat" assessment (Get it, Want it, Capacity) - ✅ AI-powered compatibility matching algorithm (6-factor weighted scoring) - ✅ Intentional diversity recommendations with transparency and override option - ✅ Admin dashboard for review and approval - ✅ Match reveal interface for participants - ✅ Automated email notifications - ✅ Practice mode for testing - ✅ Full audit trail of all decisions --- ## Technology Stack - **Frontend:** Streamlit (Python web framework) - **Backend:** Python (Streamlit handles this) - **Database:** SQLite (embedded, zero cost) - **Hosting:** Streamlit Community Cloud (free) or self-hosted - **Matching Algorithm:** Custom Python with 6-factor weighted scoring --- ## Installation & Setup ### Prerequisites - Python 3.8+ - pip (Python package manager) ### Local Setup 1. **Clone or download the project:** ```bash cd /home/ubuntu/wim-matchmaking-platform ``` 2. **Install dependencies:** ```bash pip install -r requirements.txt ``` 3. **Run the app locally:** ```bash streamlit run app.py ``` The app will open at `localhost` ### Deploy to Streamlit Community Cloud (FREE) 1. **Push code to GitHub:** ```bash git init git add . git commit -m "Initial commit: WIM Matchmaking Platform" git remote add origin github.com git push -u origin main ``` 2. **Go to Streamlit Cloud:** - Visit share.streamlit.io - …