# techjarves/mobile-server architecture

> Architecture diagram of the GitHub repository techjarves/mobile-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/techjarves/mobile-server
- Repository: https://github.com/techjarves/mobile-server

## Overview

Mobile Server turns an Android phone into an OpenAI-compatible local inference server. The user selects or imports a model, starts the foreground server, and can optionally expose it through Ngrok or Cloudflare so compatible clients can send requests. Model management, downloads, runtime initialization, server hosting, tunnel selection, and background keep-alive are distinct stages. The README documents the API and privacy/tunneling goals; sampled service and model-management excerpts show portions of the implementation, but the server’s request-handling internals were not sampled.

Main entry points: [`Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt) (Foreground service), [`Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt`](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt) (Model manager), [`Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt`](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt) (Server controls), [`Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt`](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt) (Model downloads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_models["Model lifecycle"]
  node_manager_ui["Model manager UI"]
  node_model_manager["Model manager"]
  node_download_repo["Model downloads"]
  node_download_worker["Download worker<br/>[DownloadWorker.kt]"]
  node_model_runtime["On-device runtime<br/>[LlmModelHelper.kt]"]
  node_keepalive["Model keep-alive"]
end

subgraph group_hosting["Server hosting"]
  node_server_ui["Server controls"]
  node_server_service["Foreground service"]
  node_api_server["OpenAI API server<br/>[OpenAiServer.kt]"]
  node_server_state["Server state"]
end

subgraph group_tunnels["Public access"]
  node_ngrok["Ngrok tunnel<br/>[NgrokTunnel.kt]"]
  node_cloudflare["Cloudflare tunnel"]
end

subgraph group_storage["App state"]
  node_datastore[("Preferences store")]
end

node_user(("Phone user"))
node_client(("API client"))

node_user -->|"selects model"| node_manager_ui
node_manager_ui -->|"manages models"| node_model_manager
node_model_manager -->|"requests downloads"| node_download_repo
node_download_repo -->|"enqueues work"| node_download_worker
node_model_manager -.->|"initializes models"| node_model_runtime
node_model_manager -->|"starts service"| node_keepalive
node_user -->|"starts server"| node_server_ui
node_server_ui -->|"starts service"| node_server_service
node_server_service -->|"starts server"| node_api_server
node_server_service -->|"obtains model manager"| node_model_manager
node_server_service -->|"updates status"| node_server_state
node_client -->|"sends API requests"| node_api_server
node_server_ui -.->|"selects provider"| node_ngrok
node_server_ui -.->|"selects provider"| node_cloudflare
node_server_service -->|"starts tunnel"| node_ngrok
node_server_service -->|"starts tunnel"| node_cloudflare
node_server_ui -.->|"reads public URL"| node_server_state
node_model_manager -->|"loads settings"| node_datastore

click node_manager_ui "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt"
click node_model_manager "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt"
click node_download_repo "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt"
click node_download_worker "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/worker/DownloadWorker.kt"
click node_model_runtime "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/runtime/LlmModelHelper.kt"
click node_keepalive "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/worker/ModelKeepAliveService.kt"
click node_server_ui "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt"
click node_server_service "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt"
click node_api_server "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServer.kt"
click node_server_state "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerState.kt"
click node_ngrok "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/NgrokTunnel.kt"
click node_cloudflare "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/CloudflareTunnel.kt"
click node_datastore "https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/data/DataStoreRepository.kt"

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_manager_ui,node_model_manager,node_download_repo,node_download_worker,node_model_runtime,node_keepalive,node_user,node_client toneBlue
class node_server_ui,node_server_service,node_api_server,node_server_state toneAmber
class node_ngrok,node_cloudflare toneMint
class node_datastore toneRose
```

## Components

### Model lifecycle

- [Model manager UI](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt): `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt`
- [Model manager](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt): `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt`
- [Model downloads](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt): `Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt`
- [Download worker](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/worker/DownloadWorker.kt): `Android/src/app/src/main/java/com/server/edge/gallery/worker/DownloadWorker.kt`
- [On-device runtime](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/runtime/LlmModelHelper.kt): `Android/src/app/src/main/java/com/server/edge/gallery/runtime/LlmModelHelper.kt`
- [Model keep-alive](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/worker/ModelKeepAliveService.kt): `Android/src/app/src/main/java/com/server/edge/gallery/worker/ModelKeepAliveService.kt`

### Server hosting

- [Server controls](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt): `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt`
- [Foreground service](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt): `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`
- [OpenAI API server](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServer.kt): `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServer.kt`
- [Server state](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerState.kt): `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerState.kt`

### Public access

- [Ngrok tunnel](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/NgrokTunnel.kt): `Android/src/app/src/main/java/com/server/edge/gallery/openai/NgrokTunnel.kt`
- [Cloudflare tunnel](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/openai/CloudflareTunnel.kt): `Android/src/app/src/main/java/com/server/edge/gallery/openai/CloudflareTunnel.kt`

### App state

- [Preferences store](https://github.com/techjarves/mobile-server/blob/main/Android/src/app/src/main/java/com/server/edge/gallery/data/DataStoreRepository.kt): `Android/src/app/src/main/java/com/server/edge/gallery/data/DataStoreRepository.kt`

### Other components

- **Phone user**
- **API client**

## Connections

- Phone user → Model manager UI: selects model (evidence: `README.md`)
- Model manager UI → Model manager: manages models (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt`)
- Model manager → Model downloads: requests downloads (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt`)
- Model downloads → Download worker: enqueues work (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/data/DownloadRepository.kt`)
- Model manager → On-device runtime: initializes models
- Model manager → Model keep-alive: starts service (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt`)
- Phone user → Server controls: starts server (evidence: `README.md`)
- Server controls → Foreground service: starts service (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/GlobalModelManager.kt`)
- Foreground service → OpenAI API server: starts server (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`)
- Foreground service → Model manager: obtains model manager (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`)
- Foreground service → Server state: updates status (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`)
- API client → OpenAI API server: sends API requests (evidence: `README.md`)
- Server controls → Ngrok tunnel: selects provider
- Server controls → Cloudflare tunnel: selects provider
- Foreground service → Ngrok tunnel: starts tunnel (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`)
- Foreground service → Cloudflare tunnel: starts tunnel (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/openai/OpenAiServerService.kt`)
- Server controls → Server state: reads public URL
- Model manager → Preferences store: loads settings (evidence: `Android/src/app/src/main/java/com/server/edge/gallery/ui/modelmanager/ModelManagerViewModel.kt`)
