[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EACQCFNDR7P152MSXAWGGR":3,"skill-same:01M7EACQCFNDR7P152MSXAWGGR":76},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":47,"repositoryHtmlUrl":48,"repositoryHomepageUrl":6,"ownerHtmlUrl":49,"ownerBlogUrl":6,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M7EACQCFNDR7P152MSXAWGGR","qdrant",null,"Vector search engine for production RAG systems.","sanjeevafk\u002Fagent-skills","sanjeevafk","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F230678117?v=4","01M7C540EFY46ETG1NNWKS5X3Q","Sanjeev","01M7C540F366J5C1D587BMKH9Q",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fcollections\u002Fhermes-agent\u002Fskills\u002Fqdrant\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: qdrant\ndescription: Vector search engine for production RAG systems.\nversion: 1.0.1\nauthor: Orchestra Research\nlicense: MIT\ndependencies: [qdrant-client>=1.14.0]\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [RAG, Vector Search, Qdrant, Semantic Search, Embeddings, Similarity Search, HNSW, Production, Distributed]\n\n---\n\n# Qdrant - Vector Similarity Search Engine\n\nHigh-performance vector database written in Rust for production RAG and semantic search.\n\n## When to use Qdrant\n\n**Use Qdrant when:**\n- Building production RAG systems requiring low latency\n- Need hybrid search (vectors + metadata filtering)\n- Require horizontal scaling with sharding\u002Freplication\n- Want on-premise deployment with full data control\n- Need multi-vector storage per record (dense + sparse)\n- Building real-time recommendation systems\n\n**Key features:**\n- **Rust-powered**: Memory-safe, high performance\n- **Rich filtering**: Filter by any payload field during search\n- **Multiple vectors**: Dense, sparse, multi-dense per point\n- **Quantization**: Scalar, product, binary for memory efficiency\n- **Distributed**: Raft consensus, sharding, replication\n- **REST + gRPC**: Both APIs with full feature parity\n\n**Use alternatives instead:**\n- **Chroma**: Simpler setup, embedded use cases\n- **FAISS**: Maximum raw speed, research\u002Fbatch processing\n- **Pinecone**: Fully managed, zero ops preferred\n- **Weaviate**: GraphQL preference, built-in vectorizers\n\n## Quick start\n\n### Installation\n\n```bash\n# Python client\npip install qdrant-client\n\n# Docker (recommended for development)\ndocker run -p 6333:6333 -p 6334:6334 qdrant\u002Fqdrant\n\n# Docker with persistent storage\ndocker run -p 6333:6333 -p 6334:6334 \\\n    -v $(pwd)\u002Fqdrant_storage:\u002Fqdrant\u002Fstorage \\\n    qdrant\u002Fqdrant\n```\n\n### Basic usage\n\n```python\nfrom qdrant_client import QdrantClient\nfrom qdrant_client.models import Distance, VectorParams, PointStruct\n\n# Connect to Qdrant\nclient = QdrantClient(host=\"localhost\", port=6333)\n\n# Create collection\nclient.create_collection(\n    collection_name=\"documents\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE)\n)\n\n# Insert vectors with payload\nclient.upsert(\n    collection_name=\"documents\",\n    points=[\n        PointStruct(\n            id=1,\n            vector=[0.1, 0.2, ...],  # 384-dim vector\n            payload={\"title\": \"Doc 1\", \"category\": \"tech\"}\n        ),\n        PointStruct(\n            id=2,\n            vector=[0.3, 0.4, ...],\n            payload={\"title\": \"Doc 2\", \"category\": \"science\"}\n        )\n    ]\n)\n\n# Search with filtering (query_points is the current API; client.search is removed in qdrant-client 1.14+)\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=[0.15, 0.25, ...],\n    query_filter={\n        \"must\": [{\"key\": \"category\", \"match\": {\"value\": \"tech\"}}]\n    },\n    limit=10\n)\n\nfor point in response.points:\n    print(f\"ID: {point.id}, Score: {point.score}, Payload: {point.payload}\")\n```\n\n## Core concepts\n\n### Points - Basic data unit\n\n```python\nfrom qdrant_client.models import PointStruct\n\n# Point = ID + Vector(s) + Payload\npoint = PointStruct(\n    id=123,                              # Integer or UUID string\n    vector=[0.1, 0.2, 0.3, ...],        # Dense vector\n    payload={                            # Arbitrary JSON metadata\n        \"title\": \"Document title\",\n        \"category\": \"tech\",\n        \"timestamp\": 1699900000,\n        \"tags\": [\"python\", \"ml\"]\n    }\n)\n\n# Batch upsert (recommended)\nclient.upsert(\n    collection_name=\"documents\",\n    points=[point1, point2, point3],\n    wait=True  # Wait for indexing\n)\n```\n\n### Collections - Vector containers\n\n```python\nfrom qdrant_client.models import VectorParams, Distance, HnswConfigDiff\n\n# Create with HNSW configuration\nclient.create_collection(\n    collection_name=\"documents\",\n    vectors_config=VectorParams(\n        size=384,                        # Vector dimensions\n        distance=Distance.COSINE         # COSINE, EUCLID, DOT, MANHATTAN\n    ),\n    hnsw_config=HnswConfigDiff(\n        m=16,                            # Connections per node (default 16)\n        ef_construct=100,                # Build-time accuracy (default 100)\n        full_scan_threshold=10000        # Switch to brute force below this\n    ),\n    on_disk_payload=True                 # Store payload on disk\n)\n\n# Collection info\ninfo = client.get_collection(\"documents\")\nprint(f\"Points: {info.points_count}, Vectors: {info.vectors_count}\")\n```\n\n### Distance metrics\n\n| Metric | Use Case | Range |\n|--------|----------|-------|\n| `COSINE` | Text embeddings, normalized vectors | 0 to 2 |\n| `EUCLID` | Spatial data, image features | 0 to ∞ |\n| `DOT` | Recommendations, unnormalized | -∞ to ∞ |\n| `MANHATTAN` | Sparse features, discrete data | 0 to ∞ |\n\n## Search operations\n\n### Basic search\n\n```python\n# Simple nearest neighbor search (returns a QueryResponse; use .points)\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=[0.1, 0.2, ...],\n    limit=10,\n    with_payload=True,\n    with_vectors=False  # Don't return vectors (faster)\n)\nresults = response.points\n```\n\n### Filtered search\n\n```python\nfrom qdrant_client.models import Filter, FieldCondition, MatchValue, Range\n\n# Complex filtering\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=query_embedding,\n    query_filter=Filter(\n        must=[\n            FieldCondition(key=\"category\", match=MatchValue(value=\"tech\")),\n            FieldCondition(key=\"timestamp\", range=Range(gte=1699000000))\n        ],\n        must_not=[\n            FieldCondition(key=\"status\", match=MatchValue(value=\"archived\"))\n        ]\n    ),\n    limit=10\n).points\n\n# Shorthand filter syntax\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=query_embedding,\n    query_filter={\n        \"must\": [\n            {\"key\": \"category\", \"match\": {\"value\": \"tech\"}},\n            {\"key\": \"price\", \"range\": {\"gte\": 10, \"lte\": 100}}\n        ]\n    },\n    limit=10\n).points\n```\n\n### Batch search\n\n```python\nfrom qdrant_client.models import QueryRequest\n\n# Multiple queries in one request (search_batch is replaced by query_batch_points)\nresponses = client.query_batch_points(\n    collection_name=\"documents\",\n    requests=[\n        QueryRequest(query=[0.1, ...], limit=5),\n        QueryRequest(query=[0.2, ...], limit=5, filter={\"must\": [...]}),\n        QueryRequest(query=[0.3, ...], limit=10)\n    ]\n)\n# Each element is a QueryResponse; use .points\nfor resp in responses:\n    for point in resp.points:\n        print(point.id, point.score)\n```\n\n## RAG integration\n\n### With sentence-transformers\n\n```python\nfrom sentence_transformers import SentenceTransformer\nfrom qdrant_client import QdrantClient\nfrom qdrant_client.models import VectorParams, Distance, PointStruct\n\n# Initialize\nencoder = SentenceTransformer(\"all-MiniLM-L6-v2\")\nclient = QdrantClient(host=\"localhost\", port=6333)\n\n# Create collection\nclient.create_collection(\n    collection_name=\"knowledge_base\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE)\n)\n\n# Index documents\ndocuments = [\n    {\"id\": 1, \"text\": \"Python is a programming language\", \"source\": \"wiki\"},\n    {\"id\": 2, \"text\": \"Machine learning uses algorithms\", \"source\": \"textbook\"},\n]\n\npoints = [\n    PointStruct(\n        id=doc[\"id\"],\n        vector=encoder.encode(doc[\"text\"]).tolist(),\n        payload={\"text\": doc[\"text\"], \"source\": doc[\"source\"]}\n    )\n    for doc in documents\n]\nclient.upsert(collection_name=\"knowledge_base\", points=points)\n\n# RAG retrieval\ndef retrieve(query: str, top_k: int = 5) -> list[dict]:\n    query_vector = encoder.encode(query).tolist()\n    response = client.query_points(\n        collection_name=\"knowledge_base\",\n        query=query_vector,\n        limit=top_k\n    )\n    return [{\"text\": r.payload[\"text\"], \"score\": r.score} for r in response.points]\n\n# Use in RAG pipeline\ncontext = retrieve(\"What is Python?\")\nprompt = f\"Context: {context}\\n\\nQuestion: What is Python?\"\n```\n\n### With LangChain\n\n```python\nfrom langchain_community.vectorstores import Qdrant\nfrom langchain_community.embeddings import HuggingFaceEmbeddings\n\nembeddings = HuggingFaceEmbeddings(model_name=\"all-MiniLM-L6-v2\")\nvectorstore = Qdrant.from_documents(documents, embeddings, url=\"http:\u002F\u002Flocalhost:6333\", collection_name=\"docs\")\nretriever = vectorstore.as_retriever(search_kwargs={\"k\": 5})\n```\n\n### With LlamaIndex\n\n```python\nfrom llama_index.vector_stores.qdrant import QdrantVectorStore\nfrom llama_index.core import VectorStoreIndex, StorageContext\n\nvector_store = QdrantVectorStore(client=client, collection_name=\"llama_docs\")\nstorage_context = StorageContext.from_defaults(vector_store=vector_store)\nindex = VectorStoreIndex.from_documents(documents, storage_context=storage_context)\nquery_engine = index.as_query_engine()\n```\n\n## Multi-vector support\n\n### Named vectors (different embedding models)\n\n```python\nfrom qdrant_client.models import VectorParams, Distance\n\n# Collection with multiple vector types\nclient.create_collection(\n    collection_name=\"hybrid_search\",\n    vectors_config={\n        \"dense\": VectorParams(size=384, distance=Distance.COSINE),\n        \"sparse\": VectorParams(size=30000, distance=Distance.DOT)\n    }\n)\n\n# Insert with named vectors\nclient.upsert(\n    collection_name=\"hybrid_search\",\n    points=[\n        PointStruct(\n            id=1,\n            vector={\n                \"dense\": dense_embedding,\n                \"sparse\": sparse_embedding\n            },\n            payload={\"text\": \"document text\"}\n        )\n    ]\n)\n\n# Search specific named vector (pass the vector name via `using`)\nresponse = client.query_points(\n    collection_name=\"hybrid_search\",\n    query=query_dense,\n    using=\"dense\",  # Specify which named vector to search\n    limit=10\n)\nresults = response.points\n```\n\n### Sparse vectors (BM25, SPLADE)\n\n```python\nfrom qdrant_client.models import SparseVectorParams, SparseIndexParams, SparseVector\n\n# Collection with sparse vectors\nclient.create_collection(\n    collection_name=\"sparse_search\",\n    vectors_config={},\n    sparse_vectors_config={\"text\": SparseVectorParams(index=SparseIndexParams(on_disk=False))}\n)\n\n# Insert sparse vector\nclient.upsert(\n    collection_name=\"sparse_search\",\n    points=[PointStruct(id=1, vector={\"text\": SparseVector(indices=[1, 5, 100], values=[0.5, 0.8, 0.2])}, payload={\"text\": \"document\"})]\n)\n```\n\n## Quantization (memory optimization)\n\n```python\nfrom qdrant_client.models import ScalarQuantization, ScalarQuantizationConfig, ScalarType\n\n# Scalar quantization (4x memory reduction)\nclient.create_collection(\n    collection_name=\"quantized\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE),\n    quantization_config=ScalarQuantization(\n        scalar=ScalarQuantizationConfig(\n            type=ScalarType.INT8,\n            quantile=0.99,        # Clip outliers\n            always_ram=True      # Keep quantized in RAM\n        )\n    )\n)\n\n# Search with rescoring\nresponse = client.query_points(\n    collection_name=\"quantized\",\n    query=query,\n    search_params={\"quantization\": {\"rescore\": True}},  # Rescore top results\n    limit=10\n)\nresults = response.points\n```\n\n## Payload indexing\n\n```python\nfrom qdrant_client.models import PayloadSchemaType\n\n# Create payload index for faster filtering\nclient.create_payload_index(\n    collection_name=\"documents\",\n    field_name=\"category\",\n    field_schema=PayloadSchemaType.KEYWORD\n)\n\nclient.create_payload_index(\n    collection_name=\"documents\",\n    field_name=\"timestamp\",\n    field_schema=PayloadSchemaType.INTEGER\n)\n\n# Index types: KEYWORD, INTEGER, FLOAT, GEO, TEXT (full-text), BOOL\n```\n\n## Production deployment\n\n### Qdrant Cloud\n\n```python\nfrom qdrant_client import QdrantClient\n\n# Connect to Qdrant Cloud\nclient = QdrantClient(\n    url=\"https:\u002F\u002Fyour-cluster.cloud.qdrant.io\",\n    api_key=\"your-api-key\"\n)\n```\n\n### Performance tuning\n\n```python\n# Optimize for search speed (higher recall)\nclient.update_collection(\n    collection_name=\"documents\",\n    hnsw_config=HnswConfigDiff(ef_construct=200, m=32)\n)\n\n# Optimize for indexing speed (bulk loads)\nclient.update_collection(\n    collection_name=\"documents\",\n    optimizer_config={\"indexing_threshold\": 20000}\n)\n```\n\n## Best practices\n\n1. **Batch operations** - Use batch upsert\u002Fsearch for efficiency\n2. **Payload indexing** - Index fields used in filters\n3. **Quantization** - Enable for large collections (>1M vectors)\n4. **Sharding** - Use for collections >10M vectors\n5. **On-disk storage** - Enable `on_disk_payload` for large payloads\n6. **Connection pooling** - Reuse client instances\n\n## Common issues\n\n**Slow search with filters:**\n```python\n# Create payload index for filtered fields\nclient.create_payload_index(\n    collection_name=\"docs\",\n    field_name=\"category\",\n    field_schema=PayloadSchemaType.KEYWORD\n)\n```\n\n**Out of memory:**\n```python\n# Enable quantization and on-disk storage\nclient.create_collection(\n    collection_name=\"large_collection\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE),\n    quantization_config=ScalarQuantization(...),\n    on_disk_payload=True\n)\n```\n\n**Connection issues:**\n```python\n# Use timeout and retry\nclient = QdrantClient(\n    host=\"localhost\",\n    port=6333,\n    timeout=30,\n    prefer_grpc=True  # gRPC for better performance\n)\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Distributed mode, hybrid search, recommendations\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance tuning\n\n## Resources\n\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant (22k+ stars)\n- **Docs**: https:\u002F\u002Fqdrant.tech\u002Fdocumentation\u002F\n- **Python Client**: https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant-client\n- **Cloud**: https:\u002F\u002Fcloud.qdrant.io\n- **Version**: 1.14.0+\n- **License**: Apache 2.0\n","# Qdrant - Vector Similarity Search Engine\n\nHigh-performance vector database written in Rust for production RAG and semantic search.\n\n## When to use Qdrant\n\n**Use Qdrant when:**\n- Building production RAG systems requiring low latency\n- Need hybrid search (vectors + metadata filtering)\n- Require horizontal scaling with sharding\u002Freplication\n- Want on-premise deployment with full data control\n- Need multi-vector storage per record (dense + sparse)\n- Building real-time recommendation systems\n\n**Key features:**\n- **Rust-powered**: Memory-safe, high performance\n- **Rich filtering**: Filter by any payload field during search\n- **Multiple vectors**: Dense, sparse, multi-dense per point\n- **Quantization**: Scalar, product, binary for memory efficiency\n- **Distributed**: Raft consensus, sharding, replication\n- **REST + gRPC**: Both APIs with full feature parity\n\n**Use alternatives instead:**\n- **Chroma**: Simpler setup, embedded use cases\n- **FAISS**: Maximum raw speed, research\u002Fbatch processing\n- **Pinecone**: Fully managed, zero ops preferred\n- **Weaviate**: GraphQL preference, built-in vectorizers\n\n## Quick start\n\n### Installation\n\n```bash\n# Python client\npip install qdrant-client\n\n# Docker (recommended for development)\ndocker run -p 6333:6333 -p 6334:6334 qdrant\u002Fqdrant\n\n# Docker with persistent storage\ndocker run -p 6333:6333 -p 6334:6334 \\\n    -v $(pwd)\u002Fqdrant_storage:\u002Fqdrant\u002Fstorage \\\n    qdrant\u002Fqdrant\n```\n\n### Basic usage\n\n```python\nfrom qdrant_client import QdrantClient\nfrom qdrant_client.models import Distance, VectorParams, PointStruct\n\n# Connect to Qdrant\nclient = QdrantClient(host=\"localhost\", port=6333)\n\n# Create collection\nclient.create_collection(\n    collection_name=\"documents\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE)\n)\n\n# Insert vectors with payload\nclient.upsert(\n    collection_name=\"documents\",\n    points=[\n        PointStruct(\n            id=1,\n            vector=[0.1, 0.2, ...],  # 384-dim vector\n            payload={\"title\": \"Doc 1\", \"category\": \"tech\"}\n        ),\n        PointStruct(\n            id=2,\n            vector=[0.3, 0.4, ...],\n            payload={\"title\": \"Doc 2\", \"category\": \"science\"}\n        )\n    ]\n)\n\n# Search with filtering (query_points is the current API; client.search is removed in qdrant-client 1.14+)\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=[0.15, 0.25, ...],\n    query_filter={\n        \"must\": [{\"key\": \"category\", \"match\": {\"value\": \"tech\"}}]\n    },\n    limit=10\n)\n\nfor point in response.points:\n    print(f\"ID: {point.id}, Score: {point.score}, Payload: {point.payload}\")\n```\n\n## Core concepts\n\n### Points - Basic data unit\n\n```python\nfrom qdrant_client.models import PointStruct\n\n# Point = ID + Vector(s) + Payload\npoint = PointStruct(\n    id=123,                              # Integer or UUID string\n    vector=[0.1, 0.2, 0.3, ...],        # Dense vector\n    payload={                            # Arbitrary JSON metadata\n        \"title\": \"Document title\",\n        \"category\": \"tech\",\n        \"timestamp\": 1699900000,\n        \"tags\": [\"python\", \"ml\"]\n    }\n)\n\n# Batch upsert (recommended)\nclient.upsert(\n    collection_name=\"documents\",\n    points=[point1, point2, point3],\n    wait=True  # Wait for indexing\n)\n```\n\n### Collections - Vector containers\n\n```python\nfrom qdrant_client.models import VectorParams, Distance, HnswConfigDiff\n\n# Create with HNSW configuration\nclient.create_collection(\n    collection_name=\"documents\",\n    vectors_config=VectorParams(\n        size=384,                        # Vector dimensions\n        distance=Distance.COSINE         # COSINE, EUCLID, DOT, MANHATTAN\n    ),\n    hnsw_config=HnswConfigDiff(\n        m=16,                            # Connections per node (default 16)\n        ef_construct=100,                # Build-time accuracy (default 100)\n        full_scan_threshold=10000        # Switch to brute force below this\n    ),\n    on_disk_payload=True                 # Store payload on disk\n)\n\n# Collection info\ninfo = client.get_collection(\"documents\")\nprint(f\"Points: {info.points_count}, Vectors: {info.vectors_count}\")\n```\n\n### Distance metrics\n\n| Metric | Use Case | Range |\n|--------|----------|-------|\n| `COSINE` | Text embeddings, normalized vectors | 0 to 2 |\n| `EUCLID` | Spatial data, image features | 0 to ∞ |\n| `DOT` | Recommendations, unnormalized | -∞ to ∞ |\n| `MANHATTAN` | Sparse features, discrete data | 0 to ∞ |\n\n## Search operations\n\n### Basic search\n\n```python\n# Simple nearest neighbor search (returns a QueryResponse; use .points)\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=[0.1, 0.2, ...],\n    limit=10,\n    with_payload=True,\n    with_vectors=False  # Don't return vectors (faster)\n)\nresults = response.points\n```\n\n### Filtered search\n\n```python\nfrom qdrant_client.models import Filter, FieldCondition, MatchValue, Range\n\n# Complex filtering\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=query_embedding,\n    query_filter=Filter(\n        must=[\n            FieldCondition(key=\"category\", match=MatchValue(value=\"tech\")),\n            FieldCondition(key=\"timestamp\", range=Range(gte=1699000000))\n        ],\n        must_not=[\n            FieldCondition(key=\"status\", match=MatchValue(value=\"archived\"))\n        ]\n    ),\n    limit=10\n).points\n\n# Shorthand filter syntax\nresponse = client.query_points(\n    collection_name=\"documents\",\n    query=query_embedding,\n    query_filter={\n        \"must\": [\n            {\"key\": \"category\", \"match\": {\"value\": \"tech\"}},\n            {\"key\": \"price\", \"range\": {\"gte\": 10, \"lte\": 100}}\n        ]\n    },\n    limit=10\n).points\n```\n\n### Batch search\n\n```python\nfrom qdrant_client.models import QueryRequest\n\n# Multiple queries in one request (search_batch is replaced by query_batch_points)\nresponses = client.query_batch_points(\n    collection_name=\"documents\",\n    requests=[\n        QueryRequest(query=[0.1, ...], limit=5),\n        QueryRequest(query=[0.2, ...], limit=5, filter={\"must\": [...]}),\n        QueryRequest(query=[0.3, ...], limit=10)\n    ]\n)\n# Each element is a QueryResponse; use .points\nfor resp in responses:\n    for point in resp.points:\n        print(point.id, point.score)\n```\n\n## RAG integration\n\n### With sentence-transformers\n\n```python\nfrom sentence_transformers import SentenceTransformer\nfrom qdrant_client import QdrantClient\nfrom qdrant_client.models import VectorParams, Distance, PointStruct\n\n# Initialize\nencoder = SentenceTransformer(\"all-MiniLM-L6-v2\")\nclient = QdrantClient(host=\"localhost\", port=6333)\n\n# Create collection\nclient.create_collection(\n    collection_name=\"knowledge_base\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE)\n)\n\n# Index documents\ndocuments = [\n    {\"id\": 1, \"text\": \"Python is a programming language\", \"source\": \"wiki\"},\n    {\"id\": 2, \"text\": \"Machine learning uses algorithms\", \"source\": \"textbook\"},\n]\n\npoints = [\n    PointStruct(\n        id=doc[\"id\"],\n        vector=encoder.encode(doc[\"text\"]).tolist(),\n        payload={\"text\": doc[\"text\"], \"source\": doc[\"source\"]}\n    )\n    for doc in documents\n]\nclient.upsert(collection_name=\"knowledge_base\", points=points)\n\n# RAG retrieval\ndef retrieve(query: str, top_k: int = 5) -> list[dict]:\n    query_vector = encoder.encode(query).tolist()\n    response = client.query_points(\n        collection_name=\"knowledge_base\",\n        query=query_vector,\n        limit=top_k\n    )\n    return [{\"text\": r.payload[\"text\"], \"score\": r.score} for r in response.points]\n\n# Use in RAG pipeline\ncontext = retrieve(\"What is Python?\")\nprompt = f\"Context: {context}\\n\\nQuestion: What is Python?\"\n```\n\n### With LangChain\n\n```python\nfrom langchain_community.vectorstores import Qdrant\nfrom langchain_community.embeddings import HuggingFaceEmbeddings\n\nembeddings = HuggingFaceEmbeddings(model_name=\"all-MiniLM-L6-v2\")\nvectorstore = Qdrant.from_documents(documents, embeddings, url=\"http:\u002F\u002Flocalhost:6333\", collection_name=\"docs\")\nretriever = vectorstore.as_retriever(search_kwargs={\"k\": 5})\n```\n\n### With LlamaIndex\n\n```python\nfrom llama_index.vector_stores.qdrant import QdrantVectorStore\nfrom llama_index.core import VectorStoreIndex, StorageContext\n\nvector_store = QdrantVectorStore(client=client, collection_name=\"llama_docs\")\nstorage_context = StorageContext.from_defaults(vector_store=vector_store)\nindex = VectorStoreIndex.from_documents(documents, storage_context=storage_context)\nquery_engine = index.as_query_engine()\n```\n\n## Multi-vector support\n\n### Named vectors (different embedding models)\n\n```python\nfrom qdrant_client.models import VectorParams, Distance\n\n# Collection with multiple vector types\nclient.create_collection(\n    collection_name=\"hybrid_search\",\n    vectors_config={\n        \"dense\": VectorParams(size=384, distance=Distance.COSINE),\n        \"sparse\": VectorParams(size=30000, distance=Distance.DOT)\n    }\n)\n\n# Insert with named vectors\nclient.upsert(\n    collection_name=\"hybrid_search\",\n    points=[\n        PointStruct(\n            id=1,\n            vector={\n                \"dense\": dense_embedding,\n                \"sparse\": sparse_embedding\n            },\n            payload={\"text\": \"document text\"}\n        )\n    ]\n)\n\n# Search specific named vector (pass the vector name via `using`)\nresponse = client.query_points(\n    collection_name=\"hybrid_search\",\n    query=query_dense,\n    using=\"dense\",  # Specify which named vector to search\n    limit=10\n)\nresults = response.points\n```\n\n### Sparse vectors (BM25, SPLADE)\n\n```python\nfrom qdrant_client.models import SparseVectorParams, SparseIndexParams, SparseVector\n\n# Collection with sparse vectors\nclient.create_collection(\n    collection_name=\"sparse_search\",\n    vectors_config={},\n    sparse_vectors_config={\"text\": SparseVectorParams(index=SparseIndexParams(on_disk=False))}\n)\n\n# Insert sparse vector\nclient.upsert(\n    collection_name=\"sparse_search\",\n    points=[PointStruct(id=1, vector={\"text\": SparseVector(indices=[1, 5, 100], values=[0.5, 0.8, 0.2])}, payload={\"text\": \"document\"})]\n)\n```\n\n## Quantization (memory optimization)\n\n```python\nfrom qdrant_client.models import ScalarQuantization, ScalarQuantizationConfig, ScalarType\n\n# Scalar quantization (4x memory reduction)\nclient.create_collection(\n    collection_name=\"quantized\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE),\n    quantization_config=ScalarQuantization(\n        scalar=ScalarQuantizationConfig(\n            type=ScalarType.INT8,\n            quantile=0.99,        # Clip outliers\n            always_ram=True      # Keep quantized in RAM\n        )\n    )\n)\n\n# Search with rescoring\nresponse = client.query_points(\n    collection_name=\"quantized\",\n    query=query,\n    search_params={\"quantization\": {\"rescore\": True}},  # Rescore top results\n    limit=10\n)\nresults = response.points\n```\n\n## Payload indexing\n\n```python\nfrom qdrant_client.models import PayloadSchemaType\n\n# Create payload index for faster filtering\nclient.create_payload_index(\n    collection_name=\"documents\",\n    field_name=\"category\",\n    field_schema=PayloadSchemaType.KEYWORD\n)\n\nclient.create_payload_index(\n    collection_name=\"documents\",\n    field_name=\"timestamp\",\n    field_schema=PayloadSchemaType.INTEGER\n)\n\n# Index types: KEYWORD, INTEGER, FLOAT, GEO, TEXT (full-text), BOOL\n```\n\n## Production deployment\n\n### Qdrant Cloud\n\n```python\nfrom qdrant_client import QdrantClient\n\n# Connect to Qdrant Cloud\nclient = QdrantClient(\n    url=\"https:\u002F\u002Fyour-cluster.cloud.qdrant.io\",\n    api_key=\"your-api-key\"\n)\n```\n\n### Performance tuning\n\n```python\n# Optimize for search speed (higher recall)\nclient.update_collection(\n    collection_name=\"documents\",\n    hnsw_config=HnswConfigDiff(ef_construct=200, m=32)\n)\n\n# Optimize for indexing speed (bulk loads)\nclient.update_collection(\n    collection_name=\"documents\",\n    optimizer_config={\"indexing_threshold\": 20000}\n)\n```\n\n## Best practices\n\n1. **Batch operations** - Use batch upsert\u002Fsearch for efficiency\n2. **Payload indexing** - Index fields used in filters\n3. **Quantization** - Enable for large collections (>1M vectors)\n4. **Sharding** - Use for collections >10M vectors\n5. **On-disk storage** - Enable `on_disk_payload` for large payloads\n6. **Connection pooling** - Reuse client instances\n\n## Common issues\n\n**Slow search with filters:**\n```python\n# Create payload index for filtered fields\nclient.create_payload_index(\n    collection_name=\"docs\",\n    field_name=\"category\",\n    field_schema=PayloadSchemaType.KEYWORD\n)\n```\n\n**Out of memory:**\n```python\n# Enable quantization and on-disk storage\nclient.create_collection(\n    collection_name=\"large_collection\",\n    vectors_config=VectorParams(size=384, distance=Distance.COSINE),\n    quantization_config=ScalarQuantization(...),\n    on_disk_payload=True\n)\n```\n\n**Connection issues:**\n```python\n# Use timeout and retry\nclient = QdrantClient(\n    host=\"localhost\",\n    port=6333,\n    timeout=30,\n    prefer_grpc=True  # gRPC for better performance\n)\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Distributed mode, hybrid search, recommendations\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance tuning\n\n## Resources\n\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant (22k+ stars)\n- **Docs**: https:\u002F\u002Fqdrant.tech\u002Fdocumentation\u002F\n- **Python Client**: https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqdrant-client\n- **Cloud**: https:\u002F\u002Fcloud.qdrant.io\n- **Version**: 1.14.0+\n- **License**: Apache 2.0\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":38,"description":7,"dependencies":42},"Orchestra Research","1.0.1",{"hermes":27},{"tags":28},[29,30,31,32,33,34,35,36,37],"RAG","Vector Search","Qdrant","Semantic Search","Embeddings","Similarity Search","HNSW","Production","Distributed",[39,40,41],"linux","macos","windows",[43],"qdrant-client>=1.14.0","main","4e084e84eb42fc53e144c89c0f7f48b39c8a4b0f","collections\u002Fhermes-agent\u002Fskills\u002Fqdrant",1,"https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills","https:\u002F\u002Fgithub.com\u002Fsanjeevafk","First make it work. Then make it right. Then make it fast.","2026-11-14 13:36:16",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add sanjeevafk\u002Fagent-skills --skill qdrant",{"tool":58,"command":59},"bunx","bunx skills add sanjeevafk\u002Fagent-skills --skill qdrant",{"tool":61,"command":62},"pnpm","pnpm dlx skills add sanjeevafk\u002Fagent-skills --skill qdrant","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fcollections\u002Fhermes-agent\u002Fskills\u002Fqdrant\u002FSKILL.md",true,[66,72],{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",14969,"https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fcollections\u002Fhermes-agent\u002Fskills\u002Fqdrant\u002Freferences\u002Fadvanced-usage.md",{"path":73,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Ftroubleshooting.md",12682,"https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fcollections\u002Fhermes-agent\u002Fskills\u002Fqdrant\u002Freferences\u002Ftroubleshooting.md",[77,84,92,101,109,116],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7EFHX67M3KKXT1BXVPA5ADT","zarr-python","Chunked N-D arrays for cloud storage (Zarr-Python 3). Compressed arrays, parallel I\u002FO, S3\u002FGCS via fsspec, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzarr-python\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7EFFQGM51TZBGRENXY50ZYM","whiteboard-diagrams","Create accurate, simple, hand-drawn whiteboard diagrams from a user's process, system, architecture, learning workflow, comparison, or causal explanation. Use when the user asks for a scribbly whiteboard visual, educational workflow graphic, hand-drawn explainer, or diagram like the bundled reference; ask one focused clarification question when the subject or relationships are missing, then generate and visually verify the final image.","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwhiteboard-diagrams\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwhiteboard-diagrams\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":96,"licenseFileUrl":97,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7EFF1CSQNTDMHFK4ZGY6NYK","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":96,"licenseFileUrl":105,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7EFE8106X6C28FT8PA74427","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fweb-artifacts-builder\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7EFCSNZM9G7ZHS6F127Q71X","verification-loop","A comprehensive verification system for Claude Code sessions.","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":120,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M7EFCE7EZMKPRYDDNKBQ9EEH","vercel-deploy","Deploy applications and websites to Vercel. Use when the user requests deployment actions like \"deploy my app\", \"deploy and give me the link\", \"push this live\", or \"create a preview deployment\".","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-deploy\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fsanjeevafk\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-deploy\u002FSKILL.md",[],[]]