{"id":27186,"library":"nucliadb-utils","title":"NucliaDB Utils","description":"NucliaDB Utils is a utility library for NucliaDB, providing common functionalities such as authentication, storage abstraction, and messaging utilities. The latest version is 6.13.0.post6185, with frequent releases following NucliaDB's development cycle.","status":"active","version":"6.13.0.post6185","language":"python","source_language":"en","source_url":"https://github.com/nuclia/nucliadb","tags":["nucliadb","utilities","ai","storage","auth"],"install":[{"cmd":"pip install nucliadb-utils","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"NucliaUtility is in the utilities submodule.","wrong":"from nucliadb_utils import NucliaUtility","symbol":"NucliaUtility","correct":"from nucliadb_utils.utilities import NucliaUtility"}],"quickstart":{"code":"from nucliadb_utils.settings import Settings\n\nsettings = Settings(\n    nuclia_service_account_token=os.environ.get('NUCLIA_SERVICE_ACCOUNT_TOKEN', ''),\n    nuclia_cluster_url=os.environ.get('NUCLIA_CLUSTER_URL', 'http://localhost:8080')\n)\nprint(f\"NucliaDB URL: {settings.nuclia_cluster_url}\")","lang":"python","description":"Initialize settings with environment variables (authentication via service account token)."},"warnings":[{"fix":"Use 'nucliadb_utils' instead of 'nucliadb-utils' in Python imports.","message":"Module name changed from 'nucliadb_utils' (note underscores) to maintain consistency. Ensure imports use underscores.","severity":"breaking","affected_versions":">=6.0.0"},{"fix":"Replace with: from nucliadb_utils.utilities import NucliaUtility","message":"The utility function 'get_nuclia_utility' is deprecated since v6.10.0. Use 'NucliaUtility' class directly.","severity":"deprecated","affected_versions":">=6.10.0"},{"fix":"Set NUCLIA_SERVICE_ACCOUNT_TOKEN or pass it to Settings constructor.","message":"Settings class requires explicit environment variables. Missing NUCLIA_SERVICE_ACCOUNT_TOKEN may cause authentication errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install correctly with 'pip install nucliadb-utils' and import as 'nucliadb_utils'.","cause":"Installed package 'nucliadb-utils' but Python module uses underscores.","error":"ModuleNotFoundError: No module named 'nucliadb_utils'"},{"fix":"Use 'from nucliadb_utils.utilities import NucliaUtility'.","cause":"Direct import from top-level package instead of submodule.","error":"ImportError: cannot import name 'NucliaUtility' from 'nucliadb_utils'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}