haystack

CI/CD

문서

패키지

메타

Haystack은 Python으로 프로덕션 환경에 바로 사용할 수 있는 LLM 애플리케이션을 구축하기 위한 오픈소스 AI 오케스트레이션 프레임워크입니다.

검색, 라우팅, 메모리, 생성을 명시적으로 제어할 수 있는 모듈형 파이프라인과 에이전트 워크플로를 설계하세요. 확장 가능한 RAG 시스템, 멀티모달 애플리케이션, 시맨틱 검색, 질의응답, 자율 에이전트를 투명한 아키텍처 위에서 구축할 수 있으며, 이를 통해 실험하고 깊이 있게 커스터마이즈하며 자신 있게 배포할 수 있습니다.

목차

설치
문서
기능
Haystack Enterprise: 지원 및 플랫폼
텔레메트리
🖖 커뮤니티
Haystack에 기여하기
Haystack을 사용하는 조직

설치
Haystack을 가장 간단하게 설치하는 방법은 pip를 사용하는 것입니다:

pip install haystack-ai
최신 기능을 사용해 보려면 nightly 사전 릴리스 버전을 설치하세요:

pip install --pre haystack-ai
Haystack은 Docker 이미지를 포함한 다양한 설치 방법을 지원합니다. 자세한 안내는
문서 를 참고하세요.

문서
프로젝트가 처음이라면 "What is Haystack?"을 확인한 뒤
"Get Started Guide"를 따라 몇 분 만에 첫 LLM 애플리케이션을
구축해 보세요. 튜토리얼 을 통해 계속 학습할 수 있습니다. 더 고급
사용 사례나 영감을 얻고 싶다면
Cookbook 에서 Haystack 레시피를 살펴보세요.

언제든지 문서 를 확인하여 Haystack에 대해, Haystack이 무엇을 해줄 수 있는지, 그리고 그 이면의 기술에 대해 더 알아보세요.

기능
프로덕션을 위해 설계된 에이전트

가드레일과 커스텀 로직을 위한 라이프사이클 훅( before_llm , before_tool , on_exit , …)으로 에이전트 동작을 확장하고, 모니터링과 비용 관리를 위해 step_count , token_usage , 도구 호출을 기본으로 추적하세요. Agent Pack 의 바로 사용 가능한 에이전트(예: 딥 리서치 에이전트, 고급 RAG 에이전트)로 빠르게 시작하거나, SkillToolset 을 통해 자체 에이전트에 점진적 스킬 탐색 기능을 부여하여 필요할 때만 스킬 설명이 컨텍스트에 포함되도록 하세요.

컨텍스트 엔지니어링을 위해 설계됨

정보가 모델에 도달하기 전에 검색, 순위 지정, 필터링, 결합, 구조화, 라우팅되는 방식을 명시적으로 제어할 수 있는 유연한 시스템을 설계하세요. 검색, 메모리, 도구, 생성이 투명하고 추적 가능한 파이프라인과 에이전트 워크플로를 정의하세요.

네이티브 비동기 지원

하나의 Pipeline이 동기 또는 비동기로 실행되며 토큰 단위로 스트리밍합니다. Agent는 동시 도구 호출을 실행할 수 있습니다.

모듈형 및 커스터마이즈 가능

검색, 인덱싱, 도구 호출, 메모리, 평가를 위한 내장 컴포넌트를 사용하거나 직접 만들 수 있습니다. 루프, 분기, 조건부 로직을 추가하여 컨텍스트가 파이프라인과 에이전트 워크플로를 통해 이동하는 방식을 정밀하게 제어하세요.

모델 및 벤더 독립적

OpenAI, Mistral, Anthropic, Cohere, Hugging Face, Google, Azure OpenAI, AWS Bedrock, 로컬 모델 등 다양한 모델과 통합하세요. 시스템을 다시 작성하지 않고도 모델이나 인프라 컴포넌트를 교체할 수 있습니다.

확장 가능한 생태계

일관된 인터페이스를 통해 커스텀 컴포넌트를 구축하고 공유하여 커뮤니티와 서드파티가 Haystack을 쉽게 확장하고 개방형 생태계에 기여할 수 있도록 하세요.

Tip

Haystack 파이프라인을 REST API 또는 MCP 서버 로 배포하고 서비스하고 싶으신가요? Hayhooks는 파이프라인과 에이전트를 커스텀 로직으로 감싸 HTTP 엔드포인트 또는 MCP를 통해 노출하는 간단한 방법을 제공합니다. OpenAI 호환 채팅 완료 엔드포인트도 지원하며 open-webui 같은 채팅 UI와 함께 사용할 수 있습니다.

Haystack Enterprise: 지원 및 플랫폼
Haystack 팀의 전문가 지원을 받고, 엔터프라이즈급 템플릿으로 더 빠르게 구축하며, Haystack Enterprise Starter 를 통해 클라우드 및 온프레미스 환경을 위한 배포 가이드로 안전하게 확장하세요. 자세한 내용은 발표 게시물 에서 확인하세요.

👉 Haystack Enterprise Starter 받기

Haystack을 위한 관리형 프로덕션 환경이 필요하신가요? Haystack Enterprise Platform은 내장된 관측성, 협업, 거버넌스, 액세스 제어 기능을 갖춘 Haystack 파이프라인을 구축, 테스트, 배포, 운영할 수 있도록 도와줍니다. 관리형 클라우드 서비스 또는 자체 호스팅 솔루션으로 이용할 수 있습니다.

👉 Haystack Enterprise Platform 자세히 알아보기 또는 무료로 사용해 보기

텔레메트리
Haystack은 파이프라인 컴포넌트의 익명 사용 통계를 수집합니다. 이러한 컴포넌트가 초기화될 때마다 이벤트를 수신합니다. 이를 통해 어떤 컴포넌트가 우리 커뮤니티에 가장 관련이 있는지 알 수 있습니다.

Haystack의 텔레메트리에 대해 더 알아보거나 Haystack 문서 에서 옵트아웃하는 방법을 확인하세요.

🖖 커뮤니티
기능 요청이나 버그 보고가 있으시면 GitHub 에 이슈를 자유롭게 열어 주세요. 정기적으로 확인하고 있으므로 빠른 응답을 기대할 수 있습니다. 주제에 대해 논의하거나 Haystack을 프로젝트에 활용하는 방법에 대한 보다 일반적인 조언을 원하시면 Github Discussions 또는 Discord 채널 에 스레드를 시작하세요. 𝕏 (Twitter)와 Stack Overflow 도 확인하고 있습니다.

Haystack에 기여하기
우리는 오타 수정부터 완전히 새로운 기능까지 커뮤니티의 기여를 매우 환영합니다! 의미 있는 개선을 제공하기 위해 Haystack 전문가일 필요는 없습니다. 시작하는 방법을 알아보려면 먼저 Contributor Guidelines 를 확인하세요.

Haystack에 기여할 수 있는 방법은 여러 가지가 있습니다:

메인 Haystack 프로젝트에 기여하기
haystack-core-integrations 에 통합 기여하기
haystack/docs-website 의 문서에 기여하기

Tip

👉 기여를 환영하는 전체 이슈 목록을 확인하세요

Haystack을 사용하는 조직
Haystack은 다양한 산업 분야에서 프로덕션 AI 시스템을 구축하는 수천 개의 팀이 사용하고 있으며, 그중에는 다음이 포함됩니다:

기술 및 AI 인프라 : Apple , Meta , Databricks , NVIDIA , Intel
공공 부문 AI 이니셔티브 : European Commission , German Federal Ministry of Research, Technology, and Space (BMFTR) , PD, Baden-Württemberg State
엔터프라이즈 및 산업 AI 애플리케이션 : Airbus , Lufthansa Industry Solutions , Infineon , LEGO , Comcast , Accenture , TELUS Agriculture & Consumer Goods
지식 및 콘텐츠 플랫폼 : Netflix , ZEIT Online , Rakuten , Oxford University Press , Manz , YPulse

여러분도 Haystack을 사용하고 계신가요? PR을 열거나 여러분의 이야기를 들려주세요