Skip to content
Back to search

PocketStrike

PocketStrike is a privacy-first mobile AI workstation. It combines zero-cloud native on-device GGUF inference (ARM NEON accelerated) │ with frontier cloud LLMs, multi-step ReAct agent tools, Model Context Protocol (MCP) servers, self-evolving cross-session memory, and FLUX neural image │ generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/abuzar-ansarii--pocketstrike/badge.svg)](/listings/abuzar-ansarii--pocketstrike)

HTML

<a href="/listings/abuzar-ansarii--pocketstrike"><img src="/api/listings/abuzar-ansarii--pocketstrike/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- **Flutter SDK**: `>= 3.29.0` - **Dart SDK**: `>= 3.12.0` - **Android SDK & NDK**: Installed with compileSdk 37, minSdk 26 - **Physical Android Device** (connected via USB/ADB) or Emulator

1. Clone & Setup Dependencies

git clone https://github.com/your-username/PocketStrike.git
cd PocketStrike
flutter pub get

2. Verify Code & Run Tests

# Static analysis (0 warnings / errors)
flutter analyze

# Unit & widget test suite
flutter test

3. Run in Debug Mode on Device

flutter run -d <device_id>

4. Build Final Production Release APK

flutter build apk --release

The optimized release APK will be generated at: `build/app/outputs/flutter-apk/app-release.apk`

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 170 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 📱 PocketStrike
  2. > **Executive Multi-Provider & 100% Offline AI Workstation for Android & Mobile**
  3. > *Bridge the gap between Cloud Frontier LLMs, Local On-Device GGUF Inference, Unlimited AI Image Synthesis, Model Context Protocol (MCP), and Self-Evolving Cross-Session Memory.*
  4. [![Flutter](https://img.shields.io/badge/Flutter-3.29+-02569B?style=for-the-badge&logo=flutter&logoColor=white)](https://flutter.dev)
  5. [![Dart](https://img.shields.io/badge/Dart-3.12+-0175C2?style=for-the-badge&logo=dart&logoColor=white)](https://dart.dev)
  6. [![Offline GGUF](https://img.shields.io/badge/Engine-Offline%20GGUF%20Native-FF6F00?style=for-the-badge)](https://github.com/ggerganov/llama.cpp)
  7. [![MCP](https://img.shields.io/badge/Protocol-MCP%20Enabled-00F0FF?style=for-the-badge)](https://modelcontextprotocol.io)
  8. [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
  9. ---
  10. ## 📁 Repository Structure
  11. ```
  12. PocketStrike/
  13. ├── android/ # Native Android configurations, ProGuard rules, & NDK bridges
  14. ├── lib/
  15. │ ├── app/ # Theme, Glass Tokens, & Router configuration
  16. │ ├── core/ # Drift SQLite Database, DAOs, Models, Notifications & Services
  17. │ │ ├── db/ # Drift tables & queries
  18. │ │ ├── models/ # Provider-agnostic chat models & metrics
  19. │ │ └── services/ # Android notification & background download service
  20. │ ├── shared/ # Glassmorphic UI components, code blocks & custom icons
  21. │ └── features/
  22. │ ├── agent/ # ReAct Agent Engine, Steps, & Built-in Tools
  23. │ ├── chat/ # Chat UI shell, input bar, message cards & speed badges
  24. │ ├── conversations/ # History drawer & thread management
  25. │ ├── local_models/ # Native GGUF inference runtime, model downloader & presets
  26. │ ├── mcp/ # MCP protocol client (Streamable HTTP & SSE) & marketplace
  27. │ ├── providers/ # Multi-provider gateways (OpenAI, Claude, Gemini, DeepSeek, Ollama)
  28. │ ├── settings/ # Local models, MCP, Storage, API keys, & Hermes memory UI
  29. │ └── telegram/ # Telegram Bot autonomous background relay service
  30. └── test/ # Unit and widget test suite
  31. ```
  32. ---
  33. ## 🌟 Key Features & Highlights
  34. - ⚡ **100% Offline On-Device Native GGUF Inference**: Run state-of-the-art quantized SLMs locally on your phone using ARM NEON multi-threaded CPU acceleration. Zero cloud dependency, zero data leaving your device.
  35. - 🔥 **Dedicated Uncensored & Standard SLM Suite**: Curated 1-tap presets including **SmolLM2 135M/360M Heretic**, **Llama 3.2 1B Abliterated**, **Qwen 2.5 0.5B**, **DeepSeek R1 Distill 1.5B**, and **Llama 3.2 3B**.
  36. - ⚡ **Real-Time Token Generation Speed (`⚡ X.X tok/s`)**: Live generation throughput metric displayed dynamically in the bottom-right corner of the AI response container.
  37. - 🎨 **Unlimited AI Image Generation Engine**: Create infinite images from natural language (`/image <prompt>`) with custom aspect ratios (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`), interactive zoom/pan viewer, and 1-tap gallery downloads.
  38. - 📥 **In-App Model Downloading with Live Notification Progress**: Download model weights straight from HuggingFace to your phone's storage with background Android notifications and 1-tap **"Load into RAM"**.
  39. - 📐 **Adaptive Auto-Fitting Chat Layout**: User message bubbles automatically shrink-wrap to their content length (e.g., single-word prompts fit tightly without stretching).
  40. - 🤖 **Autonomous ReAct Agent Engine**: Multi-step tool execution with step-by-step reasoning logs, real-time status chips, and configurable confirmation safety gates.
  41. - 🔌 **Model Context Protocol (MCP) Marketplace**: Native Streamable HTTP & SSE transport support with 11+ built-in servers (Brave Search, GitHub, Puppeteer, PostgreSQL, Memory Graph, Hardware Specs, etc.).
  42. - 🌌 **Hermes Self-Evolving Memory System**: Persistent `USER.md`, `MEMORY.md`, and `SOUL.md` files that autonomously learn your personality, preferences, and context across sessions.
  43. - 📁 **Direct Mobile Storage Management**: File explorer and document tools to read, write, search, and manage files in `/storage/emulated/0/Download` and app documents.
  44. - 🤖 **Telegram Autonomous Remote Relay**: Turn your phone into a 24/7 background AI assistant that receives prompts and replies over Telegram.
  45. - 🎨 **Cyberpunk Glassmorphism UI**: Isolated backdrop blur, dark/light themes, syntax-highlighted code blocks, and haptic feedback.
  46. ---
  47. ## 🏗 Architecture Overview
  48. ```mermaid
  49. graph TD
  50. A[Flutter Glassmorphism UI] --> B[Riverpod State Controllers]
  51. B --> C[Chat & Agent Coordinator]
  52. C --> D[Local AI Engine]
  53. C --> E[Cloud Multi-Provider Gateway]
  54. C --> F[ReAct Agent Engine]
  55. C --> G[Hermes Memory Core]
  56. C --> H[Neural Image Synthesizer]
  57. D --> D1[Native llama.cpp ARM NEON Bridge]
  58. D --> D2[Offline GGUF Weight Store]
  59. D --> D3[Background Download Manager]
  60. E --> E1[OpenAI / Claude / Gemini / DeepSeek / Ollama / OpenRouter]
  61. F --> F1[Built-In Mobile Tools]
  62. F --> F2[MCP Server Transport HTTP / SSE]
  63. G --> G1[USER.md / MEMORY.md / SOUL.md]
  64. H --> H1[Turbo Diffusion Engine & Local Caching]
  65. ```
  66. ---
  67. ## 🧠 Curated Local Model Suite
  68. | Model Name | Parameters | Quantization | RAM Footprint | Category | Key Capability |
  69. | :--- | :---: | :---: | :---: | :---: | :--- |
  70. | **SmolLM2-135M-Instruct-heretic** | 135M | `Q4_K_M` | ~150 MB | 🔥 Uncensored | Ultra-compact, near-zero RAM footprint, zero alignment refusals |
  71. | **SmolLM2-360M-Instruct-Heretic** | 360M | `Q4_K_M` | ~350 MB | 🔥 Uncensored | Balanced reasoning & instruction-following without guardrails |
  72. | **Llama-3.2-1B-Abliterated** | 1.2B | `Q4_K_M` | ~950 MB | 🔥 Uncensored | Unrestricted creative writing, coding, and general assistance |
  73. | **Qwen2.5-0.5B-Instruct** | 0.5B | `Q4_K_M` | ~450 MB | 💬 Standard | Multilingual instruction following & fast summaries |
  74. | **Llama-3.2-1B-Instruct** | 1.2B | `Q4_K_M` | ~950 MB | 💬 Standard | Official Meta 1B model, high quality formatting & reasoning |
  75. | **DeepSeek-R1-Distill-Qwen-1.5B** | 1.5B | `Q4_K_M` | ~1.3 GB | 💬 Standard | Distilled reasoning model with chain-of-thought output |
  76. | **Llama-3.2-3B-Instruct** | 3.2B | `Q4_K_M` | ~2.1 GB | 💬 Standard | Comprehensive complex multi-step reasoning & coding |
  77. | **SD-Turbo-Image-Gen** | Diffusion | `FP16` | ~1.8 GB | 🎨 Image Gen | Fast single-step local image generation |
  78. ---
  79. ## 🎨 Image Generation Commands
  80. Generate images directly in any conversation using natural language:
  81. ```bash
  82. # Square (1:1)
  83. /image cyberpunk neon samurai meditating in rain
  84. # Widescreen (16:9)
  85. /image futuristic electric sports car speeding through tokyo 16:9
  86. # Mobile Wallpaper (9:16)
  87. /image breathtaking bioluminescent alien forest at night 9:16
  88. # Natural Language Phrases
  89. draw a cute fluffy orange cat wearing an astronaut helmet
  90. generate an image of a medieval library filled with glowing crystals
  91. ```
  92. ---
  93. ## 🚀 Getting Started & Build Instructions
  94. ### Prerequisites
  95. - **Flutter SDK**: `>= 3.29.0`
  96. - **Dart SDK**: `>= 3.12.0`
  97. - **Android SDK & NDK**: Installed with compileSdk 37, minSdk 26
  98. - **Physical Android Device** (connected via USB/ADB) or Emulator
  99. ### 1. Clone & Setup Dependencies
  100. ```bash
  101. git clone https://github.com/your-username/PocketStrike.git
  102. cd PocketStrike
  103. flutter pub get
  104. ```
  105. ### 2. Verify Code & Run Tests
  106. ```bash
  107. # Static analysis (0 warnings / errors)
  108. flutter analyze
  109. # Unit & widget test suite
  110. flutter test
  111. ```
  112. ### 3. Run in Debug Mode on Device
  113. ```bash
  114. flutter run -d <device_id>
  115. ```
  116. ### 4. Build Final Production Release APK
  117. ```bash
  118. flutter build apk --release
  119. ```
  120. The optimized release APK will be generated at:
  121. `build/app/outputs/flutter-apk/app-release.apk`
  122. ---
  123. ## 🔒 Security & Sandboxing
  124. - **On-Device Storage Control**: Configurable root directories in **Settings > Storage & Permissions**.
  125. - **Human-in-the-Loop Safeguards**: Irreversible operations (`delete_file`, `overwrite_file`) require explicit confirmation depending on your chosen policy (`Destructive Only`, `Always Ask`, or `Autonomous`).
  126. - **Hardware AES-256 Storage**: All cloud API keys and bot tokens are encrypted in hardware-backed platform storage via `flutter_secure_storage`.
  127. - **R8 / ProGuard Safety**: Native JNI symbol preservation guarantees native model execution in release builds without runtime reflection crashes.
  128. ---
  129. ## 📄 License
  130. PocketStrike is open-source software licensed under the **[MIT License](LICENSE)**.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.