Installation

See how to quickly install Haystack with pip, uv, or conda.

Package Installation

Use pip to install the Haystack PyPI package:

shell

pip install haystack-ai

Alternatively, you can use uv to install Haystack:

shell

uv pip install haystack-ai

Or add it as a dependency to your project:

shell

uv add haystack-ai

You can also use conda to install the Haystack conda package:

shell

conda install conda-forge::haystack-ai

Optional Dependencies

Some components in Haystack rely on additional optional dependencies. To keep the installation lightweight, these are not included by default – only the essentials are installed. If you use a feature that requires an optional dependency that hasn't been installed, Haystack will raise an error that instructs you to install missing dependencies, for example:

shell

ImportError: "Haystack failed to import the optional dependency 'pypdf'. Run 'pip install pypdf'.

Contributing to Haystack

If you would like to contribute to the Haystack, check our Contributor Guidelines first.

To be able to make changes to Haystack code, install with the following commands:

shell

## Clone the repo
git clone https://github.com/deepset-ai/haystack.git

## Move into the cloned folder
cd haystack

## Upgrade pip
pip install --upgrade pip

## Install Haystack in editable mode
pip install -e '.[dev]'