[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BFZXSD4PZ2Y63NW5KJ72R0":3,"skill-same:01M7BFZXSD4PZ2Y63NW5KJ72R0":75},{"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":6,"updatedAt":50,"install":51,"resources":64},"01M7BFZXSD4PZ2Y63NW5KJ72R0","qdrant",null,"Vector search engine for production RAG systems.","LIJALEN23\u002FBeryl","LIJALEN23","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F141412346?v=4","01M7AQK5G18E0M3NKP1S35F4KE","oneplusnine","01M7AQK5GNQE3MMPFJ9TCCJQCN",1,"MIT","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Foptional-skills\u002Fmlops\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","master","4a5caebee4b5f9068d3a68c9a7ecd8df12bd4962","local-agent\u002Foptional-skills\u002Fmlops\u002Fqdrant",0,"https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl","https:\u002F\u002Fgithub.com\u002FLIJALEN23","2026-09-01 14:02:08",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add LIJALEN23\u002FBeryl --skill qdrant",{"tool":57,"command":58},"bunx","bunx skills add LIJALEN23\u002FBeryl --skill qdrant",{"tool":60,"command":61},"pnpm","pnpm dlx skills add LIJALEN23\u002FBeryl --skill qdrant","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Foptional-skills\u002Fmlops\u002Fqdrant\u002FSKILL.md",true,[65,71],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",14969,"https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Foptional-skills\u002Fmlops\u002Fqdrant\u002Freferences\u002Fadvanced-usage.md",{"path":72,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Ftroubleshooting.md",12682,"https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Foptional-skills\u002Fmlops\u002Fqdrant\u002Freferences\u002Ftroubleshooting.md",[76,83,90,97,104,111],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7BGCRH58RARQTF3R8CZ84DB","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7BGCK0GGNV3K6NWMM0MDN3W","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7BGCF0TAZPKSM4WMYA27XGD","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M7BGCBH01YYYBQWR7ZFRMX27","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M7BGC8MGHS5SRJ3NZYYNAKJY","requesting-code-review","Pre-commit review: security scan, quality gates, auto-fix.","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Frequesting-code-review\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M7BGC4HB5ZJP5N19MZTZXKZ1","python-debugpy","Debug Python: pdb REPL + debugpy remote (DAP).","https:\u002F\u002Fgithub.com\u002FLIJALEN23\u002FBeryl\u002Fblob\u002Fmaster\u002Flocal-agent\u002Fskills\u002Fsoftware-development\u002Fpython-debugpy\u002FSKILL.md",[],[]]