Skip to content

backmesh/anthropic-react-native

Repository files navigation

Anthropic React Native Client

The goal of this library is to use React Native SSE instead of polyfills to support calling the Anthropic API directly from React Native with streaming. The package uses the same types and API as the Anthropic Node SDK wherever possible.

Caution

This package is meant to be used with a proxy to Anthropic like the one Backmesh provides. The baseURL parameter for this Anthropic client is thus mandatory. If you do not use a proxy and set the baseURL to https://api.anthropic.com/v1, you are basically exposing your Anthropic API key on the internet! You should never expose any secrets in the bundle of a web or mobile app. The correct usage of this client is to create an endpoint on a proxy server for communication with Anthropic and then use that endpoint with a user generated auth JWT in your app.

Contributions and Feature Requests

If you would like to contribute or request a feature, please join our Discord and ask questions in the #oss channel or create a pull request or issue.

Setup

Install the package

npm i anthropic-react-native

And then instantiate the client:

import Anthropic from 'anthropic-react-native';

const client = new Anthropic({
  baseURL:
    'https://edge.backmesh.com/v1/proxy/PyHU4LvcdsQ4gm2xeniAFhMyuDl2/yWo35DdTROVMT52N0qs4/',
  // The backmesh proxy uses your auth provider's JWT to authorize access
  apiKey: supabase.auth.session().access_token,
});

Usage

The streaming APIs uses an EventSource from react-native-sse under the hood to provide a required typed event callbacks for each of the Anthropic API Types.

client.messages.stream(
  {
    model: 'claude-3-5-sonnet-20240620',
    messages: [{ role: 'user', content: userInput }],
    max_tokens: 1024,
  },
  {
    onError: (error) => {
      console.error('SSE Error:', error); // Handle any errors here
    },
    onMessageStart: () => {
      setUserInput('');
    },
    onContentBlockDelta: (ev: ContentBlockDeltaEvent) => {
      if (ev.delta.type === 'text_delta')
        setText((prevText) => prevText + (ev.delta as TextDelta).text);
    },
    onMessageStop: () => {
      console.log('SSE connection for completion closed.'); // Handle when the connection is opened
    },
  }
);

Check the example for more details

Coverage

License

MIT