# ronith256/localgpt-android architecture

> Architecture diagram of the GitHub repository ronith256/localgpt-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ronith256/localgpt-android
- Repository: https://github.com/ronith256/localgpt-android

## Overview

LocalGPT-Android is an offline-capable Android text-completion app: users obtain and load a local GPT4All model, create or reopen chats, submit prompts, and view generated responses. The main activity owns model download/loading and chat-list navigation; the message screen invokes native inference and watches a response file, then persists the conversation. Settings configure context size and inference threads. The README also documents downloading the model and chat-style prompting. Edges reflect only relationships visible in the excerpts or README; native implementation details were not sampled.

Main entry points: [`app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java) (Chat launcher), [`app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageView.java) (Conversation screen), [`app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java`](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java) (Chat list adapter), [`app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java`](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java) (Inference settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Model lifecycle"]
  node_model_download["Model download<br/>[MainActivity.java]"]
  node_model_runtime["Native model runtime<br/>[MainActivity.java]"]
  node_native_engine{{"Local GPT engine"}}
  node_response_file[("Response file<br/>[MainActivity.java]")]
end

subgraph group_chat["Chat workflow"]
  node_main["Chat launcher<br/>[MainActivity.java]"]
  node_chat_adapter["Chat list adapter<br/>[ChatAdapter.java]"]
  node_chat_record["Chat metadata<br/>[Chat.java]"]
  node_chat_store[("Chat list storage<br/>[MainActivity.java]")]
  node_swipe_delete["Swipe deletion"]
end

subgraph group_ui["Conversation UI"]
  node_message_view["Conversation screen<br/>[MessageView.java]"]
  node_message_record["Message data<br/>[Message.java]"]
  node_message_adapter["Message renderer"]
  node_conversation_store[("Conversation storage<br/>[MessageView.java]")]
end

subgraph group_config["Settings"]
  node_settings["Inference settings"]
  node_preferences[("App preferences")]
end

node_user(("User"))

node_user -->|"opens app"| node_main
node_main -->|"downloads model"| node_model_download
node_model_download -->|"loads model"| node_model_runtime
node_model_runtime -.->|"calls JNI"| node_native_engine
node_main -->|"reads and writes"| node_chat_store
node_main -->|"displays chats"| node_chat_adapter
node_chat_adapter -->|"renders metadata"| node_chat_record
node_main -->|"opens conversation"| node_message_view
node_main -->|"attaches callback"| node_swipe_delete
node_swipe_delete -->|"dispatches deletion"| node_chat_adapter
node_message_view -->|"requests completion"| node_model_runtime
node_message_view -->|"watches output"| node_response_file
node_model_runtime -.->|"writes output"| node_response_file
node_message_view -->|"loads and saves"| node_conversation_store
node_message_view -->|"updates display"| node_message_adapter
node_message_adapter -->|"renders messages"| node_message_record
node_message_view -->|"opens settings"| node_settings
node_main -->|"opens settings"| node_settings
node_settings -->|"saves values"| node_preferences
node_message_view -->|"reads context size"| node_preferences

click node_main "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java"
click node_model_download "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java"
click node_model_runtime "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java"
click node_chat_adapter "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java"
click node_chat_record "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/Chat.java"
click node_chat_store "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java"
click node_swipe_delete "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SwipeToDeleteCallback.java"
click node_message_view "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageView.java"
click node_message_record "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/Message.java"
click node_message_adapter "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageAdapter.java"
click node_response_file "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java"
click node_conversation_store "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageView.java"
click node_settings "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java"
click node_preferences "https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_model_download,node_model_runtime,node_native_engine,node_response_file,node_user toneBlue
class node_main,node_chat_adapter,node_chat_record,node_chat_store,node_swipe_delete toneAmber
class node_message_view,node_message_record,node_message_adapter,node_conversation_store toneMint
class node_settings,node_preferences toneRose
```

## Components

### Model lifecycle

- [Model download](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java): `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`
- [Native model runtime](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java): `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`
- **Local GPT engine**
- [Response file](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java): `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`

### Chat workflow

- [Chat launcher](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java): `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`
- [Chat list adapter](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java): `app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java`
- [Chat metadata](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/Chat.java): `app/src/main/java/com/lucario/gpt4allandroid/Chat.java`
- [Chat list storage](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java): `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`
- [Swipe deletion](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SwipeToDeleteCallback.java): `app/src/main/java/com/lucario/gpt4allandroid/SwipeToDeleteCallback.java`

### Conversation UI

- [Conversation screen](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageView.java): `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`
- [Message data](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/Message.java): `app/src/main/java/com/lucario/gpt4allandroid/Message.java`
- [Message renderer](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageAdapter.java): `app/src/main/java/com/lucario/gpt4allandroid/MessageAdapter.java`
- [Conversation storage](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/MessageView.java): `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`

### Settings

- [Inference settings](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java): `app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java`
- [App preferences](https://github.com/ronith256/localgpt-android/blob/master/app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java): `app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java`

### Other components

- **User**

## Connections

- User → Chat launcher: opens app
- Chat launcher → Model download: downloads model (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Model download → Native model runtime: loads model (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Native model runtime → Local GPT engine: calls JNI
- Chat launcher → Chat list storage: reads and writes (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Chat launcher → Chat list adapter: displays chats (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Chat list adapter → Chat metadata: renders metadata (evidence: `app/src/main/java/com/lucario/gpt4allandroid/ChatAdapter.java`)
- Chat launcher → Conversation screen: opens conversation (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Chat launcher → Swipe deletion: attaches callback (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Swipe deletion → Chat list adapter: dispatches deletion (evidence: `app/src/main/java/com/lucario/gpt4allandroid/SwipeToDeleteCallback.java`)
- Conversation screen → Native model runtime: requests completion (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
- Conversation screen → Response file: watches output (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
- Native model runtime → Response file: writes output (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Conversation screen → Conversation storage: loads and saves (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
- Conversation screen → Message renderer: updates display (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
- Message renderer → Message data: renders messages (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageAdapter.java`)
- Conversation screen → Inference settings: opens settings (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
- Chat launcher → Inference settings: opens settings (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MainActivity.java`)
- Inference settings → App preferences: saves values (evidence: `app/src/main/java/com/lucario/gpt4allandroid/SettingsDialogFragment.java`)
- Conversation screen → App preferences: reads context size (evidence: `app/src/main/java/com/lucario/gpt4allandroid/MessageView.java`)
