Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dabit3/react-native-ai
Full stack framework for building cross-platform mobile AI apps
https://github.com/dabit3/react-native-ai
ai cross-platform express llm react react-native streaming
Last synced: 3 months ago
JSON representation
Full stack framework for building cross-platform mobile AI apps
- Host: GitHub
- URL: https://github.com/dabit3/react-native-ai
- Owner: dabit3
- License: mit
- Created: 2023-11-01T18:16:40.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-15T21:57:47.000Z (6 months ago)
- Last Synced: 2024-07-17T22:54:50.202Z (4 months ago)
- Topics: ai, cross-platform, express, llm, react, react-native, streaming
- Language: TypeScript
- Homepage: https://nader.codes
- Size: 7 MB
- Stars: 772
- Watchers: 9
- Forks: 100
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[![Ceasefire Now](https://badge.techforpalestine.org/default)](https://techforpalestine.org/learn-more)
# React Native AI
Full stack framework for building cross-platform mobile AI apps supporting LLM real-time / streaming text and chat UIs, image services and natural language to images with multiple models, and image processing.
![React Native AI](https://i.imgur.com/AOOgBM0.png)
> Check out the video tutorial [here](https://www.youtube.com/watch?v=zf3NnTU5pr4)
## Features
- LLM support for [OpenAI](https://openai.com/) ChatGPT, [Anthropic](https://anthropic.com) Claude, [Cohere](https://cohere.com/), Cohere Web, [Gemini](https://makersuite.google.com), and [Mistral](https://mistral.ai/)
- An array of image models provided by [Fal.ai](https://www.fal.ai/)
- Real-time / streaming responses from all providers
- OpenAI Assistants including code interpreter and retrieval
- Server proxy to easily enable authentication and authorization with auth provider of choice.
- Theming (comes out of the box with 5 themes) - easily add additional themes with just a few lines of code.
- Image processing with [ByteScale](https://bytescale.com/)![React Native AI Preview](https://i.imgur.com/D4LIVal.png)
## Usage
Generate a new project by running:
```sh
npx rn-ai
```Next, either configure your environment variables with the CLI, or do so later.
### Running the app
Change into the app directory and run:
```sh
npm start
```### Running the server
Change into the server directory and run:
```sh
npm run dev
```## Theming
To add a new theme, open `app/src/theme.ts` and add a new theme with the following configuration:
```ts
const christmas = {
// extend an existing theme or start from scratch
...lightTheme,
name: 'Christmas',
label: 'christmas',
tintColor: '#ff0000',
textColor: '#378b29',
tabBarActiveTintColor: '#378b29',
tabBarInactiveTintColor: '#ff0000',
placeholderTextColor: '#378b29',
}
```At the bottom of the file, export the new theme:
```ts
export {
lightTheme, darkTheme, hackerNews, miami, vercel, christmas
}
```![React Native AI Themes](https://i.imgur.com/7Gser4F.png)
## Configuring LLM Models
Here is how to add new or remove existing LLM models.
### In the app
You can add or configure a model by updating `MODELS` in `constants.ts`.
For removing models, just remove the models you do not want to support.
For adding models, once the model definition is added to the `MODELS` array, you should update `src/screens/chat.tsx` to support the new model:
1. Create local state to hold new model data
2. Update `chat()` function to handle new model type
3. Create `generateModelReponse` function to call new model
4. Update `getChatType` in `utils.ts` to configure the LLM type that will correspond with your server path.
5. Render new model in UI```tsx
{
chatType.label.includes('newModel') && (
)
}
```### On the server
Create a new file in the `server/src/chat` folder that corresponds to the model type you created in the mobile app. You can probably copy and re-use a lot of the streaming code from the other existing paths to get you started.
Next, update `server/src/chat/chatRouter` to use the new route.
## Configuring Image Models
Here is how to add new or remove existing Image models.
### In the app
You can add or configure a model by updating `IMAGE_MODELS` in `constants.ts`.
For removing models, just remove the models you do not want to support.
For adding models, once the model definition is add to the `IMAGE_MODELS` array, you should update `src/screens/images.tsx` to support the new model.
Main consideration is input. Does the model take text, image, or both as inputs?
The app is configured to handle both, but you must update the `generate` function to pass the values to the API accordingly.
### On the server
#### Fal.ai
In `server/src/images/fal`, update the handler function to take into account the new model.
#### Other API providers
Create a new file in `server/src/images/modelName`, update the handler function to handle the new API call.
Next, update `server/src/images/imagesRouter` to use the new route.