Metadata-Version: 2.1
Name: clarifai-grpc
Version: 6.8.0
Summary: Clarifai gRPC API Client
Home-page: https://github.com/Clarifai/clarifai-python-grpc
Author: Clarifai
Author-email: support@clarifai.com
License: Apache 2.0
Description: ![Clarifai logo](docs/logo.png)
        
        # Clarifai Python gRPC Client
        
        This is the official Clarifai gRPC Python client for interacting with our powerful recognition
        [API](https://docs.clarifai.com).
        The Clarifai API offers image and video recognition as a service. Whether you have one image or
        billions, you are only steps away from using artificial intelligence to recognize your visual
        content.
        
        * 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/
        
        
        [![Build](https://github.com/Clarifai/clarifai-python-grpc/workflows/Run%20tests/badge.svg)](https://github.com/Clarifai/clarifai-python-grpc/actions)
        [![PyPI version](https://pypip.in/v/clarifai-grpc/badge.png)](https://pypi.python.org/pypi/clarifai-grpc)
        
        ## Installation
        
        ```cmd
        pip install clarifai-grpc
        ```
        
        ## Getting started
        
        Alternatively to using the gRPC channel, it is also possible to use the HTTP+JSON channel with the
        exact same request / response handling code.
        
        Construct the channel you want to use:
        
        ```python
        from clarifai_grpc.channel.clarifai_channel import ClarifaiChannel
        
        # Construct one of the channels you want to use
        channel = ClarifaiChannel.get_json_channel()
        channel = ClarifaiChannel.get_insecure_grpc_channel()
        
        # Note: You can also use a secure (encrypted) ClarifaiChannel.get_grpc_channel() however
        # it is currently not possible to use it with the latest gRPC version.
        ```
        
        Predict concepts in an image:
        
        ```python
        from clarifai_grpc.grpc.api import service_pb2_grpc, service_pb2, resources_pb2
        from clarifai_grpc.grpc.api.status import status_code_pb2
        
        stub = service_pb2_grpc.V2Stub(channel)
        
        request = service_pb2.PostModelOutputsRequest(
            model_id='aaa03c23b3724a16a56b629203edc62c',
            inputs=[
              resources_pb2.Input(data=resources_pb2.Data(image=resources_pb2.Image(url='YOUR_IMAGE_URL')))
            ])
        metadata = (('authorization', 'Key YOUR_CLARIFAI_API_KEY'),)
        
        response = stub.PostModelOutputs(request, metadata=metadata)
        
        if response.status.code != status_code_pb2.SUCCESS:
          raise Exception("Request failed, status code: " + str(response.status.code))
        
        
        for concept in response.outputs[0].data.concepts:
            print('%12s: %.2f' % (concept.name, concept.value))
        ```
        
Platform: UNKNOWN
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
