{"id":27992,"library":"nominal-api-protos","title":"Nominal API Protos","description":"Python protobuf/gRPC stubs for the Nominal API. Version 0.1234.0. Released on demand.","status":"active","version":"0.1234.0","language":"python","source_language":"en","source_url":"https://github.com/nominal-ai/nominal-api-protos","tags":["protobuf","grpc","nominal"],"install":[{"cmd":"pip install nominal-api-protos","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"gRPC runtime required for service stubs","package":"grpcio","optional":false},{"reason":"Protobuf runtime required for message classes","package":"protobuf","optional":false}],"imports":[{"note":"Package is `nominal_api`, not top-level","wrong":"import nominal_pb2","symbol":"nominal_pb2","correct":"from nominal_api import nominal_pb2"},{"note":"Stub classes are inside the grpc module","wrong":"from nominal_api import NominalStub","symbol":"NominalStub","correct":"from nominal_api import nominal_pb2_grpc as grpc_stubs; grpc_stubs.NominalStub"}],"quickstart":{"code":"import os\nimport grpc\nfrom nominal_api import nominal_pb2 as pb\nfrom nominal_api import nominal_pb2_grpc as grpc_stubs\n\nchannel = grpc.insecure_channel(os.environ.get('NOMINAL_API_ENDPOINT', 'localhost:50051'))\nstub = grpc_stubs.NominalStub(channel)\nresponse = stub.Ping(pb.PingRequest())\nprint(response)","lang":"python","description":"Create a gRPC channel and call Ping."},"warnings":[{"fix":"Pin exact version in requirements.txt, e.g. nominal-api-protos==0.1234.0","message":"Package versioning may not follow strict semver; minor version bumps may introduce breaking changes in proto stubs.","severity":"deprecated","affected_versions":"*"},{"fix":"Use from nominal_api import nominal_pb2","message":"Importing from nominal_api directly won't work; always use submodules like nominal_pb2 and nominal_pb2_grpc.","severity":"gotcha","affected_versions":"*"},{"fix":"Review nominal-api-protos changelog before bumping version","message":"Generated protobuf classes may change field names or types between releases; check release notes before upgrading.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use from nominal_api import nominal_pb2","cause":"Trying to import nominal_pb2 directly instead of from nominal_api","error":"ModuleNotFoundError: No module named 'nominal_pb2'"},{"fix":"Import from nominal_api import nominal_pb2_grpc; then use nominal_pb2_grpc.NominalStub","cause":"Stub classes are in the grpc submodule, not the top-level package","error":"AttributeError: module 'nominal_api' has no attribute 'NominalStub'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}