sample-mobile-ai-assistant

Sample Mobile AI Assistant — A Cross-platform AI Chat & Creation App

🚀 Your Personal AI Workspace — Chat, Create Apps, and More

中文

AI Assistant is a fast and responsive cross-platform app developed with React Native and powered by Amazon Bedrock, with compatibility extending to other model providers such as Ollama, DeepSeek, OpenAI and OpenAI Compatible. With its minimalist design philosophy and robust privacy protection, it delivers real-time streaming conversations, AI image generation, instant web app creation and voice conversation capabilities across Android, iOS, and macOS platforms.

What’s New 🔥

• 🚀 Support creating multiple apps in background with Live Activity on iOS and notifications on Android (From v2.8.0).
• 🚀 Upgrade to React Native 0.83 with New Architecture enabled (From v2.8.0).
• 🚀 Support create or edit instant web apps with one prompt (From v2.7.0).
• 🚀 Support Web Search for real-time information retrieval (From v2.7.0).
• 🚀 Update App Server with API Gateway + Lambda deployment supporting 15-minute streaming output (From v2.7.0).
• 🚀 Support Image Gallery for browsing and managing generated images (From v2.7.0).

Create App: Generate, Edit, Share and Preview Instant Web Apps

App Examples: 2048 Game, Gomoku, Tetris and News Reader

Web Search & Mermaid: Real-time Information Retrieval and Streaming Chart Rendering

Note: Tavily is recommended for best results. Google Search requires manual verification on first use. Baidu and Bing are currently in beta and may return inaccurate results.

Getting Started with Amazon Bedrock

Configuration

You can choose one of the following two methods for configuration

curl -fsSL https://raw.githubusercontent.com/aws-samples/sample-mobile-ai-assistant/main/server/install.sh | bash

./install.sh --region us-west-2 --stack MyAIAssistant --profile myprofile

Getting Started with Other Model Providers

Ollama

DeepSeek

OpenAI

OpenAI Compatible

Key Features

• Real-time streaming chat with AI
• Instant web app creation, editing and sharing
• Background app creation with progress tracking
• Web search for real-time information retrieval
• Rich Markdown Support: Tables, Code Blocks, LaTeX, Mermaid Chart 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 models supported (Amazon Bedrock, Ollama, DeepSeek, OpenAI and OpenAI Compatible Models)
• Fully Customizable System Prompt Assistant

Feature Showcase

Comprehensive Multimodal Analysis: Text, Image, Document and Video

Creative Image Suite: Generation, Virtual try-on, Background Removal and Image Gallery with Nova Canvas

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

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

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

Dark Mode

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.

Amazon Nova Series Features

Easy to use Virtual try-on by Nova Canvas

1. Support automatic setting of the main image, default is the previously used main image.
2. Support uploading or taking the second image and sending it directly without any prompt words.
3. Support automatically recognizes clothes, pants, shoes and tries them on

Amazon Nova Sonic Speech to Speech Model

1. Built-in spoken language practice for words and sentences, as well as storytelling scenarios. You can also add Custom System Prompts for voice chatting in different scenarios.
2. Support Barge In by default, Also you can disable in system prompt.
3. Support selecting voices in the settings page, including American/British English, Spanish and options for male and female voices.
4. Support Echo Cancellation, You can talk directly to the device without wearing headphones.
5. Support Voice Waveform to display volume level.

Learn Sentences

https://github.com/user-attachments/assets/ebf21b12-9c93-4d2e-a109-1d6484019838

Telling Story on Mac (With barge in feature)

https://github.com/user-attachments/assets/c70fc2b4-8960-4a5e-b4f8-420fcd5eafd4

Note: Amazon Nova Sonic currently only available with App Server.

Other Features

• Record 30-second videos directly on Android and iOS for Nova analysis
• Upload large videos (1080p/4K) beyond 8MB with auto compression
• Support using default template to make Nova Canvas generate images, remove backgrounds, and create images in similar styles.

Detailed Features

Quick Access Tools: Code & Content Copy, Selection Mode, Model Switch, Regenerate, Scroll Controls and Token Counter

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

Message Handling

• Text copy support:
  • Copy button at the bottom of messages, or directly click the model name or user title section.
  • Copy button in code blocks
  • Copy button in reasoning blocks
  • Direct Select and copy code on macOS (double-click or long click on iOS)
  • Long press text to copy the entire sentence (Right-click on macOS)
• Text selection mode by click selection button.
• Message timeline view in history
• Delete messages through long press in history
• Click to preview for documents videos and images
• Support for collapsing and expanding the reasoning section and remembering the most recent state

Image Features

• Support image generation with Chinese prompts (Make sure Amazon Nova Lite is enabled in your selected region)
• Long press images to save or share
• Automatic image compression to improve response speed
• Image Gallery for browsing and managing all generated images

User Experience

• Haptic feedback for Android and iOS (can be disabled in Settings)
• Support landscape mode on Android/iOS devices
• Double tap title bar to scroll to top
• Click bottom arrow to view the latest messages
• Display system prompt and model switch icon again by clicking on the chat title
• View current session token usage by tapping twice Chat title
• Check detailed token usage and image generation count in Settings
• In-app upgrade notifications (Android & macOS)

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

What Makes AI Assistant Really Fast?

🚀 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

📱 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.

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

Build for Android

open a new terminal and execute:

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:

npm run ios

Build for macOS

1. Execute npm start.
2. Double click ios/AIAssistant.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

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, update your local code, rebuild and install your app by Xcode.

Note: After downloading a new version, please check the release notes to see if an API version update is required.

Upgrade API

Re-run the same install script; it will rebuild the image and refresh the Lambda automatically:

cd server
./install.sh --region <your-region> --stack <your-stack>

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.