{"record":{"id":"760a9b2c877f62b5","repo":"mem0ai/mem0","slug":"the-pymilvus-library-is-required-please-install","errorCode":null,"errorMessage":"The 'pymilvus' library is required. Please install it using 'pip install pymilvus'.","messagePattern":"The 'pymilvus' library is required\\. Please install it using 'pip install pymilvus'\\.","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"mem0/vector_stores/milvus.py","lineNumber":13,"sourceCode":"import logging\nimport re\nfrom typing import Dict, Optional\n\nfrom pydantic import BaseModel\n\nfrom mem0.configs.vector_stores.milvus import MetricType\nfrom mem0.vector_stores.base import VectorStoreBase\n\ntry:\n    import pymilvus  # noqa: F401\nexcept ImportError:\n    raise ImportError(\"The 'pymilvus' library is required. Please install it using 'pip install pymilvus'.\")\n\nfrom pymilvus import (\n    CollectionSchema,\n    DataType,\n    FieldSchema,\n    Function,\n    FunctionType,\n    MilvusClient,\n)\n\nlogger = logging.getLogger(__name__)\n\n\nclass OutputData(BaseModel):\n    id: Optional[str]  # memory id\n    score: Optional[float]  # distance\n    payload: Optional[Dict]  # metadata\n","sourceCodeStart":1,"sourceCodeEnd":31,"githubUrl":"https://github.com/mem0ai/mem0/blob/001c235229be8795e3834520467bd0d661ed8f34/mem0/vector_stores/milvus.py#L1-L31","documentation":"Module-level ImportError raised when pymilvus is missing. The Milvus vector store imports pymilvus symbols (MilvusClient, CollectionSchema, ...) at module import, so configuring provider 'milvus' in an environment without pymilvus fails immediately.","triggerScenarios":"Setting provider='milvus' in vector_store config, or importing mem0.vector_stores.milvus, without pymilvus installed.","commonSituations":"Base mem0ai install without extras; CI images trimmed of optional deps; local dev against Qdrant/FAISS then deploying the same image pointed at Milvus.","solutions":["pip install pymilvus","Add pymilvus to the deployment image's dependency list","Verify with 'python -c \"import pymilvus\"' before switching the provider"],"exampleFix":"# before\n# MemoryConfig vector_store.provider='milvus' -> ImportError\n\n# after\n# shell: pip install pymilvus\nfrom mem0.vector_stores.milvus import Milvus","handlingStrategy":"fallback","validationCode":"try:\n    import pymilvus  # noqa\n    HAVE_MILVUS = True\nexcept ImportError:\n    HAVE_MILVUS = False","typeGuard":null,"tryCatchPattern":"try:\n    from mem0.vector_stores.milvus import Milvus\nexcept ImportError as e:\n    raise RuntimeError('Run: pip install pymilvus') from e","preventionTips":["Install pymilvus in every image/environment that configures provider='milvus'","Verify with python -c 'import pymilvus' during deploy preflight"],"tags":["milvus","vector-store","import-error","dependencies"],"backgroundTag":null,"analyzedSha":"001c235229be8795e3834520467bd0d661ed8f34","analyzedAt":"2026-08-15T01:55:42.685Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}