Skip to content

Repository files navigation

LocalMind

A Fully Offline, On-Device AI Assistant for Android

LocalMind is a privacy-first AI assistant that runs entirely on your Android device. It uses on-device Large Language Models (LLMs) powered by Alibaba’s MNN (Mobile Neural Network) framework to deliver fast, secure, and responsive AI interactions — without cloud servers and without an internet connection.

Once models are downloaded, LocalMind works completely offline.


Offline First On Device AI Privacy Focused

🚫 No Internet Required

LocalMind is built with a strict offline-first design.

  • ❌ No internet required for chat
  • ❌ No cloud APIs
  • ❌ No background network calls
  • ❌ No data uploads
  • ❌ No user tracking

📌 Internet is required only once — to download models. After that, everything works in offline mode.

All inference, voice processing, vision analysis, and document Q&A run locally on-device.


👉 Click here to [download]

Demo

IMG_6728.MOV

System Requirements

  • Android: Android 10+
  • 📌 Requires 6-8 GB RAM minimum
  • Storage: Depends on model size
  • Internet: Required only for model download
  • Inference: Fully on-device (offline after download)

Key Features

🔒 On-Device AI Chat (100% Offline)

  • Interact with powerful LLMs directly on your phone
  • Inference runs locally using MNN
  • Conversations never leave your device

🧠 Model Marketplace

  • Discover and download open-source models from Hugging Face
  • Pause and resume downloads
  • Local model storage and management

🖼️ Multi-Modal Vision Support (Offline)

  • Vision-Language Models (VLMs)
  • Analyze images and ask questions locally
  • No image uploads or remote processing

📄 PDF Question & Answering

  • Load PDF documents on-device
  • Ask questions about their content
  • Ideal for research, study, and technical documents

🎨 Modern Android UI

  • Built with Jetpack Compose and Material 3
  • Fully declarative, responsive UI
  • Designed for performance and clarity

Architecture Overview

LocalMind is a modular Android application designed for performance, scalability, and maintainability.

🔧 Core Components

Core Inference Engine

  • Powered by MNN (Mobile Neural Network)
  • Native, high-performance on-device inference
  • Low-latency responses without cloud dependency

Model Management (:model_downloader)

  • Dedicated module responsible for:

    • Fetching model metadata
    • Downloading models from Hugging Face
    • Progress tracking and resume support
    • Local model storage

Chat & Session Management

  • LlmSession manages:

    • Prompt handling
    • Streaming token generation
    • Interaction state with the active model

Fully offline end-to-end voice loop


Tech Stack

Android

  • Language: Kotlin (100%)
  • UI: Jetpack Compose, Material 3
  • Async: Coroutines & Flows
  • Dependency Injection: Koin
  • Data Storage: Jetpack DataStore

AI / ML

  • MNN (Mobile Neural Network) – On-device inference
  • Hugging Face API – Model discovery & downloads

Networking

  • Ktor
  • Retrofit
  • OkHttp (Used only for model downloads)

Debugging & Tooling

  • Stetho with custom dumpapp plugins

Supporting Libraries

  • Markwon – Markdown rendering in chat responses
  • PDFBox – PDF parsing and text extraction

Privacy & Offline Philosophy

LocalMind follows a local-only execution model.

  • All AI inference runs on-device
  • Internet access is optional after model download
  • No remote servers, ever
  • No logging, analytics, or telemetry

If your phone has:

  • No signal
  • No Wi-Fi
  • Airplane mode enabled

👉 LocalMind still works.


Base Project

LocalMind is based on Alibaba’s MNN Android LLM framework, heavily reconfigured and extended to support:

  • Offline-first architecture
  • Multi-modal interaction
  • Model marketplace
  • PDF Q&A
  • Modern Jetpack Compose UI

Expect:

  • Performance optimizations
  • UI improvements

About

Run LLM's On Mobile

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages