Clarifai/clarifai-web-grpc

Clarifai/clarifai-web-grpc

Language: JavaScript

License: NOASSERTION

Stars: 6

Forks: 0

Open issues: 0

Created: 2020-04-21T18:50:06Z

Pushed: 2026-05-29T16:06:11Z

Default branch: master

Fork: no

Archived: no

README: !image

clarifai-web-grpc

The official Clarifai gRPC client for use in client browser applications.

NB! You cannot access Clarifai API directly from browser due to cross-origin restrictions that is put in place for security reasons (to prevent API token leaks). Please use a proxy server on your backend to have FE -> BE -> Clarifai chain of requests instead.


Installation

yarn add clarifai-web-grpc

Usage

import { ClarifaiStub } from "clarifai-web-grpc";
import { App } from "clarifai-web-grpc/proto/clarifai/api/resources_pb";
import { PostAppsRequest } from "clarifai-web-grpc/proto/clarifai/api/service_pb";

// get a client object
const client = ClarifaiStub.promise()

// create an app
const app = new App();
app.setId("cat-app");
app.setDefaultWorkflowId("General-Detection");
app.setDescription("An app for some cats");

// create a request
const req = new PostAppsRequest();
req.setAppsList([app]);

// send the request
const auth = {
"authorization": `Key ${process.env.CLARIFAI_TOKEN}`,
};
const resp = await client.postApps(req, auth);

// log the app id
console.log(resp.getAppsList()[0].getId());

Examples

See the examples directory for more examples of how to use the clarifai API client

Publishing to NPM

Publishing the client to NPM involves merging a PR with 2 things: 1. Updates the version field in package.json to the appropriate version. 2. Commit message should begin with "GRPC clients version" eg "GRPC clients version 9.4.0".