haystack-ai 2.27.0


pip install haystack-ai

  Latest version

Released: Apr 01, 2026


Meta
Author: deepset.ai
Requires Python: >=3.10

Classifiers

Development Status
  • 5 - Production/Stable

Intended Audience
  • Science/Research

License
  • Freely Distributable
  • OSI Approved :: Apache Software License

Operating System
  • OS Independent

Programming Language
  • Python
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14

Topic
  • Scientific/Engineering :: Artificial Intelligence
Blue banner with the Haystack logo and the text ‘haystack by deepset – The Open Source AI Framework for Production Ready RAG & Agents’ surrounded by abstract icons representing search, documents, agents, pipelines, and cloud systems.
CI/CD Tests types - Mypy Coverage Status Ruff
Docs Website
Package PyPI PyPI - Downloads PyPI - Python Version Conda Version GitHub License Compliance
Meta Discord Twitter Follow

Haystack is an open-source AI orchestration framework for building production-ready LLM applications in Python.

Design modular pipelines and agent workflows with explicit control over retrieval, routing, memory, and generation. Build scalable RAG systems, multimodal applications, semantic search, question answering, and autonomous agents, all in a transparent architecture that lets you experiment, customize deeply, and deploy with confidence.

Table of Contents

Installation

The simplest way to get Haystack is via pip:

pip install haystack-ai

Install nightly pre-releases to try the newest features:

pip install --pre haystack-ai

Haystack supports multiple installation methods, including Docker images. For a comprehensive guide, please refer to the documentation.

Documentation

If you're new to the project, check out "What is Haystack?" then go through the "Get Started Guide" and build your first LLM application in a matter of minutes. Keep learning with the tutorials. For more advanced use cases, or just to get some inspiration, you can browse our Haystack recipes in the Cookbook.

At any given point, hit the documentation to learn more about Haystack, what it can do for you, and the technology behind.

Features

Built for context engineering
Design flexible systems with explicit control over how information is retrieved, ranked, filtered, combined, structured, and routed before it reaches the model. Define pipelines and agent workflows where retrieval, memory, tools, and generation are transparent and traceable.

Model- and vendor-agnostic
Integrate with OpenAI, Mistral, Anthropic, Cohere, Hugging Face, Azure OpenAI, AWS Bedrock, local models, and many others. Swap models or infrastructure components without rewriting your system.

Modular and customizable
Use built-in components for retrieval, indexing, tool calling, memory, and evaluation, or create your own. Add loops, branches, and conditional logic to precisely control how context moves through your pipelines and agent workflows.

Extensible ecosystem
Build and share custom components through a consistent interface that makes it easy for the community and third parties to extend Haystack and contribute to an open ecosystem.

[!TIP]

Would you like to deploy and serve Haystack pipelines as REST APIs or MCP servers? Hayhooks provides a simple way for you to wrap pipelines and agents with custom logic and expose them through HTTP endpoints or MCP. It also supports OpenAI-compatible chat completion endpoints and works with chat UIs like open-webui.

Haystack Enterprise: Support & Platform

Get expert support from the Haystack team, build faster with enterprise-grade templates, and scale securely with deployment guides for cloud and on-prem environments with Haystack Enterprise Starter. Read more about it in the announcement post.

👉 Get Haystack Enterprise Starter

Need a managed production setup for Haystack? The Haystack Enterprise Platform helps you build, test, deploy and operate Haystack pipelines with built-in observability, collaboration, governance, and access controls. It’s available as a managed cloud service or as a self-hosted solution.

👉 Learn more about Haystack Enterprise Platform or try it free

Telemetry

Haystack collects anonymous usage statistics of pipeline components. We receive an event every time these components are initialized. This way, we know which components are most relevant to our community.

Read more about telemetry in Haystack or how you can opt out in Haystack docs.

🖖 Community

If you have a feature request or a bug report, feel free to open an issue in GitHub. We regularly check these, so you can expect a quick response. If you'd like to discuss a topic or get more general advice on how to make Haystack work for your project, you can start a thread in Github Discussions or our Discord channel. We also check 𝕏 (Twitter) and Stack Overflow.

Contributing to Haystack

We are very open to the community's contributions - be it a quick fix of a typo, or a completely new feature! You don't need to be a Haystack expert to provide meaningful improvements. To learn how to get started, check out our Contributor Guidelines first.

There are several ways you can contribute to Haystack:

[!TIP] 👉 Check out the full list of issues that are open to contributions

Organizations using Haystack

Haystack is used by thousands of teams building production AI systems across industries, including:

Are you also using Haystack? Open a PR or tell us your story

2.28.0.dev20260406000732 Apr 06, 2026
2.28.0.dev20260405000627 Apr 05, 2026
2.28.0.dev20260404000632 Apr 04, 2026
2.28.0.dev20260403000734 Apr 03, 2026
2.28.0.dev20260402000654 Apr 02, 2026
2.28.0.dev20260401000822 Apr 01, 2026
2.27.0 Apr 01, 2026
2.27.0rc1 Mar 31, 2026
2.27.0.dev20260331000750 Mar 31, 2026
2.27.0.dev20260330093611 Mar 30, 2026
2.27.0.dev20260330000715 Mar 30, 2026
2.27.0.dev20260329000632 Mar 29, 2026
2.27.0.dev20260328000606 Mar 28, 2026
2.27.0.dev20260327000645 Mar 27, 2026
2.27.0.dev20260326000756 Mar 26, 2026
2.26.1 Mar 20, 2026
2.26.1rc1 Mar 19, 2026
2.26.0 Mar 18, 2026
2.26.0rc1 Mar 16, 2026
2.25.2 Mar 05, 2026
2.25.2rc1 Mar 05, 2026
2.25.1 Feb 27, 2026
2.25.1rc1 Feb 27, 2026
2.25.0 Feb 26, 2026
2.25.0rc1 Feb 25, 2026
2.24.1 Feb 12, 2026
2.24.1rc1 Feb 12, 2026
2.24.0 Feb 12, 2026
2.24.0rc2 Feb 11, 2026
2.24.0rc1 Feb 10, 2026
2.23.0 Jan 27, 2026
2.23.0rc1 Jan 26, 2026
2.22.0 Jan 08, 2026
2.22.0rc1 Jan 07, 2026
2.21.0 Dec 08, 2025
2.21.0rc1 Dec 03, 2025
2.20.0 Nov 13, 2025
2.20.0rc2 Nov 13, 2025
2.20.0rc1 Nov 11, 2025
2.19.0 Oct 20, 2025
2.19.0rc1 Oct 20, 2025
2.18.1 Sep 29, 2025
2.18.0 Sep 22, 2025
2.18.0rc1 Sep 17, 2025
2.17.1 Aug 20, 2025
2.17.0 Aug 19, 2025
2.17.0rc2 Aug 19, 2025
2.17.0rc1 Aug 19, 2025
2.16.1 Jul 29, 2025
2.16.1rc1 Jul 29, 2025
2.16.0 Jul 29, 2025
2.16.0rc1 Jul 24, 2025
2.15.2 Jul 04, 2025
2.15.2rc1 Jul 04, 2025
2.15.1 Jun 30, 2025
2.15.1rc1 Jun 30, 2025
2.15.0 Jun 26, 2025
2.15.0rc1 Jun 25, 2025
2.14.3 Jun 19, 2025
2.14.3rc1 Jun 18, 2025
2.14.2 Jun 04, 2025
2.14.2rc1 Jun 03, 2025
2.14.1 May 30, 2025
2.14.1rc1 May 30, 2025
2.14.0 May 26, 2025
2.14.0rc2 May 26, 2025
2.14.0rc1 May 23, 2025
2.13.2 May 09, 2025
2.13.1 Apr 24, 2025
2.13.0 Apr 22, 2025
2.13.0rc2 Apr 22, 2025
2.13.0rc1 Apr 22, 2025
2.12.2 Apr 14, 2025
2.12.1 Apr 10, 2025
2.12.0 Apr 02, 2025
2.12.0rc1 Apr 01, 2025
2.11.2 Mar 18, 2025
2.11.1 Mar 13, 2025
2.11.1rc1 Mar 12, 2025
2.11.0 Mar 10, 2025
2.11.0rc3 Mar 07, 2025
2.11.0rc2 Mar 05, 2025
2.11.0rc1 Mar 05, 2025
2.10.3 Feb 20, 2025
2.10.3rc1 Feb 20, 2025
2.10.2 Feb 19, 2025
2.10.2rc1 Feb 19, 2025
2.10.1 Feb 18, 2025
2.10.1rc1 Feb 18, 2025
2.10.0 Feb 12, 2025
2.10.0rc2 Feb 12, 2025
2.10.0rc1 Feb 11, 2025
2.9.0 Jan 14, 2025
2.9.0rc1 Jan 13, 2025
2.8.1 Jan 10, 2025
2.8.1rc3 Jan 09, 2025
2.8.1rc2 Dec 18, 2024
2.8.1rc1 Dec 18, 2024
2.8.0 Dec 05, 2024
2.8.0rc3 Dec 04, 2024
2.8.0rc2 Dec 03, 2024
2.8.0rc1 Nov 26, 2024
2.7.0 Nov 11, 2024
2.7.0rc1 Oct 30, 2024
2.6.1 Oct 10, 2024
2.6.1rc1 Oct 08, 2024
2.6.0 Oct 03, 2024
2.6.0rc3 Oct 01, 2024
2.6.0rc2 Oct 01, 2024
2.5.1 Sep 10, 2024
2.5.1rc2 Sep 10, 2024
2.5.1rc1 Sep 10, 2024
2.5.0 Sep 04, 2024
2.5.0rc3 Sep 04, 2024
2.5.0rc2 Sep 02, 2024
2.5.0rc1 Sep 02, 2024
2.4.0 Aug 15, 2024
2.4.0rc1 Aug 14, 2024
2.3.1 Jul 29, 2024
2.3.1rc1 Jul 26, 2024
2.3.0 Jul 15, 2024
2.3.0rc2 Jul 10, 2024
2.3.0rc1 Jul 08, 2024
2.2.4 Jul 04, 2024
2.2.4rc1 Jul 03, 2024
2.2.3 Jun 17, 2024
2.2.2 Jun 17, 2024
2.2.2rc1 Jun 13, 2024
2.2.1 Jun 06, 2024
2.2.1rc1 Jun 05, 2024
2.2.0 Jun 03, 2024
2.2.0rc2 May 30, 2024
2.2.0rc1 May 30, 2024
2.1.2 May 16, 2024
2.1.2rc1 May 16, 2024
2.1.1 May 09, 2024
2.1.1rc1 May 09, 2024
2.1.0 May 06, 2024
2.1.0rc2 May 06, 2024
2.1.0rc1 May 02, 2024
2.0.1 Apr 09, 2024
2.0.1rc2 Apr 09, 2024
2.0.1rc1 Apr 08, 2024
2.0.0 Mar 11, 2024
2.0.0rc1 Mar 11, 2024
2.0.0b8 Feb 22, 2024
2.0.0b7 Feb 07, 2024
2.0.0b6 Feb 05, 2024
2.0.0b5 Jan 17, 2024
2.0.0b4 Jan 08, 2024
2.0.0b3 Dec 15, 2023
2.0.0b2 Dec 06, 2023
2.0.0b1 Dec 04, 2023
2.0.0a3 Nov 29, 2023
2.0.0a2 Nov 28, 2023
2.0.0a1 Nov 24, 2023

Wheel compatibility matrix

Platform Python 3
any

Files in release

Extras: None
Dependencies:
docstring-parser
filetype
haystack-experimental
jinja2
jsonschema
lazy-imports
markupsafe
more-itertools
networkx
numpy
openai (>=1.99.2)
posthog (!=3.12.0)
pydantic
python-dateutil
pyyaml
requests
tenacity (!=8.4.0)
tqdm
typing-extensions (>=4.7)