mem0ai/mem0 · error · RuntimeError

Oracle DB client driver version {'.'.join(map(str, oracledb.

Error message

Oracle DB client driver version {'.'.join(map(str, oracledb.clientversion()))} not supported, must be >=23.4 for vector support

What it means

Error "Oracle DB client driver version {'.'.join(map(str, oracledb.clientversion()))} not supported, must be >=23.4 for vector support" thrown in mem0ai/mem0.

Source

Thrown at mem0/vector_stores/oracledb.py:252

        elif self.config.use_connection_pool:
            pool_kwargs = {
                "min": 1,
                "max": 4,
            }
            pool_kwargs.update(self.config.connection_params)

            logger.debug("Creating Oracle connection pool")
            self.client = oracledb.create_pool(**pool_kwargs)
            self._owns_client = True
        else:
            logger.debug("Creating Oracle connection")
            self.client = oracledb.connect(**self.config.connection_params)
            self._owns_client = True

        try:
            if not (hasattr(self.client, "thin") and self.client.thin):
                if oracledb.clientversion()[:2] < (23, 4):
                    raise RuntimeError(
                        f"Oracle DB client driver version {'.'.join(map(str, oracledb.clientversion()))} "
                        "not supported, must be >=23.4 for vector support"
                    )

            if isinstance(self.client, oracledb.Connection):
                db_version = tuple([int(v) for v in self.client.version.split(".")])
            else:
                with self.client.acquire() as conn:
                    db_version = tuple([int(v) for v in conn.version.split(".")])

            if db_version < (23, 4):
                raise ValueError(
                    f"Oracle DB version {'.'.join(map(str, db_version))} not supported, "
                    "must be >=23.4 for vector support"
                )

            self.create_col()
        except Exception:

View on GitHub (pinned to 001c235229)

Solutions

1. Upgrade the Oracle client driver (oracledb) to version 23.4 or newer for vector support.

When it happens

Trigger: Thrown at mem0/vector_stores/oracledb.py:252 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/4a1f6cf5a5dc7459. Report an issue: GitHub.