qdrant-search-speed-optimization

Diagnoses and fixes slow Qdrant vector search latency and throughput issues.

3|1|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/PALabs-v1/AI_friend --skill qdrant-search-speed-optimization-palabs-v1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qdrant-search-speed-optimization
Source: https://github.com/PALabs-v1/AI_friend/tree/main/.claude/skills/qdrant-performance-optimization/search-speed-optimization
Command: npx skills add https://github.com/PALabs-v1/AI_friend --skill qdrant-search-speed-optimization-palabs-v1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Qdrant deployments often suffer from slow search: high query latency, low QPS under load, sluggish filtered search, or degraded performance after bulk uploads. This Skill provides a structured diagnostic and remediation playbook to identify the root cause and apply the correct fix. ## Core Features & Use Cases - Latency Diagnosis: Distinguishes memory pressure, payload retrieval bottlenecks, and expensive filters, then applies fixes like HNSW tuning, in-memory quantization, Matryoshka dimensionality reduction, and io_uring. - Throughput Optimization: Raises QPS via fewer segments, batch search API, quantization, and read replicas. - Filtered Search Fixes: Resolves slow filtered queries with payload indexes, tenant indexes, ACORN algorithm, and re-indexing after HNSW builds. - Use Case: A team notices filtered search became slow after a bulk data upload. The Skill guides checking indexed_only=true to confirm the optimizer is still running, then recommends optimizer_cpu_budget tuning and prevent_unoptimized=true. ## Quick Start Ask the assistant to diagnose why my Qdrant filtered search queries suddenly became slow and recommend configuration fixes.

Frequently Asked Questions about qdrant-search-speed-optimization

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

FAQPage Schema
How do I fix slow search queries in Qdrant?

First check whether a repeated query runs faster, which indicates memory pressure, and test with `with_payload: false` to isolate payload retrieval costs. Common fixes include tuning HNSW parameters, enabling in-memory scalar quantization, and reducing vector dimensionality with Matryoshka models.

How to increase QPS throughput in Qdrant?

Reduce `default_segment_number` to 2, use the batch search API instead of single queries, enable quantization to cut CPU cost, and add replicas to distribute read load. Fewer segments improve throughput rather than more.

Why is filtered search slow in Qdrant?

Filtered search is slow when the filtered field lacks a payload index, forcing Qdrant to scan raw payloads. Create a payload index, use `is_tenant=true` for primary filters, try the ACORN algorithm for complex filters, and avoid nested conditions as primary filters.

Why did Qdrant search become slow after a bulk upload?

The optimizer is likely still indexing new segments. Test with `indexed_only=true`; if much faster, indexing is incomplete. Reduce `optimizer_cpu_budget` to reserve CPU for queries and set `prevent_unoptimized=true` to defer unindexed data.

What Qdrant configuration mistakes hurt search performance?

Avoid keeping quantized vectors out of RAM, putting HNSW on disk for latency-sensitive workloads, increasing segment count for throughput, and indexing every payload field. Also check optimizer status before blaming Qdrant itself.