Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Awesome RAG Debugging Awesome

Debugging, evaluating, and tracing retrieval-augmented generation systems.

RAG systems rarely fail in just one place. They drift across ingestion, chunking, retrieval, reranking, prompting, evaluation, tracing, and infrastructure.

This list curates practical open-source tools and reference resources for finding those failures faster. It focuses on debugging value, not on collecting every RAG-related repository.

This list generally prioritizes repositories with 100+ GitHub stars, active maintenance, and clear practical value for diagnosing or fixing broken RAG behavior. GitHub star badges update automatically over time.

Contents

Failure Maps & Root-Cause Guides

Resources that help name the failure before you try to fix it.

  • WFGY GitHub stars - Reasoning engine repository that includes a structured problem map for recurrent RAG and AI pipeline failures.

Observability & Tracing

Tools for traces, spans, evaluation runs, prompt inspection, and production debugging visibility.

  • Phoenix GitHub stars - AI observability and evaluation platform for tracing, experimentation, and troubleshooting LLM applications.
  • Langfuse GitHub stars - Open-source LLM engineering platform for traces, evals, prompts, datasets, and debugging workflows.
  • OpenLIT GitHub stars - OpenTelemetry-native observability platform for LLM and agent systems with evaluation and guardrail hooks.
  • Weave GitHub stars - Toolkit for developing AI applications with logging, tracing, and evaluation support.
  • MLflow GitHub stars - Experiment tracking and observability platform with support for modern LLM and agent workflows.

Evaluation & Test Generation

Frameworks for measuring answer quality, retrieval quality, hallucination risk, and regression over time.

  • Promptfoo GitHub stars - Evaluation and red-teaming framework for prompts, agents, and RAG applications.
  • DeepEval GitHub stars - LLM evaluation framework for testing outputs, workflows, and application behavior.
  • Ragas GitHub stars - Evaluation toolkit for LLM applications with strong support for RAG metrics and test generation.
  • TruLens GitHub stars - Instrumentation and evaluation toolkit for identifying failure modes in LLM applications.
  • Giskard GitHub stars - Evaluation and testing framework for AI systems, including quality, bias, and security checks.

Retrieval Quality & Reranking

Projects that help diagnose retrieval misses, ranking weakness, and document processing problems.

  • RAGatouille GitHub stars - Retrieval toolkit built around late-interaction methods such as ColBERT for stronger ranking quality.
  • Haystack GitHub stars - Transparent AI orchestration framework for retrieval pipelines, search systems, and modular RAG workflows.
  • Unstructured GitHub stars - Document ingestion and preprocessing toolkit for turning messy source files into cleaner RAG-ready inputs.

Vector Databases & Indexing

Core retrieval stores and indexing layers that commonly affect recall, latency, filtering, and ranking behavior.

  • Qdrant GitHub stars - Vector database focused on similarity search with filtering and production-ready APIs.
  • Milvus GitHub stars - Cloud-native vector database built for large-scale ANN search and AI retrieval workloads.
  • Weaviate GitHub stars - Vector database that combines semantic search, keyword filtering, and reranking in one query layer.
  • Chroma GitHub stars - Open-source search and retrieval engine for AI applications.
  • LanceDB GitHub stars - Embedded retrieval database for vector search and multimodal AI workloads.

Guardrails & Prompt Defense

Projects that help detect or reduce unsafe context handling, injection, and policy failures around RAG systems.

  • Guardrails GitHub stars - Framework for input and output validation in LLM applications.
  • NeMo Guardrails GitHub stars - Programmable guardrails toolkit for conversational and LLM-based systems.
  • LLM Guard GitHub stars - Security toolkit for filtering, scanning, and hardening LLM interactions.
  • garak GitHub stars - Vulnerability scanner for probing LLM failure behavior such as prompt injection and hallucination.

Related Awesome Lists

Neighbor lists that overlap with retrieval, production ML, or broader RAG infrastructure.

  • Awesome RAG GitHub stars - Retrieval-augmented generation applications and ecosystem resources.
  • Awesome RAG GitHub stars - Technical resources focused on retrieval-augmented generation for LLM systems.
  • Awesome Production Machine Learning GitHub stars - Production tooling and ecosystem references for deploying, monitoring, and scaling ML systems.

Contributing

Please read CONTRIBUTING.md before opening a pull request.

Suggested inclusion criteria:

  • The resource is directly useful for debugging, evaluating, tracing, or hardening RAG systems.
  • The repository is public, documented, and maintained.
  • The project has clear practical value beyond generic AI marketing.
  • The repository generally has 100+ GitHub stars.
  • The same project should not appear in multiple sections unless there is a very strong reason.

Suggested entry format:

About

A curated list of tools, frameworks, failure maps, observability platforms, and practical resources for debugging RAG systems.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors