릴리스 정책 살펴보기
릴리스 정책 살펴보기 (Release policy)
이 페이지는 LangChain과 LangGraph, 그리고 Deep Agents의 릴리스 정책을 설명해요. 세 패키지가 각자 조금씩 다른 릴리스 규칙을 가지니, 자신이 쓰는 패키지의 탭 기준으로 보면 돼요. LangChain 에코시스템은 langchain-core, langchain, 파트너 패키지 등 서로 다른 컴포넌트 패키지들로 구성되어 있어요.
출처: 공식문서
LangChain
릴리스 주기
LangChain 1.0부터 langchain과 langchain-core의 minor 릴리스(예: 1.0.x → 1.1.0)는 시맨틱 버저닝을 따르고 자주 릴리스될 수 있어요. Minor 릴리스는 새 기능·개선을 담지만 breaking change는 없어요. Patch 릴리스는 버그 수정·사소한 개선이라 주당 여러 번까지 자주 릴리스돼요.
API 안정성
LLM 애플리케이션 개발은 빠르게 진화하는 분야라 API도 계속 진화해요. LangChain 1.0의 시맨틱 버저닝을 따라:
- 공개 API의 breaking change는 major 버전 릴리스(예:
2.0.0)에서만 발생 - Minor 버전 상향(
1.0.0→1.1.0)은 breaking change 없이 새 기능 추가 - Patch 버전 상향(
1.0.0→1.0.1)은 버그 수정·사소한 개선
폐기 정책
더 나은 대안이 나올 때까지는 일반적으로 폐기(deprecate)하지 않아요. 폐기된 기능은 1.x 릴리스 시리즈 전체에서 계속 동작하고, breaking change(폐기 기능 제거 포함)는 major 버전 릴리스(예: 2.0)에서만 일어나요. 폐기 시 코드·문서에 명확히 표시하고, 권장 대안으로의 마이그레이션 가이드와 모든 1.x minor 릴리스 동안 보안 업데이트를 제공해요.
LTS
- LangChain 1.0: LTS로 지정. 2.0 릴리스까지 ACTIVE, 2.0 출시 후 최소 1년간 MAINTENANCE 모드. minor 버전 간 업그레이드가 breaking change 없이 가능.
- LangChain 0.3: MAINTENANCE 모드, 2026년 12월까지 지원, 보안 패치·중요 버그 수정 포함.
LangGraph
릴리스 주기
major 릴리스는 최소 612개월 간격, minor 릴리스는 12개월마다 새 기능·개선, patch 릴리스는 버그·보안 대응으로 주간 단위로 릴리스돼요.
API 안정성
- Stable APIs: 특별한 접두사 없는 모든 API는 안정적이고 프로덕션 사용 가능. major 버전 내에서 backward compatibility 유지.
- Beta: 기능 완성·테스트 완료, 변경될 수 있음을 감안해 프로덕션에 사용 가능, 사용자 피드백에 따라 사소한 API 조정 가능.
- Experimental/alpha: 활발히 개발 중, 크게 바뀌거나 제거될 수 있음, 프로덕션에서 주의.
- Internal APIs: 밑줄(
_) 접두사 또는 명시적으로 internal로 표시. 공개 API가 아니며 예고 없이 변경될 수 있음.
플랫폼 호환성 · Python
- Python Software Foundation이 활발히 유지보수하는 Python 버전을 지원. Python 요구 사양 변경은 major 릴리스에서만. 현재 Python 3.10 이상 필요.
LTS
- LangGraph 1.0: LTS 지정. 2.0 릴리스까지 ACTIVE, 2.0 출시 후 최소 1년 MAINTENANCE.
- LangGraph 0.4: MAINTENANCE 모드, 2026년 12월까지 모든 보안 패치·중요 버그 수정 지원.
Deep Agents
deepagents는 고급 에이전트 아키텍처를 만드는 빠르게 진화하는 패키지예요. 현재 pre-1.0 개발 단계로, breaking change를 최소화하려 하지만 에이전트 앱 환경이 빠르게 변하면서 API가 진화할 수 있어요.
- minor 릴리스(
0.1.0→0.2.0): 새 기능과 잠재적 breaking change - patch 릴리스(
0.1.0→0.1.1): breaking change 없는 버그 수정·개선 - pre-1.0에서는 minor 버전 사이에도 API가 바뀔 수 있고,
experimental/alpha로 표시된 기능은 더 큰 변경이 가능해요.
Deep Agents가 1.0에 도달하는 조건은: 핵심 API가 커뮤니티 피드백으로 안정화되고, 프로덕션에서 충분히 검증되고, 핵심 기능에 breaking change가 더 이상 예상되지 않을 때예요. 1.0 이후에는 LangChain·LangGraph와 같은 시맨틱 버저닝과 LTS 정책을 따르게 돼요.
더 알아보기 (Learn more)
- 버저닝(Versioning) — 버전 번호와 지원 상세
- 릴리스(Releases) — 버전별 릴리스 노트·마이그레이션 가이드