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.