文档API 参考📓 教程🧑‍🍳 食谱🤝 集成💜 Discord🎨 Studio
文档

安装

查看如何使用 pip 或 conda 快速安装 Haystack。

软件包安装

使用 pip 仅安装 Haystack 代码

pip install haystack-ai

或者,您也可以使用 conda

conda config --add channels conda-forge/label/haystack-ai_rc
conda install haystack-ai

您是否已经在使用了 Haystack 1.x?

🚧

警告

安装farm-haystackhaystack-ai 在同一个 Python 环境(virtualenv、Colab 或系统)中会导致问题。

将这两个软件包安装在同一个环境中可能会以难以预测的方式正常工作或失败。我们建议每个 Python 环境只安装其中一个软件包。请确保您在同一环境中卸载这两个软件包,然后只安装其中一个。

pip uninstall -y farm-haystack haystack-ai
pip install haystack-ai

如果您有任何疑问,请通过 GitHub 讨论Discord 与我们联系。

可选依赖项

Haystack 中的某些组件依赖于额外的可选依赖项。
为了保持安装轻量级,默认不包含这些依赖项——只安装了必需的核心组件。
如果您使用需要尚未安装的可选依赖项的功能,Haystack 将引发一个错误,指示您安装缺失的依赖项,例如

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

为 Haystack 做出贡献

如果您想为 Haystack 做出贡献,请先查看我们的 贡献者指南

要能够修改 Haystack 代码,请使用以下命令进行安装

# 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]'