Hayhooks

by deepset-ai

148 stars
615 downloads
Not rated
GitHub Website

About

Deploy and serve Haystack pipelines as REST APIs, MCP Tools, and OpenAI-compatible chat completion backends.

Details

Author
deepset-ai
GitHub stars
148
Downloads
615
Categories
Developer Tools, API, AI, Automation, Other

- Easy deployment of Haystack pipelines and agents as REST APIs
- Expose pipelines as MCP tools for AI development environments
- Support for A2A protocol for inter-agent discovery and task delegation
- Embedded Chainlit chat UI with streaming and pipeline selection
- OpenAI-compatible chat completion endpoints with streaming support
- OpenTelemetry tracing with a local dashboard for lifecycle visibility

Install with pip install hayhooks, then run hayhooks run. Create a pipeline wrapper class inheriting from BasePipelineWrapper, deploy it with hayhooks pipeline deploy-files -n <name> <directory>, and call the resulting HTTP endpoints or interact via MCP/A2A clients. Optionally add Chainlit UI with hayhooks run --with-chainlit or tracing with pip install "hayhooks[tracing]".

Hayhooks

Hayhooks makes it easy to deploy and serve Haystack Pipelines and Agents.

With Hayhooks, you can:

- 📦 Deploy your Haystack pipelines and agents as REST APIs with maximum flexibility and minimal boilerplate code.
- 🛠️ Expose your Haystack pipelines and agents over the MCP protocol, making them available as tools in AI dev environments like Cursor or Claude Desktop. Under the hood, Hayhooks runs as an MCP Server, exposing each pipeline and agent as an MCP Tool.
- 🤝 Expose your Haystack pipelines and agents over the A2A protocol (pip install "hayhooks[a2a]"), so other agents can discover them through auto-generated agent cards and delegate tasks to them via hayhooks a2a run.
- 💬 Integrate your Haystack pipelines and agents with Open WebUI as OpenAI-compatible chat completion backends with streaming support.
- 🖥️ Embed a Chainlit chat UI directly in Hayhooks with pip install "hayhooks[chainlit]" and hayhooks run --with-chainlit -- zero-configuration frontend with streaming, pipeline selection, and custom UI widgets.
- 🕹️ Control Hayhooks core API endpoints through chat - deploy, undeploy, list, or run Haystack pipelines and agents by chatting with Claude Desktop, Cursor, or any other MCP client.
- 📈 Trace Hayhooks lifecycle actions with OpenTelemetry (pip install "hayhooks[tracing]") for deploy/run/undeploy visibility across REST and MCP, with a /dashboard UI via hayhooks run --with-tracing-dashboard (backed by a local live trace buffer).

PyPI - Version
PyPI - Python Version
Docker image release
Tests

Documentation

> 📚 For detailed guides, examples, and API reference, check out our comprehensive documentation.

Quick Start

1. Install Hayhooks

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.