# suryavs2011/llama.cpp-android architecture

> Architecture diagram of the GitHub repository suryavs2011/llama.cpp-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/suryavs2011/llama.cpp-android
- Repository: https://github.com/suryavs2011/llama.cpp-android

## Overview

This is an Android terminal for running the official llama.cpp command-line tools locally on ARM64 devices. The main workflow is: the user enters a command, the app validates and launches a native process, then displays its output and live status; interactive chat reuses the process for typed replies. The app also keeps long-running work alive with a foreground service and documents browser access to a locally started llama-server. The process wrapper is excerpted only in part, so the graph omits unshown internal call details.

Main entry points: [`app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt) (Terminal screen), [`app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt) (Command execution), [`app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt`](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt) (App theme), [`app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt`](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt) (Theme colors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Terminal UI"]
  node_activity["Terminal screen<br/>[MainActivity.kt]"]
  node_theme["App theme<br/>[Theme.kt]"]
  node_colors["Theme colors<br/>[Color.kt]"]
  node_permission["Storage access<br/>[MainActivity.kt]"]
end

subgraph group_runtime["Command Runtime"]
  node_command["Command execution<br/>[LlamaCppCpu.kt]"]
  node_interactive["Interactive session<br/>[LlamaCppCpu.kt]"]
  node_process["Process status<br/>[LlamaCppCpu.kt]"]
  node_server["Server readiness<br/>[LlamaCppCpu.kt]"]
  node_service["Foreground service<br/>[LlamaCppService.kt]"]
end

subgraph group_native["Local Inference"]
  node_binaries["llama.cpp tools"]
end

node_user(("Device user"))
node_browser(("Device browser"))

node_user -->|"enters commands"| node_activity
node_activity -->|"requests access"| node_permission
node_activity -->|"applies theme"| node_theme
node_theme -->|"uses colors"| node_colors
node_activity -->|"executes command"| node_command
node_command -->|"launches binary"| node_binaries
node_command -->|"handles replies"| node_interactive
node_command -->|"starts service"| node_service
node_activity -->|"shows status"| node_process
node_command -->|"updates status"| node_process
node_command -->|"checks readiness"| node_server
node_activity -->|"opens server"| node_browser

click node_activity "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt"
click node_theme "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt"
click node_colors "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt"
click node_permission "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt"
click node_command "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt"
click node_interactive "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt"
click node_process "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt"
click node_server "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt"
click node_service "https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppService.kt"
click node_binaries "https://github.com/suryavs2011/llama.cpp-android/tree/main/app/src/main/jniLibs/arm64-v8a"

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_activity,node_theme,node_colors,node_permission,node_user,node_browser toneBlue
class node_command,node_interactive,node_process,node_server,node_service toneAmber
class node_binaries toneMint
```

## Components

### Terminal UI

- [Terminal screen](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt): `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`
- [App theme](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt): `app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt`
- [Theme colors](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt): `app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt`
- [Storage access](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt): `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`

### Command Runtime

- [Command execution](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt): `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`
- [Interactive session](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt): `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`
- [Process status](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt): `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`
- [Server readiness](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt): `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`
- [Foreground service](https://github.com/suryavs2011/llama.cpp-android/blob/main/app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppService.kt): `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppService.kt`

### Local Inference

- [llama.cpp tools](https://github.com/suryavs2011/llama.cpp-android/tree/main/app/src/main/jniLibs/arm64-v8a): `app/src/main/jniLibs/arm64-v8a`

### Other components

- **Device user**
- **Device browser**

## Connections

- Device user → Terminal screen: enters commands (evidence: `README.md`)
- Terminal screen → Storage access: requests access (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`)
- Terminal screen → App theme: applies theme (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`)
- App theme → Theme colors: uses colors (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt`)
- Terminal screen → Command execution: executes command (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`)
- Command execution → llama.cpp tools: launches binary (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`)
- Command execution → Interactive session: handles replies (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`)
- Command execution → Foreground service: starts service (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`)
- Terminal screen → Process status: shows status (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt`)
- Command execution → Process status: updates status (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`)
- Command execution → Server readiness: checks readiness (evidence: `app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt`)
- Terminal screen → Device browser: opens server (evidence: `README.md`)
