Data

Tools

Indexes

Applications

Experiments

Awesome

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

https://github.com/galaxycoils/darius-bot-mobile

Pocket Power — privacy-first on-device AI assistant for iOS & Android (sideload only)
https://github.com/galaxycoils/darius-bot-mobile

ai android ios llm offline-ai privacy react-native sideload

Last synced: about 1 month ago
JSON representation

Pocket Power — privacy-first on-device AI assistant for iOS & Android (sideload only)

Awesome Lists containing this project

README 

          
# Pocket Power 📱🚀



> **Made by Darius** — a personal, privacy-first AI assistant built for anyone who wants powerful on-device AI without cloud dependencies or subscriptions.



## About



Pocket Power is a pocket-sized AI assistant powered by small language models (SLMs) that run directly on your phone — no internet, no cloud, no subscriptions. Everything happens on your device, so your conversations stay private and work even when you're offline.



Built by **Darius** as a personal project. Forked and customized from the open-source [PocketPal AI](https://github.com/a-ghorbani/pocketpal-ai) project.



> **Privacy note**: The only data that may ever leave your device is what you explicitly choose to share — benchmark results (optional leaderboard contribution) or voluntary feedback. That's it.



## Table of Contents



- [Pocket Power 📱🚀](#pocket-power-)

  - [About](#about)

  - [Table of Contents](#table-of-contents)

  - [📰 News & Announcements](#-news--announcements)

  - [Features](#features)

  - [Installation](#installation)

    - [iOS — Sideload via Sideloadly](#ios--sideload-via-sideloadly)

    - [Android — Sideload the APK](#android--sideload-the-apk)

  - [Usage](#usage)

    - [Downloading a Model](#downloading-a-model)

    - [Loading a Model](#loading-a-model)

    - [Chatting with the model](#chatting-with-the-model)

    - [Copying Text](#copying-text)

    - [Message Editing](#message-editing)

    - [Using Pals](#using-pals)

    - [Benchmarking](#benchmarking)

    - [Setup Hugging Face Access Token](#setup-hugging-face-access-token)

    - [Send Feedback](#send-feedback)

  - [Development Setup](#development-setup)

    - [Prerequisites](#prerequisites)

    - [Getting Started](#getting-started)

    - [Scripts](#scripts)

  - [Contributing](#contributing)

    - [Quick Start for Contributors](#quick-start-for-contributors)

  - [Roadmap](#roadmap)

  - [License](#license)

  - [Contact](#contact)

  - [Acknowledgements](#acknowledgements)



## 📰 News & Announcements

- **🔒 HF Token Authentication (v1.9.0, Apr, 2025)**: Access gated models from Hugging Face with your authentication token.

- **🌐 Localization Support (v1.8.16, Apr, 2025)**: Pocket Power now supports multiple languages (At the moment Japanese and Chinese).

- **📱 iPad Support (v1.8.12, Mar, 2025)**: Full support for iPad devices including landscape orientation.

- **👤 Pals Feature (v1.8.0, Feb, 2025)**: Create and chat with personalized AI assistants with different personalities.

- **🔍 Benchmarking Tool (v1.6.1, 2024)**: Test and compare model performance with the built-in benchmarking feature.

- **🎨 New Icon Alert (Nov 2024)**: Pocket Power has a fresh new look! Huge thanks to **[Chun Te Lee](https://github.com/Reeray)** for the design! [Read more](https://github.com/galaxycoils/darius-bot-mobile/discussions/102).

- **🚀 Hugging Face Public Hub Integration (v1.5, Nov 2024)**: Pocket Power now integrates with the Hugging Face model Hub! Browse, download, and run models directly from the Hugging Face Hub within the app. [Read more](https://github.com/galaxycoils/darius-bot-mobile/discussions/104)



## Features



- **Offline AI Assistance**: Run language models directly on your device without internet connectivity.

- **Model Flexibility**: Download and swap between multiple SLMs, including Danube 2 and 3, Phi, Gemma 2, and Qwen.

- **Auto Offload/Load**: Automatically manage memory by offloading models when the app is in the background.

- **Inference Settings**: Customize model parameters like system prompt, temperature, BOS token, and chat templates.

- **Real-Time Performance Metrics**: View tokens per second and milliseconds per token during AI response generation.

- **Message Editing**: Edit your messages and retry AI generation.

- **Personalized Pals**: Create different AI personalities with customized settings.

- **Background Downloads**: Continue downloading models while using other apps (iOS).

- **Screen Awake During Inference**: Keep your screen on while the AI is generating responses.

- **Multi-device Support**: Optimized for both phones and tablets, including iPad.

- **Localization**: Use the app in your preferred language.

- **Hugging Face Integration**: Access both public and gated models with authentication.



## Installation



> ⚠️ **Pocket Power is not on the App Store or Google Play.** You install it by sideloading — it's easier than it sounds, and the steps below walk you through it completely.



---



### iOS — Sideload via Sideloadly



No jailbreak needed. You only need a free Apple ID and a USB cable.



**Step 1 — Download Sideloadly (free)**



Go to **[sideloadly.io](https://sideloadly.io/)** and download the installer for your computer (Mac or Windows). Install it like any normal app.



**Step 2 — Download the Pocket Power IPA**



[![Download for iOS](https://img.shields.io/badge/⬇️_Download-PocketPower--unsigned.ipa-7c3aed?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/galaxycoils/darius-bot-mobile/releases/latest)



Click the button above → on the Releases page, find **`PocketPower-unsigned.ipa`** → click it to download.



**Step 3 — Connect your iPhone**



Plug your iPhone into your Mac or PC with a USB cable. Unlock your phone if it asks.



**Step 4 — Install with Sideloadly**



1. Open **Sideloadly**

2. Drag the `PocketPower-unsigned.ipa` file into the Sideloadly window

3. Type in your **Apple ID email address** and click **Start**

4. Sideloadly will sign and install the app on your phone (takes ~30 seconds)



> If prompted on your iPhone, tap **Trust** on the dialog that appears.



**Step 5 — Trust the app on your iPhone**



On your iPhone, go to:



**Settings → General → VPN & Device Management → [your Apple ID] → Trust**



Tap **Trust** again on the confirmation. Now open **Pocket Power**. Done! 🎉



> 📅 **Heads up:** Free Apple IDs expire after **7 days**. Just re-run Sideloadly with the same IPA to refresh — it takes 30 seconds. A paid Apple Developer account ($99/yr) gives 1-year validity.



---



### Android — Sideload the APK



No extra software needed on your computer — just download the file directly to your phone.



**Step 1 — Download the Pocket Power APK**



[![Download for Android](https://img.shields.io/badge/⬇️_Download-PocketPower--debug.apk-06b6d4?style=for-the-badge&logo=android&logoColor=white)](https://github.com/galaxycoils/darius-bot-mobile/releases/latest)



Click the button above → on the Releases page, find **`PocketPower-debug.apk`** → tap it to download.



> Tip: Download directly on your phone for the easiest install.



**Step 2 — Allow installing from unknown sources**



Android blocks apps from outside the Play Store by default. To allow it:



1. Open **Settings**

2. Go to **Apps** → **Special app access** → **Install unknown apps**

3. Find your browser (e.g. Chrome) or file manager → tap it → enable **Allow from this source**



> The exact menu name varies by Android version. If you can't find it, search "unknown apps" in your Settings search bar.



**Step 3 — Install the APK**



Open the downloaded `PocketPower-debug.apk` file (check your Downloads folder or notification bar) and tap **Install**.



Open **Pocket Power**. Done! 🎉



Install via ADB (advanced users)



If you have ADB installed, you can install via USB from your computer:



```bash

adb install PocketPower-debug.apk

```



## Usage



### Downloading a Model



1. Open the app and tap the **Menu** icon (☰).

2. Navigate to the **Models** page.

3. Choose a model from the list and tap **Download**.

4. Or tap the + button to add models from Hugging Face or locally downloaded ones.

5. If you select "Add from Hugging Face", you can search GGUF models directly on HF and select any quantization that fits your device (memory and storage).

6. You can then download it immediately or bookmark it for later.



Download Models Screenshot



### Loading a Model



- After downloading, tap **Load** next to the model to load it to memory.

- You can also load a model directly within the chat page using the chevron icon on the left side of the chat input.



### Chatting with the model 



1. Ensure a model is loaded.

2. Navigate to the **Chat** page from the menu.

3. Start conversing with your AI assistant!

4. The screen will stay awake during inference and deactivate when idle.

5. You can select and load models using the chevron icon on the left side of the chat input.



Chat Screenshot



### Copying Text



- **Copy Entire Response**: Tap the copy icon at the bottom of the AI's response bubble.

- **Copy Specific Paragraph**: Long-press on a paragraph to copy its content.



*Note*: Preserving text formatting while copying is currently limited. We're working on improving this feature.



### Message Editing



1. Long-press on any of your messages to edit them.

2. After editing, the AI will regenerate its response based on your changes.

3. Use the retry option to get a new response without changing your message.

4. You can also retry generation using a different model for comparison or better results.



### Using Pals



1. Create personalized AI assistants with different personalities and settings.

2. Pocket Power offers two different pal types:

   - **Assistant Pal**: Select a default model, set a system prompt (manually or generated by another AI), and customize chat text input color.

   - **Roleplay Pal**: Similar to Assistant Pal plus additional settings for location, AI's role, and other contextual parameters.

3. Select a Pal using the Pal picker in the chat page to quickly switch between different personas.





  Assistant Pal Screenshot

  
An example of creating a cocktail recipe assistant







  Roleplay Pal Screenshot

  
Setting up a roleplay pal with custom parameters







  AI-Generated System Prompt

  
Using AI to generate system prompts for your pals





### Benchmarking



1. Navigate to the Benchmarking page.

2. Run performance tests on your models to compare speed and efficiency.

3. View detailed metrics like tokens per second and memory usage.

4. Share your benchmark results and compare with other devices on the [Pocket Power Phone Leaderboard](https://huggingface.co/spaces/galaxycoils/ai-phone-leaderboard).



Benchmark Screenshot



### Setup Hugging Face Access Token



Access gated models from Hugging Face by setting up your authentication token:



1. First, get an access token from your Hugging Face account:

   - Refer to the [HF Security Tokens documentation](https://huggingface.co/docs/hub/en/security-tokens)



   Get Token from Hugging Face



2. In Pocket Power:

   - Navigate to the Settings page

   - Tap on "Set Token"

   - Paste your personal access token in the text input

   - Save



   Token Setup in Pocket Power



### Send Feedback



Share your thoughts directly from the app:



1. Navigate to the App Info page

2. Tap on "Sharing your thoughts" 

3. Type in whatever you'd like to share, from feature requests to suggestions

4. Hit "Submit Feedback"



Send Feedback Screenshot



## Development Setup



Interested in contributing or running the app locally? Follow the steps below.



### Prerequisites



- **Node.js** (version 18 or higher)

- **Yarn**

- **React Native CLI**

- **Xcode** (for iOS development)

- **Android Studio** (for Android development)



### Getting Started



1. **Fork and Clone the Repository**



   ```bash

   git clone https://github.com/galaxycoils/darius-bot-mobile

   cd darius-bot-mobile

   ```



2. **Install Dependencies**



   ```bash

   yarn install

   ```



3. **Install Pod Dependencies (iOS Only)**



   ```bash

   cd ios

   pod install

   cd ..

   ```



4. **Run the App**



   - **iOS Simulator**



     ```bash

     yarn ios

     ```



   - **Android Emulator**



     ```bash

     yarn android

     ```



### Scripts



- **Start Metro Bundler**



  ```bash

  yarn start

  ```



- **Clean Build Artifacts**



  ```bash

  yarn clean

  ```



- **Lint and Type Check**



  ```bash

  yarn lint

  yarn typecheck

  ```



- **Run Tests**



  ```bash

  yarn test

  ```



## Contributing



We welcome all contributions! Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) before you start.



### Quick Start for Contributors



1. **Fork the Repository**

2. **Create a New Branch**



   ```bash

   git checkout -b feature/your-feature-name

   ```



3. **Make Your Changes**

4. **Test Your Changes**



   - **Run on iOS**



     ```bash

     yarn ios

     ```



   - **Run on Android**



     ```bash

     yarn android

     ```



5. **Lint and Type Check**



   ```bash

   yarn lint

   yarn typecheck

   ```



6. **Commit Your Changes**



   - Follow the Conventional Commits format:



     ```bash

     git commit -m "feat: add new model support"

     ```



7. **Push and Open a Pull Request**



   ```bash

   git push origin feature/your-feature-name

   ```



## Roadmap



- **New Models**: Add support for more tiny LLMs.

- **UI/UX Enhancements**: Continue improving the overall user interface and user experience.

- **Improved Documentation**: Enhance the documentation of the project.

- **Performance Optimization**: Further optimize performance across different device types.

- **More Languages**: Add support for additional languages through localization.

- **Enhanced Error Handling**: Improve error handling and recovery mechanisms.



Feel free to open issues to suggest features or report bugs.



## License



This project is licensed under the [MIT License](LICENSE).



## Contact



Built by **Darius**. For questions, suggestions, or feedback, open an issue on GitHub.



## Acknowledgements



Pocket Power is built on top of amazing open-source work:



- **[PocketPal AI](https://github.com/a-ghorbani/pocketpal-ai)**: The original open-source project this app is forked from — full credit to the contributors.

- **[llama.cpp](https://github.com/ggerganov/llama.cpp)**: Enables efficient inference of LLMs on local devices.

- **[llama.rn](https://github.com/mybigday/llama.rn)**: Implements llama.cpp bindings into React Native.

- **[React Native](https://reactnative.dev/)**: The framework powering the cross-platform mobile experience.

- **[MobX](https://mobx.js.org/)**: State management library that keeps the app reactive and performant.

- **[React Native Paper](https://callstack.github.io/react-native-paper/)**: Material Design components for the UI.

- **[React Navigation](https://reactnavigation.org/)**: Routing and navigation for the app's screens.

- **[Gorhom Bottom Sheet](https://github.com/gorhom/react-native-bottom-sheet)**: Powers the smooth bottom sheet interactions throughout the app.

- **[@dr.pogodin/react-native-fs](https://github.com/birdofpreyru/react-native-fs)**: File system access that enables model download and management.



And many other open source libraries that make this project possible!



---



Happy exploring! 🚀📱✨