qdrant-performance-optimization

Routes Qdrant performance symptoms to tuning guidance for search speed, indexing, and memory usage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Qdrant deployments suffer from slow queries, sluggish indexing, and excessive RAM consumption, and finding the right fix requires matching a vague symptom to the correct tuning domain. This Skill acts as a navigation hub that maps user-reported symptoms to the appropriate sub-skill so the correct optimization guidance is applied instead of guesswork. ## Core Features & Use Cases - Symptom-Based Routing: Matches phrases like "filtered queries are slow" or "RAM keeps growing" to the correct sub-skill covering search speed, indexing performance, or memory usage. - Search Speed Optimization: Diagnoses latency and throughput problems, covering HNSW parameter tuning, quantization, batch search, payload indexes, and ACORN for filtered queries. - Indexing and Memory Tuning: Addresses slow bulk uploads, stuck optimizers, long HNSW builds, and high RAM usage via quantization, on-disk storage tiers, and MRL dimensionality reduction. - Use Case: A user reports that filtered vector search became slow after data growth. The hub routes to the search-speed sub-skill, which recommends creating a payload index on the filtered field and triggering re-indexing to build filterable subgraph links. ## Quick Start Ask the assistant to diagnose why your Qdrant filtered queries are much slower than unfiltered ones and recommend configuration changes.

Frequently Asked Questions about qdrant-performance-optimization

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

FAQPage Schema
How do I fix slow filtered search in Qdrant?▼

Slow filtered search in Qdrant is usually fixed by creating a payload index on the filtered field. You can also mark the primary filter with is_tenant=true, try the ACORN algorithm for complex filters, and avoid nested conditions as primary filters.

How to reduce Qdrant memory usage and RAM consumption?▼

Reduce Qdrant memory usage by enabling scalar quantization, using float16 or int8 vector datatypes, and moving rarely accessed data to disk with memory: cold settings. Matryoshka models and on-disk payload indexes also lower the resident memory footprint.

Why is my Qdrant bulk upload so slow?▼

Slow bulk uploads usually come from client-side batching or server-side indexing overhead. Use batch upserts of 64-256 points with 2-4 parallel streams, add more shards, and temporarily raise indexing_threshold_kb during initial loads.

Should I increase or decrease Qdrant segment count for better performance?▼

Segment count depends on the goal: increase default_segment_number toward CPU core count for lower latency, or decrease it to around 2 for higher throughput. Applying the wrong direction makes the reported problem worse.

When should I put the Qdrant HNSW index on disk?▼

Putting HNSW on disk suits deployments with fast local NVMe storage, multi-tenant setups where only some tenants are active, or inline storage configurations. It causes significant latency degradation for latency-sensitive production workloads.