How suryavs2011/llama.cpp-android works
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: MainActivity.kt Terminal screen · LlamaCppCpu.kt Command execution · Theme.kt App theme · Color.kt Theme colors
Components 12
Terminal UI
- Terminal screen
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt - App theme
app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt - Theme colors
app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Color.kt - Storage access
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt
Command Runtime
- Command execution
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Interactive session
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Process status
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Server readiness
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Foreground service
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppService.kt
Local Inference
- llama.cpp tools
app/src/main/jniLibs/arm64-v8a
Other components
- Device user
- Device browser
Connections 12
- Device user → Terminal screen: enters commands
README.md - Terminal screen → Storage access: requests access
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt - Terminal screen → App theme: applies theme
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt - App theme → Theme colors: uses colors
app/src/main/java/com/saykarsd/llamacppandroid/ui/theme/Theme.kt - Terminal screen → Command execution: executes command
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt - Command execution → llama.cpp tools: launches binary
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Command execution → Interactive session: handles replies
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Command execution → Foreground service: starts service
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Terminal screen → Process status: shows status
app/src/main/java/com/saykarsd/llamacppandroid/MainActivity.kt - Command execution → Process status: updates status
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Command execution → Server readiness: checks readiness
app/src/main/java/com/saykarsd/llamacppandroid/LlamaCppCpu.kt - Terminal screen → Device browser: opens server
README.md