IssueMatch

Connecting developers with open source issues that match their skills and interests

A smart platform that uses AI to analyze your GitHub profile and find the perfect open source issues for you to contribute to.

🇮🇳 Part of Open Source Connect India (OSCI) Initiative

---

🚀 Overview

IssueMatch is an intelligent platform that bridges the gap between developers and open source projects. By analyzing your GitHub profile and skills using advanced AI techniques, IssueMatch recommends issues that perfectly match your expertise and interests, making it easier to find meaningful contributions in the vast open source ecosystem.

✨ Features

• GitHub Profile Analysis: Automatically extracts your technical skills, languages, and interests from your GitHub profile
• AI-Powered Matching: Uses natural language processing and vector similarity to find issues that match your skills
• Skill Assessment: Interactive skill test to better understand your technical expertise
• Mentorship System: Connect with mentors who can guide you through your open source journey
• Real-time Analytics: Track your open source contributions and growth
• AI Assistant: Get help with understanding issues and planning your contributions

🛠️ Technology Stack

Backend

• Python with FastAPI framework
• AI & ML Services:
  • Google Natural Language API (language_v1): For entity extraction and technical skill identification
  • Google Vertex AI with Gemini 2.0 Flash (gemini-2.0-flash-001): For generating optimized GitHub search queries
  • Google AI Studio with Gemini 2.0 Flash Lite (gemini-2.0-flash-lite): For AI chatbot assistance
  • FAISS (v1.7.x): Using IndexFlatL2 for vector similarity search
  • Sentence Transformers (all-MiniLM-L6-v2): For generating 384-dimensional text embeddings
• GitHub API (2022-11-28): For fetching repository and issue data

Frontend

• Next.js with React and TypeScript
• TailwindCSS for styling
• Firebase Firestore: For user data storage and authentication state management

Authentication

• GitHub OAuth: For secure user authentication

🔄 How It Works

1. Login with GitHub: Authenticate using your GitHub account
2. Skill Assessment: Complete a brief skill assessment (or skip if returning user)
3. Profile Analysis:
   • Your GitHub profile, repositories, languages, and READMEs are analyzed
   • Google Natural Language API extracts technical entities and keywords
   • Your skills are converted to vector embeddings
4. Issue Matching:
   • Open issues are fetched based on your skills and interests
   • Issues are converted to vector embeddings using Sentence Transformers
   • FAISS performs similarity search to find the best matches
   • Issues are ranked by relevance to your profile
5. Contribution: Select an issue to contribute to, with optional mentorship support

🚀 Deployment

Prerequisites

• Python 3.9+
• Node.js 18+
• Google Cloud account with Natural Language API and Vertex AI enabled
• GitHub OAuth application credentials
• Firebase project

Backend Setup

Clone the repository

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

Navigate to backend directory

cd backend

Create virtual environment

python -m venv venv

Activate virtual environment

On Windows:

venv\Scripts\activate

On macOS/Linux:

source venv/bin/activate

Install dependencies

pip install -r requirements.txt

Configure credentials

Create a keys.json file with your Google Cloud credentials and place it in the app/services directory.

Set environment variables

Create a .env file with the following variables:

GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
GOOGLE_APPLICATION_CREDENTIALS=path/to/keys.json

Start the backend server

uvicorn app.main:app --reload --port 8000

Frontend Setup

Navigate to frontend directory

cd frontend

Install dependencies

npm install

Configure Firebase

Update the firebase.ts file with your Firebase project credentials.

Start the development server

npm run dev

The application will be available at http://localhost:3000

🤝 Contributing

IssueMatch is part of the Open Source Connect India (OSCI) initiative! We welcome contributors of all skill levels.

🚀 Quick Start for Contributors

1. Check out our Contributing Guidelines
2. Browse open issues
3. Look for good-first-issue labels for beginners
4. Comment on an issue to get assigned
5. Fork, code, and submit a PR!

🎯 Contribution Areas

• Frontend: React/Next.js/TypeScript improvements
• Backend: Python/FastAPI enhancements
• AI/ML: Improve matching algorithms
• Documentation: Help others understand the project
• Testing: Add tests and improve reliability

🏆 OSCI Benefits

• Recognition in OSCI community
• Certificates and swag opportunities
• Mentorship from experienced developers
• Networking with Indian open source community

New to open source? Perfect! This project is beginner-friendly with plenty of good-first-issue tasks.

📄 License

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

---

© 2025 Avishkar Patil All rights reserved.