Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aws-samples/swift-chat

A Cross-platform AI chat application built with React Native and powered by Amazon Bedrock
https://github.com/aws-samples/swift-chat

android aws bedrock bedrock-applications bedrock-client chat-application client genai image-generation ios mac macos mobile-app nova react-native streaming video-understanding

Last synced: 2 days ago
JSON representation

A Cross-platform AI chat application built with React Native and powered by Amazon Bedrock

Awesome Lists containing this project

README 

        
[δΈ­ζ–‡](/README_CN.md)



# SwiftChat - A Cross-platform AI Chat App



SwiftChat is a fast and responsive AI chat application developed with [React Native](https://reactnative.dev/) and

powered by [Amazon Bedrock](https://aws.amazon.com/bedrock/). With its minimalist design philosophy and robust privacy

protection, it delivers real-time streaming conversations and AI image generation capabilities across Android, iOS, and

macOS platforms.



![](assets/promo.png)



**Key Features:**



- Real-time streaming chat with AI

- Rich Markdown Support: Tables, Code Blocks, LaTeX and More

- AI image generation with progress

- Multimodal support (images, videos & documents)

- Conversation history list view and management

- Cross-platform support (Android, iOS, macOS)

- Tablet-optimized for iPad and Android tablets

- Fast launch and responsive performance

- Multiple AI model support and switching

- Fully Customizable System Prompt Assistant (New feature from v1.9.0 πŸŽ‰)



**Supported Features For Amazon Nova**



- Stream conversations with Amazon Nova Micro, Lite and Pro

- Understand images, documents and videos with Nova Lite and Pro

- Record 30-second videos directly on Android and iOS for Nova analysis

- Upload large videos (1080p/4K) beyond 8MB with auto compression

- Support using natural language to make Nova Canvas generate images, remove backgrounds, replace backgrounds, and

  create images in similar styles.

- Support LaTeX formula rendering (inline and display modes) for Amazon Nova.



### Feature Showcase



**Comprehensive Multimodal Analysis**: Text, Image, Document and Video
















**System Prompt Assistant**: Useful Preset System Prompts with Full Management Capabilities (Add/Edit/Sort/Delete)
















**Creative Image Suite**: Generation, Style Replication, Background Removal & Replacement
















**Rich Markdown Support**: Paragraph, Code Blocks, Tables, LaTeX and More



![](assets/markdown.png)



We redesigned the UI with optimized font sizes and line spacing for a more elegant and clean presentation.

All of these features are also seamlessly displayed on Android and macOS with native UI



> Note: Some animated images have been sped up for demonstration. If you experience lag, please view on Chrome, Firefox, 

> or Edge browser on your computer.



## Architecture



![](/assets/architecture.png)



By default, we use **AWS App Runner**, which is commonly used to host Python FastAPI servers, offering high performance,

scalability and low latency.



Alternatively, we provide the option to replace App Runner with **AWS Lambda** using Function URL for a more

cost-effective

solution, as shown in

this [example](https://github.com/awslabs/aws-lambda-web-adapter/tree/main/examples/fastapi-response-streaming).



## Getting Started



### Prerequisites



Ensure you have access to Amazon Bedrock foundation models. SwiftChat default settings are:



- Region: `us-west-2`

- Text Model: `Amazon Nova Pro`

- Image Model: `Stable Diffusion 3.5 Large`



If you are using the image generation feature, please make sure you have enabled access to the `Amazon Nova Lite` model.

Please follow the [Amazon Bedrock User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access-modify.html) to

enable your models.



### Step 1: Set up your API Key



1. Sign in to your AWS console and

   right-click [Parameter Store](https://console.aws.amazon.com/systems-manager/parameters/) to open it in a new tab.

2. Check whether you are in the [supported region](#supported-region), then click on the **Create parameter** button.

3. Fill in the parameters below, leaving other options as default:



   - **Name**: Enter a parameter name (e.g., "SwiftChatAPIKey", will be used as `ApiKeyParam` in Step 2).



   - **Type**: Select `SecureString`



   - **Value**: Enter any string without spaces.(this will be your `API Key` in Step 3)



4. Click **Create parameter**.



### Step 2: Deploy stack and get your API URL



1. Click one of the following buttons to launch the CloudFormation Stack in the same region where your API Key was

   created.



   - **App Runner**



     [![Launch Stack](assets/launch-stack.png)](https://console.aws.amazon.com/cloudformation/home#/stacks/create/template?stackName=SwiftChatAPI&templateURL=https://aws-gcr-solutions.s3.amazonaws.com/swift-chat/latest/SwiftChatAppRunner.template)



   - **Lambda** (Note: For AWS customer use only)



     [![Launch Stack](assets/launch-stack.png)](https://console.aws.amazon.com/cloudformation/home#/stacks/create/template?stackName=SwiftChatLambda&templateURL=https://aws-gcr-solutions.s3.amazonaws.com/swift-chat/latest/SwiftChatLambda.template)



2. Click **Next**, On the "Specify stack details" page, provide the following information:

   - Fill the `ApiKeyParam` with the parameter name you used for storing the API key (e.g., "SwiftChatAPIKey").

   - For App Runner, choose an `InstanceTypeParam` based on your needs.

3. Click **Next**, Keep the "Configure stack options" page as default, Read the Capabilities and Check the "I

   acknowledge that AWS CloudFormation might create IAM resources" checkbox at the bottom.

4. Click **Next**, In the "Review and create" Review your configuration and click **Submit**.



Wait about 3-5 minutes for the deployment to finish, then click the CloudFormation stack and go to **Outputs** tab, you

can find the **API URL** which looks like: `https://xxx.xxx.awsapprunner.com` or `https://xxx.lambda-url.xxx.on.aws`



### Step 3: Download the app and setup with API URL and API Key



1. Download the App



   - Android App click to [Download](https://github.com/aws-samples/swift-chat/releases/download/1.9.0/SwiftChat.apk)

   - macOS App click to [Download](https://github.com/aws-samples/swift-chat/releases/download/1.9.0/SwiftChat.dmg)

   - iOS (Currently we do not provide the iOS version, you can build it locally with Xcode)



2. Launch the App, open the drawer menu, and tap **Settings**.

3. Paste the `API URL` and `API Key` then select the Region.

4. Click the top right βœ“ icon to save your configuration and start your chat.



Congratulations πŸŽ‰ Your SwiftChat App is ready to use!



### Supported Region



- US East (N. Virginia): us-east-1

- US West (Oregon): us-west-2

- Asia Pacific (Mumbai): ap-south-1

- Asia Pacific (Singapore): ap-southeast-1

- Asia Pacific (Sydney): ap-southeast-2

- Asia Pacific (Tokyo): ap-northeast-1

- Canada (Central): ca-central-1

- Europe (Frankfurt): eu-central-1

- Europe (London): eu-west-2

- Europe (Paris): eu-west-3

- South America (SΓ£o Paulo): sa-east-1



## Detailed Features



**Quick Access Tools**: Code Copy, Selection Mode, Scroll Controls and Token Counter














We feature streamlined chat History, Settings pages, and intuitive Usage statistics:



![](assets/history_settings.png)



Similarly, for the Mac version, we not only support the display of history, but also added a permanent sidebar 

display mode after v1.9.0.



![](assets/mac_ui.png)



### Message Handling



- [x] Text copy support:

  - Copy button in message header

  - Copy button in code blocks

  - Direct Select and copy code on macOS (double click or long click on iOS)

  - Long press text to copy entire sentence (Right-click on macOS)

- [x] Text selection mode by tapping message title or double-clicking text

- [x] Message timeline view in history

- [x] Delete messages through long press in history

- [x] Click to preview for uploaded documents and images

- [x] Support Markdown format for both questions and answers

- [x] Maximum 20 images and 5 documents per conversation



### Image Features



- [x] Support image generation with Chinese prompts(Make sure `Amazon Nova Lite` is enabled in your selected region)

- [x] View and zoom generated images

- [x] Long press images to save or share

- [x] Automatic image compression to improve response speed



### User Experience



- [x] Haptic feedback for Android and iOS (can be disabled in Settings)

- [x] Support landscape mode on Android/iOS devices

- [x] Double tap title bar to scroll to top

- [x] Click bottom arrow to view latest messages

- [x] View current session token usage by tapping Chat title

- [x] Check detailed token usage and image generation count in Settings

- [x] In-app upgrade notifications (Android & macOS)



We have optimized the layout for landscape mode. As shown below, you can comfortably view table contents in landscape

orientation.



![](assets/landscape.png)



Similarly, for code that requires horizontal scrolling, rotate to landscape mode for better viewing.



![](assets/avif/landscape.avif)



## What Makes SwiftChat Really "Swift"?



πŸš€ **Fast Launch Speed**



- Thanks to the **AOT** (Ahead of Time) compilation of RN Hermes engine

- Added **lazy loading** of complex components

- App launches instantly and is immediately ready for input



🌐 **Fast Request Speed**



- Speed up end-to-end API requests through **image compression**

- Deploying APIs in the **same region** as Bedrock provides lower latency

- Minimal response payload with **zero parsing** needed for direct display



πŸ“± **Fast Render Speed**



- Using `useMemo` and custom caching to creates secondary cache for session content

- Reduce unnecessary re-renders and speed up streaming messages display

- All UI components are rendered as **native components**



πŸ“¦ **Fast Storage Speed**



- By using **react-native-mmkv** Messages can be read, stored, and updated **10x faster** than AsyncStorage

- Optimized session content and session list storage structure to accelerates history list display



## App Privacy & Security



- Encrypted API key storage

- Minimal permission requirements

- Local-only data storage

- No user behavior tracking

- No data collection

- Privacy-first approach



## App Build and Development



First, clone this repository. All app code is located in the `react-native` folder. Before proceeding, execute the

following command to download dependencies.



```bash

cd react-native && npm i && npm start

```



### Build for Android



open a new terminal and execute:



```bash

npm run android

```



### Build for iOS



also open a new terminal, for the first time you need to install the native dependencies 

by execute `cd ios && pod install && cd ..`, then execute the follow command:  



```bash

npm run ios

```



### Build for macOS



1. Modify as `isMac = true` in `/src/App.tsx` and execute `npm start`.

2. Double click `ios/SwiftChat.xcworkspace` to open the project in your Xcode.

3. Change the build destination to `My Mac (Mac Catalyst)` then click the β–Ά Run button.



## API Reference



Please refer [API Reference](server/README.md)



## How to upgrade?



### Upgrade App



- **Android** and **macOS**: Navigate to **Settings** Page, if there is a new version, you will find it at the bottom

  of this page, then click the app version to download and install it.

- **iOS**: If a new version is released in the [Release page](https://github.com/aws-samples/swift-chat/releases),

  update your local code, rebuild and install your app by Xcode.



**Note**: After downloading a new version, please check

the [release notes](https://github.com/aws-samples/swift-chat/releases) to see if an API version update is required.



### Upgrade API



- **For AppRunner**: Click and open [App Runner Services](https://console.aws.amazon.com/apprunner/home#/services) page,

  find and open `swiftchat-api`, click top right **Deploy** button.

- **For Lambda**: Click and open [Lambda Services](https://console.aws.amazon.com/lambda/home#/functions), find and open

  your Lambda which start with `SwiftChatLambda-xxx`, click the **Deploy new image** button and click Save.



## Security



See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.



## License



This library is licensed under the MIT-0 License. See the [LICENSE](LICENSE) file.