설치
설치 (Installation)
Haystack를 pip, uv, conda 중 원하는 방법으로 빠르게 설치하는 법을 살펴볼게요. 어떤 패키지 매니저를 쓰든 설치 명령 하나면 끝납니다.
출처: 공식문서
패키지 설치
pip으로 Haystack PyPI 패키지를 설치하세요:
pip install haystack-ai
또는 uv를 사용해도 됩니다:
uv pip install haystack-ai
프로젝트의 의존성으로 추가하고 싶다면 이렇게 해요:
uv add haystack-ai
conda를 쓰고 있다면 conda용 Haystack 패키지를 설치할 수 있어요:
conda install conda-forge::haystack-ai
선택적 의존성 (Optional Dependencies)
Haystack의 일부 컴포넌트는 별도의 선택적 의존성(optional dependencies)이 필요해요. 설치를 가볍게 유지하기 위해 이런 것들은 기본 설치에 포함되지 않고, 필수적인 것만 함께 설치됩니다.
설치되지 않은 선택적 의존성이 필요한 기능을 쓰면, Haystack이 누락된 의존성을 설치하라고 안내하는 오류를 던져요. 예를 들면 이런 모습입니다:
ImportError: "Haystack failed to import the optional dependency 'pypdf'. Run 'pip install pypdf'."
즉, 오류 메시지가 알려주는 명령만 실행하면 자연스럽게 해결됩니다.
Haystack 기여하기
설치가 끝났다면 공식문서의 Get Started 가이드로 넘어가서 첫 파이프라인을 만들어보세요.