You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit bd2fb37
Browse filesBrowse the repository at this point in the historyBrowse files
<b>An open-source, on-device AI assistant for Android</b><br/>
11
+
Material 3 Expressive UI · multi-provider model routing · local RAG memory · PRoot Linux tool sandbox · a web UI you open from any browser on your Wi-Fi.
12
+
</p>
13
+
14
+
<br>
15
+
3
16
<picture>
4
17
<sourcemedia="(prefers-color-scheme: dark) and (max-width: 640px)"srcset="assets/readme/dark/hm-hero.svg">
<palign="center"><sub>More screenshots per release live in <ahref="docs/"><code>docs/</code></a>, including provider setup walkthroughs (<code>1.1.6_providers_use.gif</code>, <code>1.3.4_providers_use.gif</code>).</sub></p>
71
+
72
+
</div>
73
+
74
+
---
75
+
32
76
<h3id="overview"><picture><sourcemedia="(prefers-color-scheme: dark) and (max-width: 640px)"srcset="assets/readme/dark/hm-overview.svg"><sourcemedia="(prefers-color-scheme: dark)"srcset="assets/readme/dark/h-overview.svg"><sourcemedia="(max-width: 640px)"srcset="assets/readme/light/hm-overview.svg"><imgsrc="assets/readme/light/h-overview.svg"alt="Overview: Privacy-first on-device AI assistant with Linux sandbox & Material 3 Expressive"width="100%"></picture></h3>
33
77
34
78
**Local AI** is a state-of-the-art, open-source AI assistant application for Android engineered around **Google's Material 3 Expressive** design system.
@@ -51,6 +95,18 @@ All conversations, API keys, documents, vector embeddings, and tool executions r
51
95
<tr><td><b>License</b></td><td>GNU General Public License v3.0 (GPL-3.0)</td></tr>
52
96
</tbody></table>
53
97
98
+
#### 💡 What you can actually do with it
99
+
100
+
| I want to… | Local AI does it with… |
101
+
| :--- | :--- |
102
+
|**Chat with GPT / Claude / Gemini / DeepSeek / Ollama**| One assistant definition, per-assistant model choice, 62 provider presets in the bundled catalog, plus custom OpenAI-compatible endpoints |
103
+
|**Keep long-term context without cloud memory**| Local RAG memory: episodic chunks embedded by an embedding model you pick, stored on device, recalled by cosine similarity |
104
+
|**Ask a model to do tasks on my phone**| Built-in tools: `eval_javascript`, `text_to_speech`, `generate_image`, `send_notification`, `schedule_message`, `get_notifications`, `search_memory`, `manage_skills`, `ask_user`|
105
+
|**Run Python, a package manager or shell scripts**| The `:workspace` module installs a PRoot Linux rootfs and exposes `workspace_shell`, `workspace_read_file`, `workspace_write_file`, `workspace_edit_file` — no root required |
106
+
|**Use custom MCP servers**| Built-in Model Context Protocol (MCP) client with SSE and Streamable-HTTP transports |
107
+
|**Chat from laptop while phone does the work**| Embedded Ktor server + React Router SPA + JWT auth + SSE streaming, advertised over mDNS on the LAN |
108
+
|**Read PDF / Word / Images and ask questions**| MuPDF engine, DOCX→Markdown parser, OCR transformer, image/audio attachments, multimodal vision models |
109
+
54
110
<divalign="center">
55
111
56
112
<ahref="https://github.com/smartworldarafath/Local-AI/issues"><picture><sourcemedia="(prefers-color-scheme: dark)"srcset="assets/readme/dark/btn-issues.svg"><imgsrc="assets/readme/light/btn-issues.svg"alt="Report an issue"height="50"></picture></a>
@@ -73,6 +129,31 @@ All conversations, API keys, documents, vector embeddings, and tool executions r
73
129
74
130
</div>
75
131
132
+
<h3id="showcase"><picture><sourcemedia="(prefers-color-scheme: dark) and (max-width: 640px)"srcset="assets/readme/dark/hm-overview.svg"><sourcemedia="(prefers-color-scheme: dark)"srcset="assets/readme/dark/h-overview.svg"><sourcemedia="(max-width: 640px)"srcset="assets/readme/light/hm-overview.svg"><imgsrc="assets/readme/light/h-overview.svg"alt="App Showcase & Screenshots"width="100%"></picture></h3>
133
+
134
+
<divalign="center">
135
+
136
+
<table>
137
+
<tr>
138
+
<td align="center" width="33%">
139
+
<img src="docs/1.4.3_chat.jpg" alt="Chat with tools and reasoning" width="240" /><br/>
<sub>More walkthroughs and animated setup demos are in [`docs/`](docs), including <code>1.1.6_providers_use.gif</code> and <code>1.3.4_providers_use.gif</code>.</sub>
154
+
155
+
</div>
156
+
76
157
<h3id="hardware"><picture><sourcemedia="(prefers-color-scheme: dark) and (max-width: 640px)"srcset="assets/readme/dark/hm-hardware.svg"><sourcemedia="(prefers-color-scheme: dark)"srcset="assets/readme/dark/h-hardware.svg"><sourcemedia="(max-width: 640px)"srcset="assets/readme/light/hm-hardware.svg"><imgsrc="assets/readme/light/h-hardware.svg"alt="Hardware & Performance: Real-time CPU/GPU monitor, power limit sliders & 120Hz display timing"width="100%"></picture></h3>
77
158
78
159
Local AI includes an embedded low-overhead hardware telemetry engine and custom power-budget controls located under **Settings ➔ Advanced Settings**:
0 commit comments