rag-perf

Benchmarks NVIDIA Blueprint servers with per-stage Rapid RAG performance analysis.

Updated May 29, 2026
One-click install
npx skills add https://github.com/rblake2320/vigil --skill rag-perf-rblake2320
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rag-perf
Source: https://github.com/rblake2320/vigil/tree/main/.claude/skills/rag-perf
Command: npx skills add https://github.com/rblake2320/vigil --skill rag-perf-rblake2320

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a repeatable, config-driven mechanism to benchmark the performance of a deployed NVIDIA RAG Blueprint server, quantifying latency, throughput, and bottlenecks to inform optimization and capacity planning.

Core Features & Use Cases

  • End-to-end profiling: captures server-side timings across retrieval, reranking, LLM inference, and overall TTFT.
  • Load testing with presets: uses aiperf and YAML configurations to simulate realistic traffic and measure throughput and error rates.
  • Bottleneck diagnosis: reports a stage-by-stage breakdown and highlights whether retrieval, reranking, or LLM time dominates.
  • Reproducibility: supports grid sweeps and saved configurations so runs are repeatable across environments.

Quick Start

Run a quick benchmark by executing uv run --project scripts/rag-perf rag-perf -c scripts/rag-perf/configs/single_run.yaml

Frequently Asked Questions about rag-perf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I benchmark NVIDIA RAG performance end-to-end?

Benchmark NVIDIA RAG performance by running configurable YAML presets against a deployed RAG server to capture latency, throughput, and stage-by-stage timings across retrieval, reranking, and LLM inference stages.

How do I measure RAG latency and identify bottlenecks in retrieval or LLM inference?

Measure RAG latency and identify bottlenecks using per-point profiling that provides a stage-by-stage breakdown of server-side timings, highlighting whether retrieval, reranking, or LLM time dominates overall performance.

Can I load test a RAG server with configurable concurrency and top-k parameters?

Load test a RAG server with configurable concurrency and top-k parameters using YAML presets and aiperf to simulate realistic traffic, measure throughput, and track error rates under controlled workloads.

What metrics are captured when profiling RAG performance?

Profiling RAG performance captures metrics including Time To First Token (TTFT), overall throughput, error rates, and detailed server-side execution timings across retrieval, reranking, and LLM inference stages.

Do I need a remote RAG server to run reproducible performance benchmarks?

Reproducible performance benchmarks can be driven against either a self-hosted or remote RAG server, using YAML configurations and grid sweeps to ensure repeatable runs across different environments.

Why does my RAG throughput drop under high concurrency?

RAG throughput drops under high concurrency are diagnosed by stage-by-stage bottleneck reporting, which isolates whether retrieval, reranking, or LLM inference time dominates and causes performance degradation.