🎯 IssueMatch

AI-Powered Open Source Contribution Matchmaker

IssueMatch connects developers with open source issues that perfectly match their skills and interests using advanced AI and machine learning. Find meaningful contributions in seconds, not hours.

Part of Social Winter of Code 2026

Intelligent platform bridging developers with open source opportunities through AI-powered matching

---

✨ Features

🤖 AI-Powered Matching

• Smart Profile Analysis: Extracts skills from GitHub profile
• Vector Similarity Search: FAISS-powered matching with 384-dimensional embeddings
• Intelligent Query Generation: AI creates optimized GitHub search queries
• Real-time Learning: ML system improves recommendations based on feedback

👤 User Experience

• GitHub OAuth: Secure one-click authentication
• Interactive Skill Assessment: 10-question skill evaluation system
• AI Chatbot Assistant: AI-powered help for understanding issues
• Dark/Light Theme: Modern UI with theme switching

🎓 Mentorship & Growth

• Mentor Matching: Connect with experienced developers
• Leaderboard System: Contribution-based ranking (10/25/50 points)
• Referral Program: Earn 5 points per referral
• Progress Analytics: Track your open source journey

---

🛠️ Technology Stack

Backend

• Framework: FastAPI (Python 3.9+)
• AI/ML:
  • Google AI Studio - AI Chatbot
  • FAISS (v1.7.x) - Vector similarity search
  • Sentence Transformers (all-MiniLM-L6-v2) - Text embeddings
• APIs: GitHub REST API (2022-11-28)
• Database: MongoDB Atlas

Frontend

• Framework: Next.js 15+ (React 19)
• Language: TypeScript 5.0+
• Styling: TailwindCSS + Shadcn/ui
• State Management: React Context API
• Theme: next-themes

Authentication & Storage

• Auth: GitHub OAuth 2.0
• Database: MongoDB Atlas
• Session: Server-side sessions with FastAPI

---

🚀 Quick Start

Prerequisites

Python 3.9+
Node.js 18+
Git

Installation

1. Clone the repository

git clone https://github.com/AvishkarPatil/IssueMatch.git
cd IssueMatch

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env  # Configure your environment variables
uvicorn app.main:app --reload --port 8000

3. Frontend Setup

cd frontend
npm install
npm run dev

4. Access the application

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

For detailed setup instructions, see SETUP.md

---

🔄 How It Works

graph LR
    A[GitHub Login] --> B[Profile Analysis]
    B --> C[Skill Extraction]
    C --> D[AI Query Generation]
    D --> E[Issue Matching]
    E --> F[Ranked Results]
    F --> G[User Feedback]
    G --> D

Loading

1. Authenticate with GitHub OAuth
2. Profile Analysis extracts skills from your repositories
3. AI Processing generates optimized search queries
4. Vector Matching finds relevant issues using FAISS
5. Smart Ranking orders results by relevance
6. Continuous Learning improves from user interactions

---

📋 To-Do List

• Real-time leaderboard implementation
• Dynamic profile statistics
• Improved UI/UX design
• Enhanced issue matching algorithm
• Mentor-mentee matching system
• Mobile responsive improvements
• Advanced analytics dashboard
• Gamification features

---

🤝 Contributing

We welcome contributions from developers of all skill levels! This project is part of Social Winter of Code 2026.

Getting Started

1. Check open issues
2. Look for SWoC26 and difficulty labels (Easy, Medium, Hard)
3. Comment to request assignment
4. Fork, code, and submit a PR

See CONTRIBUTING.md for detailed guidelines.

Contributors

---

📄 License

This project is licensed under the MIT License - see LICENSE for details.

---

Built with ❤️ by Avishkar Patil

© 2026 IssueMatch. All rights reserved.