{"id":27180,"library":"nominal","title":"Nominal Python Client","description":"Official Python client for the Nominal platform. Current version 1.134.0, rapid release cadence (multiple per week). Requires Python >=3.10, <4.","status":"active","version":"1.134.0","language":"python","source_language":"en","source_url":"https://github.com/nominal-io/nominal-client","tags":["nominal","api-client","automation"],"install":[{"cmd":"pip install nominal","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Serialization for Nominal types","package":"protobuf","optional":false}],"imports":[{"note":"Top-level class for API access","wrong":"import nominal.client","symbol":"NominalClient","correct":"from nominal import NominalClient"},{"note":"Direct import for submodules like nominal.core","wrong":"","symbol":"nominal","correct":"import nominal"}],"quickstart":{"code":"import os\nfrom nominal import NominalClient\n\nclient = NominalClient(\n    host=os.environ['NOMINAL_HOST'],\n    token=os.environ['NOMINAL_TOKEN']\n)\nprint(client.whoami())","lang":"python","description":"Authenticate and test connection to Nominal."},"warnings":[{"fix":"Upgrade to >=1.0.0 and use the new NominalClient class.","message":"v1.0.0 migration: The API was entirely rewritten; old code using nominal.v0alpha1 or protobuf-based clients will not work.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Set both environment variables before creating a client.","message":"Token authentication requires environment variables NOMINAL_HOST and NOMINAL_TOKEN. Missing either raises an authentication error without clear message.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Check release notes for migration guides.","message":"nominal.core.Something may be deprecated; check the documentation for the latest module structure.","severity":"deprecated","affected_versions":">=1.100.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from nominal import NominalClient' instead.","cause":"Old import path for NominalClient.","error":"ModuleNotFoundError: No module named 'nominal.client'"},{"fix":"Ensure NOMINAL_HOST and NOMINAL_TOKEN are correctly set.","cause":"Missing or invalid token.","error":"grpc.RpcError: [StatusCode.UNAUTHENTICATED] Authentication failed"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}