{"id":27998,"library":"nucliadb","title":"NucliaDB","description":"NucliaDB is a semantic database for managing and querying unstructured data with AI-powered search. Version 6.13.0.post6240 supports Python >=3.10, <4.","status":"active","version":"6.13.0.post6240","language":"python","source_language":"en","source_url":"https://github.com/nuclia/nucliadb","tags":["database","ai","search","semantic","nlp"],"install":[{"cmd":"pip install nucliadb","lang":"bash","label":"Install nucliadb"}],"dependencies":[],"imports":[{"note":"Old client package was renamed in v6.","wrong":"from nucliadb_client import NucliaDBClient","symbol":"NucliaDBClient","correct":"from nucliadb import NucliaDBClient"},{"note":"Search class moved to top-level in v6.","wrong":"from nucliadb.search import NucliaDBSearch","symbol":"NucliaDBSearch","correct":"from nucliadb import NucliaDBSearch"}],"quickstart":{"code":"import os\nfrom nucliadb import NucliaDBClient\nclient = NucliaDBClient(\n    url=os.environ.get('NUCLIADB_URL', 'http://localhost:8080'),\n    api_key=os.environ.get('NUCLIADB_API_KEY', '')\n)\nresources = client.list_resources()\nprint(resources)","lang":"python","description":"Initialize client and list resources."},"warnings":[{"fix":"Upgrade to Python >=3.10.","message":"Python 3.10 minimum: versions <3.10 are not supported.","severity":"breaking","affected_versions":">=6.0"},{"fix":"Replace 'from nucliadb_client import ...' with 'from nucliadb import ...'.","message":"Old nucliadb_client package is deprecated. Use top-level nucliadb module.","severity":"deprecated","affected_versions":">=6.0"},{"fix":"Use os.environ.get('NUCLIADB_ACCESS_KEY', '') and NUCLIADB_SECRET_KEY.","message":"Access/secret keys: Provide via environment variables or config, not hardcoded.","severity":"gotcha","affected_versions":"all"},{"fix":"Use NucliaDBClient for sync, NucliaDBAsyncClient for async; await methods appropriately.","message":"Async vs sync client: Misusing blocking calls in async context.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'import nucliadb' and use 'from nucliadb import NucliaDBClient'.","cause":"Package renamed; old import path no longer exists.","error":"ModuleNotFoundError: No module named 'nucliadb_client'"},{"fix":"Use 'from nucliadb import NucliaDBSearch' instead.","cause":"Search class moved to top-level package in v6.","error":"ImportError: cannot import name 'NucliaDBSearch' from 'nucliadb.search'"},{"fix":"Check documentation for correct method name; use 'client.resources.list()' if appropriate.","cause":"Method renamed or not available in older versions.","error":"AttributeError: 'NucliaDBClient' object has no attribute 'list_resources'"},{"fix":"Ensure NUCLIADB_API_KEY environment variable is set and valid. For local development, set a dummy key.","cause":"API key not set or incorrect encoding.","error":"ValueError: Invalid API key format"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}