통합 패키지 배포하기

통합 패키지 배포하기 (Publish an integration)

여러분이 만든 통합을 커뮤니티에 공개하는 방법을 다뤄요. 패키지를 구현하고 테스트까지 마쳤다면 이제 PyPI 같은 패키지 레지스트리에 올리고, LangChain 문서에 목록을 등록해서 다른 개발자들이 찾을 수 있게 해야 하죠.

출처: 공식문서

주의사항 (중요한 경고)

LangChain이나 Deep Agents 저장소에 통합 PR을 올리지 마세요.

새 통합은 자신의 GitHub 조직이나 계정 아래 독립된 PyPI 패키지(예: langchain-yourservice)로 배포해야 해요. langchain-ai/langchain 저장소에 PR로 넣는 게 아니에요.

메인 저장소에는 LangChain 팀이 관리하는 소수의 퍼스트파티 통합(OpenAI, Anthropic, Ollama 등)만 들어 있어요.

패키지 배포 (Publishing your package)

이 가이드는 이미 패키지를 구현하고 테스트까지 작성했다고 가정해요. 아직이라면 구현 가이드와 테스트 가이드를 먼저 보세요.

이 가이드에서는 패키지 레지스트리로 PyPI를 씁니다. 다른 레지스트리를 선호하면 그쪽을 선택해도 되는데, 절차는 달라질 수 있어요.

자격 증명 설정 (Setup credentials)

먼저 PyPI 계정이 있어야 해요.

  1. 계정 만들기 — PyPI 웹사이트에서 계정을 생성해요.
  2. 이메일 인증 — PyPI가 보내는 이메일의 링크를 눌러 이메일 주소를 인증해요.
  3. 2FA 활성화 — 계정 설정에서 "Generate Recovery Codes"를 눌러 2FA를 켜요. API 토큰을 만들려면 2FA가 반드시 활성화돼 있어야 해요.
  4. 토큰 생성 — 계정 설정에서 새 API 토큰을 생성해요.

빌드와 배포 (Build and publish)

uv의 패키지 빌드·배포 가이드를 참고해서 PyPI에 배포하면 돼요.

통합을 발견 가능하게 만들기 (Make your integration discoverable)

배포 후, LangChain 문서 저장소에 Integration listing 이슈를 제출하면 여러분의 패키지가 integrations 탭 아래에 표시돼요.

메인테이너가 이슈를 검토하고 integration-run 라벨을 붙이면, 자동화가 폼 필드를 읽어 아래의 자격 규칙을 적용하고, 메인테이너와 여러분을 리뷰로 태그하는 PR을 엽니다. 폼에는 파트너 문서 URL을 넣는 게 좋아요.

신규 목록에 대해 메인테이너가 요청하지 않으면 수동으로 docs PR을 열지 마세요.

호스티드 가이드 자격 (Eligibility for hosted guides)

LangChain은 다음 둘 중 하나에 해당할 때만 이 docs 저장소에 전체 통합 가이드를 호스팅해요.

  • 패키지가 PyPI(또는 TypeScript면 npm)에서 월 5만 회 이상 다운로드되거나,
  • 메인테이너가 통합을 featured로 표시한 경우

어느 기준도 충족하지 못하면, 자동화가 여러분의 문서로 연결되는 외부 목록(YAML + 다운로드 표 + 프로바이더 카드)을 추가해요. 호스티드 MDX 페이지는 만들지 않죠.

다운로드 표에 등록 (기본 방식, List in the download table)

Integration listing 이슈를 제출할 때 고정된 폼 필드(표시 이름, 언어, 컴포넌트, 패키지 이름, 문서 URL, 간단한 프로바이더 설명)를 채워요. 자동화가 이슈에서 scripts/data/integration_external_docs.yaml과 관련 목록 표면을 채워요.

각 목록에는 최소한 다음이 필요해요.

  • name: LangChain 클래스 또는 표시 이름 (예: ChatAI21).
  • pypi 또는 npm: 다운로드 배지에 쓰는 레지스트리 패키지 이름.
  • docs_url: 이름 열의 링크. 파트너 문서 → GitHub 저장소 → PyPI/npm 페이지 순으로 우선해요.

이슈 폼에 컴포넌트별 기능 플래그(예: chat의 stream, tool_calling)를 선택적으로 넣어 표 열이 정확하게 유지되게 할 수 있어요.

머지 후 refresh 작업이 컴포넌트 표 스니펫을 재생성해서, 여러분의 행이 호스티드 통합 옆에 나타나요.

이 흐름은 목록 메타데이터만을 위한 거예요. 사용 문서는 여러분의 사이트나 GitHub README에 호스팅하세요. 통합 패키지 자체는 여러분의 GitHub 조직/계정 아래 독립 저장소에서 독립 패키지로 배포해야 해요.

패키지가 자격 기준을 충족하면, Integration listing 자동화가 다음 템플릿 중 하나로 문서 페이지를 포함한 PR을 열 수 있어요. 메인테이너가 호스티드 페이지를 수동으로 작성·수정해 달라고 요청할 수도 있어요.

통합 유형에 따라 서로 다른 문서 페이지를 만들어야 해요. LangChain은 유형별 템플릿을 제공해요.

기존 문서를 참고하고 싶다면 통합 목록에서 비슷한 통합을 찾아봐요. 특정 문서 페이지를 raw 마크다운으로 보려면 페이지 오른쪽 위 "Copy page" 옆 드롭다운 버튼에서 "View as Markdown"을 선택하면 돼요.

호스티드 페이지를 수동으로 편집해 달라는 요청을 받으면 LangChain docs 저장소를 fork하고(메인 langchain 저장소가 아니라), 해당 템플릿을 따른 뒤 문서 가이드를 따르세요.

패키지가 이전에 integration_external_docs.yaml에 이미 등록돼 있었다면, 같은 PR에서 해당 YAML 항목을 제거해 표에 중복 행이 생기지 않게 하세요.

메인테이너가 요청하지 않으면 frontmatter에 featured: true를 설정하지 마세요. featured 상태는 메인테이너 결정 사항이에요.

호스티드 가이드 PR은 문서 전용이에요. 통합 패키지 자체는 여러분의 GitHub 조직/계정 아래 독립 저장소에서 독립 패키지로 배포돼야 해요.

다음 경우에는 목록 이슈나 PR을 거부하거나 수정을 요청할 수 있어요.

제출량이 많으니 인내심을 가져주세요. 자동화 PR이 열리면 검토하세요. 이슈나 PR에 대해 메인테이너를 반복적으로 태그하지 마세요.

PR에 AI 생성 콘텐츠가 포함되면 LLM 허용 사용 정책을 따라야 해요.

다음 단계 (Next steps)

축하해요! 여러분의 통합이 배포되고 LangChain 커뮤니티에 등록됐어요.

더 알아보기 (Learn more)