Skip to content

Repository files navigation

AlgoMerge — PR Radar for Open Source Contributors

Find the best open-source issues to contribute to — with the lowest competition.

Live Demo Status Stack


What is AlgoMerge?

AlgoMerge is a platform that helps developers find the best open-source issues to contribute to — ones where competition is low and the chance of getting your PR merged is high.

Instead of scrolling through hundreds of GitHub issues with no signal, AlgoMerge analyzes repositories and ranks issues based on contribution opportunity.


The Problem

Open-source contribution discovery is broken.

  • Thousands of issues with no clear starting point
  • Many issues already being worked on by multiple contributors
  • No way to know if a repository is actively accepting PRs
  • Time wasted searching instead of building

This leads to low PR acceptance rates and discourages new contributors.


The Solution

AlgoMerge surfaces high-probability contribution opportunities by analyzing:

  • Contributor competition — how many people are already working on an issue
  • Repository activity — whether maintainers are actively reviewing and merging PRs
  • Contribution opportunity — ranking issues most worth your time

Features

  • 🎯 Issue Opportunity Detection — highlights issues with low contributor competition
  • 📊 Repository Activity Insights — identifies repositories actively accepting contributions
  • Faster Discovery — go from zero to the right issue in minutes
  • 🧹 Clean Interface — designed for quick scanning and evaluation

Who Is It For?

  • Developers making their first open-source contributions
  • Students applying for GSoC, SoC, or similar programs
  • Engineers looking to build a stronger GitHub profile
  • Contributors who want higher PR merge rates

Tech Stack

Layer Technology
Frontend React 18, Vite, Tailwind CSS
Backend Node.js, Express.js (Vercel Serverless)
Relational Database PostgreSQL (Supabase) - User & Watchlist Data
NoSQL Database MongoDB (Mongoose) - AI Caching Layer
External APIs GitHub REST API, Google Gemini API

Getting Started

1. Clone the repository

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

2. Install dependencies

npm install

3. Set up environment variables

Copy the example environment file and fill in your specific keys:

cp .env.example .env

4. Database Setup

  1. Supabase (PostgreSQL): Run the SQL commands found in supabase_migration.sql inside your Supabase SQL Editor to set up the relational tables (users and tracked_repositories).
  2. MongoDB: Create a free MongoDB Atlas cluster and copy your connection string.

5. Run the development server

npm run dev

Open http://localhost:3000 to view it in your browser.


Environment Variables

Your .env file must include the following keys to run AlgoMerge locally or in production:

# -----------------------------------------------------------------------------
# GitHub Configuration
# -----------------------------------------------------------------------------
GITHUB_PUBLIC_TOKEN="ghp_your_github_token"

# -----------------------------------------------------------------------------
# Database Configuration
# -----------------------------------------------------------------------------
# Supabase (PostgreSQL)
VITE_SUPABASE_URL="https://your-project-id.supabase.co"
VITE_SUPABASE_ANON_KEY="your-anon-key"

# MongoDB (NoSQL Caching)
MONGODB_URI="mongodb+srv://username:password@cluster.mongodb.net/algomerge"

# -----------------------------------------------------------------------------
# AI Configuration
# -----------------------------------------------------------------------------
# Google Gemini API Key
GEMINI_API_KEY="AIzaSy_your_gemini_api_key"

Contributing

Contributions are welcome. If you find a bug or have a feature request, feel free to open an issue or submit a pull request.

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'Add your feature')
  4. Push to the branch (git push origin feature/your-feature)
  5. Open a Pull Request

Live Demo

🔗 algomerge.vercel.app


License

MIT License — see LICENSE for details.


Built by Mohit · Feedback and contributions welcome

About

Find the best open-source issues to contribute to — with the lowest competition

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages