LangChain에 기여하기

LangChain에 기여하기 (Contributing)

LangChain을 실제로 겪어본 사람이라면 누구나 한 번쯤 "나도 이 오픈소스에 기여하고 싶다"라는 생각을 해 볼 텐데요, 이 페이지가 바로 그 시작점을 안내해 주는 개요예요. 버그 제보부터 기능 제안, 문서 개선, 코드 기여, 그리고 완전히 새로운 통합 빌드까지—여러분이 가진 역량대로 참여할 수 있는 길이 다 마련되어 있어요. 다만 PR을 보낼 때는 몇 가지 규칙을 정확히 지켜야 하니, 그 부분을 꼭 짚고 넘어갈게요.

출처: 공식문서

기여하는 방법

버그 제보 (Report bugs)

버그를 발견했다면 먼저 해당 저장소의 GitHub Issues에서 이미 같은 이슈가 열려 있는지 검색해 봐요. 대상 저장소는 각각 아래와 같아요.

없는 이슈라면 새로 만들되, 반드시 템플릿을 따르고 최소 재현 예제를 포함해야 해요. 유지보수자가 재현할 수 없는 이슈는 제때 처리되기 어렵거든요. 이슈를 올릴 때는 한 이슈에 한 주제만 유지하는 게 좋아요. 두 이슈가 서로 연관되거나 블로킹한다면 하나로 합치지 말고 링크로 연결해서 표현해요.

This issue is blocked by #123 and related to #456.

기능 제안 (Suggest features)

새 기능 아이디어가 있다면 먼저 각 저장소에서 기존 기능 요청을 검색해 보고, 없으면 관련 카테고리에서 논의를 시작해 커뮤니티 피드백을 받아요. 제안할 땐 사용 사례와 다른 사람들에게 왜 가치 있는지를 설명하고, 가능하면 예시나 목업, 통과해야 할 테스트 케이스까지 정리해 주는 게 좋아요.

문서 개선 (Improve documentation)

문서 기여도 언제나 환영이에요. How to propose changes to the documentation 가이드를 참고하면 어떤 방식으로 제안하는지 전체 과정을 알 수 있어요.

코드 기여 (Contribute code)

작은 팀이라 모든 기능 요청과 버그 수정을 따라잡기 어려운 상황이라, 여러분의 코드 기여가 큰 도움이 돼요. 이슈를 맡아서 작업하기 시작하면 반드시 본인이나 유지보수자에게 assign을 요청해 중복 작업을 피하세요. 무엇부터 작업할지 찾고 있다면 각 저장소에서 "help wanted" 라벨이 붙은 이슈를 살펴보는 걸 추천해요. 첫 PR 만드는 방법은 How to make your first Pull Request 가이드에 자세히 나와 있어요.

새 통합 빌드 (Build a new integration)

통합 패키지는 누구나 직접 만들어 PyPI나 npm에 독립적으로 배포할 수 있어요. 새 통합은 langchain-ai 저장소로의 PR로는 받지 않는다는 점이 중요해요. LangChain 통합을 만드는 방법은 Guide to building a LangChain integration에서, 샌드박스 통합을 만드는 방법도 같은 가이드에서 확인할 수 있어요.

Pull request 요구사항

모든 PR은 반드시 유지보수자가 승인한 해결책이 존재하는 이슈나 논의에 연결되어야 해요. 접근 방식을 승인받고 해당 이슈가 나에게 assign되기 전에는 PR을 열지 않는 게 원칙이에요. 승인 전에 일찍 열린 PR은 자동으로 닫힐 수 있고, assign 전에는 리뷰되지 않아요.

PR을 만들 때 드는 노력이 유지보수자가 리뷰하는 노력보다 적다면, 그 기여는 제출하지 않는 게 맞아요. 맥락 관련성·정확성·품질 측면에서 저품질 기여가 되기 쉽거든요. 대량으로 자동 생성된 기여는 사람의 노력에 대한 DoS 공격으로 간주해요.

모든 외부 PR에 적용되는 요구사항은 다음과 같아요.

  • 유지보수자가 승인한 이슈나 논의에 연결되고, PR을 열기 전에 해당 이슈가 기여자에게 assign되어야 한다.
  • 저장소의 PR 템플릿을 채워서 제출해야 한다.
  • 완전히 새로운 기능이나 동작을 바꾸는 버그 수정에는 사용자에게 보이는 변경을 릴리스 노트 형식으로 적은 ## Release note 섹션이 포함되어야 한다.

이 요구사항을 충족하지 못하면 유지보수자는 코멘트 없이 PR을 닫을 권리가 있어요. 저품질 스팸으로 보이는 PR과 이슈는 닫혀요.

언어 정책

이슈, PR, 코드 리뷰, 논의를 포함한 모든 기여는 영어로 작성해야 해요. 그래야 전 세계 기여자들이 접근하고 검색할 수 있어요. 영어가 모국어가 아니어도 걱정하지 마세요. 완벽한 문법보다 명확한 커뮤니케이션을 더 중요하게 여기고, 번역 도구 사용도 환영해요.

LLM의 허용 가능한 사용

AI 어시스턴트로 기여 초안을 작성하거나 수정하는 것은 괜찮아요. 단, 모든 변경을 검증해야 해요—코드를 실행·테스트하고, 코드베이스와 공식 프로바이더 문서에 대해 사실을 확인하고, 결과가 저장소 스타일과 일치하는지 확인하는 거죠. 검토되지 않은 대량 생성 콘텐츠는 제출해서는 안 돼요. 어떤 방식으로 만들어졌든 저품질이거나 스팸처럼 읽히는 PR은 닫혀요.

더 알아보기 (Learn more)