Clarifai Python gRPC Client

This is the official Clarifai gRPC Python client for interacting with our powerful recognition API. Clarifai provides a platform for data scientists, developers, researchers and enterprises to master the entire artificial intelligence lifecycle. Gather valuable business insights from images, video and text using computer vision and natural language processing.

• Try the Clarifai demo at: https://clarifai.com/demo
• Sign up for a free account at: https://portal.clarifai.com/signup
• Read the documentation at: https://docs.clarifai.com/

Installation

python -m pip install clarifai-grpc

Versioning

This library doesn't use semantic versioning. The first two version numbers (X.Y out of X.Y.Z) follow the API (backend) versioning, and whenever the API gets updated, this library follows it.

The third version number (Z out of X.Y.Z) is used by this library for any independent releases of library-specific improvements and bug fixes.

Getting started

Construct the V2Stub object using which you'll access all the Clarifai API functionality:

fromclarifai_grpc.channel.clarifai_channelimportClarifaiChannelfromclarifai_grpc.grpc.apiimportservice_pb2_grpcstub=service_pb2_grpc.V2Stub(ClarifaiChannel.get_grpc_channel())

Alternatives to the encrypted gRPC channel (ClarifaiChannel.get_grpc_channel()) are:

• the HTTPS+JSON channel (ClarifaiChannel.get_json_channel()), and
• the unencrypted gRPC channel (ClarifaiChannel.get_insecure_grpc_channel()).

We only recommend them in special cases.

Predict concepts in an image:

fromclarifai_grpc.grpc.apiimportservice_pb2, resources_pb2fromclarifai_grpc.grpc.api.statusimportstatus_code_pb2YOUR_CLARIFAI_API_KEY="???"YOUR_APPLICATION_ID="???"SAMPLE_URL="https://samples.clarifai.com/metro-north.jpg"# This is how you authenticate.metadata= (("authorization", f"Key {YOUR_CLARIFAI_API_KEY}"),)
request=service_pb2.PostModelOutputsRequest(
# This is the model ID of a publicly available General model. You may use any other public or custom model ID.model_id="general-image-recognition",
user_app_id=resources_pb2.UserAppIDSet(app_id=YOUR_APPLICATION_ID),
inputs=[
resources_pb2.Input(
data=resources_pb2.Data(image=resources_pb2.Image(url=SAMPLE_URL))
)
],
)
response=stub.PostModelOutputs(request, metadata=metadata)
ifresponse.status.code!=status_code_pb2.SUCCESS:
print(response)
raiseException(f"Request failed, status code: {response.status}")
forconceptinresponse.outputs[0].data.concepts:
print("%12s: %.2f"% (concept.name, concept.value))

See the Clarifai API documentation for all available functionality.

Troubleshooting

I get the following error when installing the library: Failed building wheel for grpcio

Try upgrading setuptools to a version 40.7.1 or higher.

pip install --upgrade setuptools

Source: grpc/grpc#17829