| | |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CI/CD | [](https://github.com/deepset-ai/haystack/actions/workflows/tests.yml) [](https://github.com/python/mypy) [](https://coveralls.io/github/deepset-ai/haystack?branch=main) [](https://github.com/astral-sh/ruff) |
| 文档 | [](https://docs.haystack.deepset.ai) |
| 包管理 | [](https://pypi.org/project/haystack-ai/)   [](https://anaconda.org/conda-forge/haystack-ai) [](LICENSE) [](https://github.com/deepset-ai/haystack/actions/workflows/license_compliance.yml) |
| 社区 | [](https://discord.com/invite/xYvH6drSmA) [](https://twitter.com/haystack_ai) |
Haystack 是一个开源的 AI 编排框架，用于在 Python 中构建生产就绪的 LLM 应用。
通过显式控制检索、路由、记忆和生成过程，设计模块化的流水线和智能体工作流。构建可扩展的 RAG 系统、多模态应用、语义搜索、问答系统和自主智能体，这一切都在一个透明的架构中完成，让您可以放心地进行实验、深度定制和部署。
目录
安装
通过 pip 安装 Haystack 是最简单的方式：
pip install haystack-ai
从 main 分支安装以体验最新功能：
pip install git+https://github.com/deepset-ai/haystack.git@main
Haystack 支持多种安装方式，包括 Docker 镜像。完整指南请参阅文档。
文档
如果您是项目新手，请先查看 "什么是 Haystack？"，然后按照 "快速入门指南" 在几分钟内构建您的第一个 LLM 应用。通过教程继续学习。对于更高级的用例，或者只是为了获取灵感，您可以在 Cookbook 中浏览我们的 Haystack 配方。
随时可以查阅文档，了解更多关于 Haystack 的信息、它能为您做什么以及背后的技术。
特性
专为上下文工程而建
设计灵活的系统，显式控制信息在被模型接收之前如何被检索、排序、过滤、组合、结构化和路由。定义流水线和智能体工作流，其中检索、记忆、工具和生成过程都是透明且可追溯的。
模型与供应商无关
与 OpenAI、Mistral、Anthropic、Cohere、Hugging Face、Azure OpenAI、AWS Bedrock、本地模型以及许多其他服务集成。无需重写系统即可交换模型或基础设施组件。
模块化且可定制
使用内置组件进行检索、索引、工具调用、记忆和评估，或者创建您自己的组件。添加循环、分支和条件逻辑，精确控制上下文如何在您的流水线和智能体工作流中移动。
可扩展的生态系统
通过一致的接口构建和共享自定义组件，使社区和第三方能够轻松扩展 Haystack 并为开放生态系统做出贡献。
[!TIP]
您是否希望将 Haystack 流水线作为 REST API 或 MCP 服务器 进行部署和服务？Hayhooks 为您提供了一种简单的方法，可以用自定义逻辑包装流水线和智能体，并通过 HTTP 端点或 MCP 将其暴露出来。它还支持 OpenAI 兼容的聊天完成端点，并可与 open-webui 等聊天界面配合使用。
Haystack 企业版：支持与平台
通过 Haystack 企业版入门包，获得 Haystack 团队的专业支持，使用企业级模板更快地构建，并通过适用于云和本地环境的部署指南安全地扩展。在公告文章中了解更多信息。
需要 Haystack 的托管生产环境吗？Haystack 企业版平台 帮助您构建、测试、部署和运营 Haystack 流水线，内置可观测性、协作、治理和访问控制。它可作为托管云服务或自托管解决方案提供。
👉 了解更多关于 Haystack 企业版平台 或 免费试用
遥测
Haystack 收集流水线组件的匿名使用统计数据。每当这些组件被初始化时，我们都会收到一个事件。通过这种方式，我们可以了解哪些组件对我们的社区最相关。
在 Haystack 文档 中阅读更多关于 Haystack 中的遥测信息或如何选择退出。
🖖 社区
如果您有功能请求或错误报告，请随时在 GitHub 上提交问题。我们会定期检查这些问题，因此您可以期待快速响应。如果您想讨论某个主题，或获得关于如何让 Haystack 为您的项目工作的更一般性建议，可以在 GitHub Discussions 或我们的 Discord 频道 中发起讨论。我们也会关注 𝕏 (Twitter) 和 Stack Overflow。
为 Haystack 做贡献
我们非常欢迎社区的贡献——无论是快速修复一个拼写错误，还是一个全新的功能！您不需要是 Haystack 专家也能提供有意义的改进。要了解如何开始，请先查看我们的贡献者指南。
有几种方式可以为 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 或告诉我们您的故事
目前尚无回复