Skip to content
HsPy

Start Here: Haystack Reading Paths

Which Haystack pages to read, in what order, depending on what you are building.

This section covers Haystack 3 (haystack-ai 3.5.0, checked 2026-11-19). Each path below lists pages in reading order.

  1. Comprehensive guide → Installation and Setup
  2. Architecture overview and the diagrams
  3. Components and Pipelines, including the minimal RAG pipeline
  4. Creating Agents with the Agent Class
  5. One recipe from the recipes page
  1. Migrating from Haystack 2.x
  2. The upstream MIGRATION.md
  3. Observability — tracing is no longer enabled automatically
  1. A Minimal RAG Pipeline
  2. Recipe: knowledge-base Q&A
  3. LLMRanker for re-ranking
  1. Multi-Agent Pipeline Design Patterns
  2. Multi-agent guide
  3. Advanced agents for hooks and shared state
  1. Production guide, including security and testing and evaluation
  2. Streaming server (FastAPI)
  3. Observability
PageUse it for
Comprehensive guideCore concepts, the Agent, tools, multi-agent basics, migration
Advanced agentsToken budgets, hooks, state handlers, custom components, async
Multi-agent guideCoordinator, pipeline and routing patterns
RecipesEnd-to-end examples to adapt
DiagramsPipelines, the agent loop and hooks, wrapping, multi-agent, spans
ObservabilityTracing, logging, retries, fallbacks, dead letters
Production guideServing (FastAPI, Hayhooks), security, cost, testing and evaluation, scaling
Streaming serverServer-sent events from an Agent

Code examples assume OPENAI_API_KEY is set. To try them without an API key, swap OpenAIChatGenerator for MockChatGenerator from haystack.components.generators.chat, which returns canned or echoed replies.