mem0ai/mem0 · error · ImportError

Oracle AI Vector Search requires the 'oracledb' package.

Error message

Oracle AI Vector Search requires the 'oracledb' package.

What it means

Error "Oracle AI Vector Search requires the 'oracledb' package." thrown in mem0ai/mem0.

Source

Thrown at mem0/vector_stores/oracledb.py:16

# Copyright (c) 2026, Oracle and/or its affiliates.
"""Oracle AI Vector Search vector store integration for mem0."""

import array
import json
import logging
import math
import re
import uuid
from contextlib import contextmanager
from typing import Any, Dict, List, Optional

try:
    import oracledb
except ImportError as exc:  # pragma: no cover - dependency guard
    raise ImportError("Oracle AI Vector Search requires the 'oracledb' package.") from exc

from pydantic import BaseModel

from mem0.configs.vector_stores.oracledb import OracleAIVectorSearchConfig
from mem0.vector_stores.base import VectorStoreBase

logger = logging.getLogger(__name__)


class OutputData(BaseModel):
    """Standard output structure returned from vector operations."""

    id: Optional[str]
    score: Optional[float]
    payload: Optional[Dict[str, Any]]


# Allow letters, digits, underscore, dot, brackets, comma, *, space (for 'to')

View on GitHub (pinned to 001c235229)

Solutions

1. Install the dependency: pip install oracledb.

When it happens

Trigger: Thrown at mem0/vector_stores/oracledb.py:16 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of mem0ai/mem0@001c235229 (2026-08-15). Data as JSON: /api/errors/0c9397dd6221dc01. Report an issue: GitHub.