RepoRank 구축하기 — 오픈 소스 영향력 및 펀딩 준비 엔진 - Insights | Molayo

오픈 소스 지표, 교차 소스 SQL 조인(SQL joins), 그리고 AI 기반의 그랜트 매칭(grant matching)을 연결하는 여정.

오픈 소스 펀딩 위기

매일 개발자들은 글로벌 인프라를 구동하는 핵심적인 오픈 소스 소프트웨어 조각들을 구축하고 유지 관리합니다. 하지만 이 생태계의 가장 큰 과제 중 하나는 여전히 펀딩(funding)입니다. 유지 관리자(Maintainers)들은 그랜트 제안서(grant proposals), 피치 덱(pitch decks), 그리고 후원 신청서를 작성하는 데 수많은 시간을 소비합니다.

프로젝트의 영향력을 증명하려면 다음과 같은 까다로운 질문에 답해야 합니다:

얼마나 많은 개발자가 이를 사용하고 있는가? (PyPI/npm 다운로드 수)
커뮤니티에서 이에 대해 이야기하고 있는가? (HackerNews 언급 횟수)
현재 재정 상태는 어떠한가? (Open Collective 통계)
저장소(repository)의 상태는 얼마나 건강한가? (GitHub stars, forks, 그리고 issues)

이러한 데이터를 수집한다는 것은 4~5개의 서로 다른 API를 통합하고, 파편화된 JSON 구조를 파싱하며, 상용구 인증 코드(boilerplate auth code)를 작성하고, 조각들을 수동으로 하나씩 이어 붙여야 함을 의미합니다.

Pirates of the Coral-bean 해커톤을 위해, 저는 바로 이 문제를 해결하고자 RepoRank를 구축했습니다. RepoRank는 Coral SQL과 **Hugging Face Qwen 2.5 (72B)**를 사용하여 교차 소스 신호(cross-source signals)를 즉각적으로 집계하고, 종합적인 영향력 점수를 계산하며, 전문적인 펀딩 피치를 생성하고, 프로젝트를 활발한 그랜트 프로그램과 매칭합니다.

비밀 병기: Coral SQL

4개 이상의 외부 API를 통합하는 작업은 보통 문서를 읽고 API 래퍼(wrapper) 코드를 작성하는 데 며칠이 걸립니다. Coral은 표준 SQL을 사용하여 API를 쿼리할 수 있게 함으로써 이 과정을 완전히 바꿉니다.

Coral을 사용하면 API는 SQL 테이블로 취급됩니다. RepoRank의 핵심은 바로 이 단일 교차 소스 JOIN 쿼리입니다:

SELECT  g.full_name,
        g.stargazers_count,
        g.forks_count,
...

Coral은 내부적으로 실행을 처리하여, 패키지 통계를 가져오고, 지난 180일 동안 저장소 이름과 일치하는 스토리가 있는지 HackerNews를 확인하며, GitHub 상세 정보를 검색한 뒤, 통합된 평면(flat) SQL 행을 반환합니다.

우리에게 필요한 소스 구축하기

Coral은 훌륭한 내장 소스(built-in sources) 컬렉션을 보유하고 있지만, 오픈 소스의 전체적인 모습을 포착하기 위해서는 PyPI, npm, HackerNews, 그리고 Open Collective의 데이터가 필요했습니다.

Python에서 API 요청을 하드코딩하는 대신, 우리는 Coral을 확장했습니다! 우리는 외부 REST 및 GraphQL 엔드포인트를 SQL 쿼리가 가능한 테이블로 매핑하는 **4개의 커스텀 YAML 소스 사양 (custom YAML source specifications)**을 설계하고 작성했습니다.

다음은 우리가 Open Collective를 위해 작성한 커스텀 GraphQL 소스 사양의 스니펫입니다:

dsl_version: 3
name: opencollective
backend: http
...

GraphQL 변수를 {{filter.slug}} 템플릿에 매핑함으로써, 간단한 SQL WHERE 절을 사용하여 Open Collective를 쿼리할 수 있습니다:

SELECT total_amount_received FROM opencollective.collectives WHERE slug = 'fastapi'

업스트림 기여 (Upstream Contributions)

다른 개발자들이 이를 활용할 수 있도록 돕기 위해, 공식 withcoral/coral 저장소에 **3개의 업스트림 풀 리퀘스트 (Pull Requests)**를 보냈습니다:

PR #827: PyPI 패키지 소스 사양 및 문서 추가.
PR #828: npm 패키지 소스 사양 및 문서 추가.
PR #829: Open Collective GraphQL 소스 사양 및 문서 추가.

원시 데이터에서 실행 가능한 인사이트로

Coral 엔진이 쿼리를 실행하고 구조화된 레코드를 반환하면, RepoRank는 해당 데이터를 **Hugging Face Qwen 2.5 (72B Instruct)**로 전달합니다.

구조화된 JSON 스키마 (JSON schema) 출력을 사용하여, Qwen은 전문적인 오픈 소스 분석가 역할을 수행하며 다음을 반환합니다:

영향력 점수 (Impact Score, 0-100): 여러 지표를 종합하여 매핑된 점수.
영향력 서사 (Impact Narrative): 프로젝트의 실질적인 가치를 전문적이고 평이한 영어로 요약한 내용.
펀딩 피치 (Funding Pitch): 후원 양식에 바로 복사하여 붙여넣을 수 있는 강렬한 한 문장의 엘리베이터 피치.
타겟 보조금 (Targeted Grants): 언어, 생태계 및 프로젝트 규모에 맞는 3~5개의 특정 프로그램(예: Google Summer of Code, PSF, MOSS, GitHub Sponsors) 추천.

프리미엄 사용자 경험

백엔드의 강력한 성능에 맞춰, 다음과 같은 기능을 갖춘 다크 모드 대시보드를 구축했습니다:

대화형 SVG 레이더 차트 (Interactive SVG Radar Charts): 6가지 핵심 지표(Stars, Forks, Downloads, Community Buzz, Financial Backing, Repository Health)에 걸친 프로젝트의 균형을 시각적으로 표현합니다.
세션 유지 GitHub 인증 (Session-Persistent GitHub Auth): GitHub 계정을 연결하고 사이드바에서 저장소를 불러온 뒤, 저장소를 클릭하기만 하면 즉시 분석을 실행할 수 있습니다.
클릭 가능한 지원금 카드 (Clickable Grant Cards): 알려진 지원금 신청 페이지로 연결되는 직접 링크가 하드매핑되어 있으며, 새로운 프로그램의 경우 Google 검색을 통한 동적 폴백 (fallback) 기능을 제공합니다.
조사 가능한 쿼리 (Inspectable Queries): 개발자가 Coral 엔진에 의해 실행된 정확한 쿼리를 확인할 수 있도록 접이식 SQL 상세 보기 기능을 제공합니다.
키보드 네비게이션 (Keyboard Navigation): Cmd+K로 검색창에 포커스, Cmd+Enter로 분석 실행, Esc로 모달 창을 종료할 수 있습니다.

핵심 요약 (Key Takeaways)

API 게이트웨이로서의 SQL (SQL as an API Gateway): API를 SQL 테이블로 취급하면 데이터 오케스트레이션 (orchestration)이 훨씬 단순해집니다. SQL로 교차 소스 조인 (cross-source joins)을 작성하는 것이 비동기 API 집계 루프 (asynchronous API aggregation loops)를 작성하는 것보다 더 깔끔합니다.
커뮤니티 확장 (Community Expansion): YAML 명세 (specifications)를 작성하여 Coral의 기능을 확장하는 것은 선언적 소스 매핑 (declarative source mappings)이 얼마나 강력한지를 보여줍니다.
개발자 중심 AI (Developer-centric AI): AI 모델은 구조화되고 사전 필터링된 데이터가 제공될 때 가장 효과적입니다. Coral의 데이터 수집 능력과 LLM의 합성 (synthesis) 능력을 결합하면 훌륭한 파이프라인을 구축할 수 있습니다.

🔗 링크 및 리소스

GitHub 저장소: himanshu748/reporank
업스트림 풀 리퀘스트 (Upstream Pull Requests): Coral Pull Requests 페이지

Coral-bean 해커톤의 해적들을 위해 제작되었습니다. 즐거운 항해 되세요! 🏴‍☠️

RepoRank 구축하기 — 오픈 소스 영향력 및 펀딩 준비 엔진

요약

핵심 포인트