{"id":21771,"library":"pyobvector","title":"PyOBVector","description":"A Python SDK for OceanBase Vector Store, based on SQLAlchemy, compatible with Milvus API. Version 0.2.26. Active development.","status":"active","version":"0.2.26","language":"python","source_language":"en","source_url":"https://github.com/oceanbase/pyobvector.git","tags":["oceanbase","vector-database","vector-search","sqlalchemy","milvus"],"install":[{"cmd":"pip install pyobvector","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for database connectivity","package":"sqlalchemy","optional":false},{"reason":"Required for MySQL/OceanBase connection","package":"pymysql","optional":true},{"reason":"Required for PostgreSQL connection","package":"psycopg2-binary","optional":true}],"imports":[{"note":"Package name is pyobvector, not obvector","wrong":"from obvector import VecClient","symbol":"VecClient","correct":"from pyobvector import VecClient"},{"note":"obvector is a submodule of pyobvector","wrong":"import obvector","symbol":"obvector","correct":"import pyobvector.obvector as obvector"}],"quickstart":{"code":"from pyobvector import VecClient\nimport os\n\nclient = VecClient(\n    host=os.environ.get('OB_HOST', 'localhost'),\n    port=int(os.environ.get('OB_PORT', 2881)),\n    user=os.environ.get('OB_USER', 'root'),\n    password=os.environ.get('OB_PASSWORD', ''),\n    database=os.environ.get('OB_DATABASE', 'test')\n)\nprint(client.ping())","lang":"python","description":"Initialize VecClient with environment variables and test connection."},"warnings":[{"fix":"Use 'database' parameter instead of 'tenant'. See migration guide.","message":"Connection parameters changed between 0.1.x and 0.2.x: removed 'tenant' parameter, added 'database'.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Call client.connect() before any vector operation.","message":"VecClient.connect() must be called after initialization for vector operations.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'collection_name' parameter.","message":"The 'table_name' parameter in VecClient.insert() is deprecated; use 'collection_name' instead.","severity":"deprecated","affected_versions":">=0.2.20"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from pyobvector import obvector' or 'import pyobvector.obvector as obvector'","cause":"Trying to import obvector directly instead of pyobvector.obvector","error":"ModuleNotFoundError: No module named 'obvector'"},{"fix":"Check OB_HOST, OB_PORT, and ensure OceanBase is accessible. Use client.ping() to test.","cause":"Missing or incorrect connection parameters; OceanBase not running","error":"pyobvector.exceptions.ConnectionError: cannot connect to OceanBase"},{"fix":"Call client.connect() after VecClient initialization.","cause":"Forgot to call client.connect() before using vector operations","error":"AttributeError: 'VecClient' object has no attribute 'insert'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}