---
id: clarifai-grpc
version: "12.6.0"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# clarifai-grpc — Clarifai gRPC API Client

License: permissive · Maintenance: active · Downloads: 157.9K/mo

## What it is and what it does

Clarifai-grpc is the official Python client for Clarifai's AI platform, wrapping the gRPC API to let developers call computer vision and natural language processing models from Python code. It handles authentication, request marshalling, and response parsing for tasks like image classification, object detection, and text analysis. The library version tracks the backend API version (first two numbers) with independent patch releases for library improvements.

You construct a V2Stub object using ClarifaiChannel to access all API functionality, then build and send requests using protobuf message types. The library supports encrypted gRPC, HTTPS+JSON, and unencrypted gRPC channels, though the encrypted channel is recommended for production. Authentication is credential-based (API key) passed as gRPC metadata.

Use it for:

- Classify images using Clarifai's general-image-recognition model or custom trained models.
- Extract concepts and tags from images or video frames in batch processing workflows.
- Build AI-powered content moderation or tagging systems integrated with Clarifai's models.
- Perform natural language processing tasks via Clarifai's text models in Python applications.
- Integrate Clarifai's pre-trained models into data science pipelines for computer vision tasks.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A gRPC client library for the Clarifai AI platform, enabling Python developers to call computer vision and natural language processing models via the Clarifai API.

Yes, if you need to call Clarifai's AI models from Python. The library is actively maintained, has low install friction, carries a permissive license, and requires no known security patches. It is the official client and the primary way to access Clarifai's API from Python. Install it only if you have a Clarifai account and API credentials.

## Install

pip install clarifai-grpc
uv add clarifai-grpc
poetry add clarifai-grpc

## Installing clarifai-grpc

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a release within the last month. Requires grpcio, protobuf, and googleapis-common-protos as runtime dependencies, all standard gRPC ecosystem packages.

License in practice: Licensed under Apache 2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install clarifai-grpc

from clarifai_grpc.channel.clarifai_channel import ClarifaiChannel
from clarifai_grpc.grpc.api import service_pb2_grpc

stub = service_pb2_grpc.V2Stub(ClarifaiChannel.get_grpc_channel())

Requires a Clarifai API key and application ID; setuptools >= 40.7.1 may be needed if grpcio wheel build fails during installation.

Verify before relying:

- Whether the library maintains backward compatibility across API version updates, given its non-semantic versioning scheme.
- Performance characteristics and latency expectations for typical inference requests.
- Rate limiting and quota behavior when calling the Clarifai API.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 157.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

clarifai api client, grpc image recognition, computer vision api python, clarifai python client, ai model inference api, image classification api, nlp api client, grpc-client, computer-vision, api-wrapper

[View on SkillFed](https://skillfed.io/packages/clarifai-grpc) · [View on PyPI](https://pypi.org/project/clarifai-grpc/)