Skip to content

Commit 999c246

Browse files
I-I-ITdngray
authored andcommitted
update!: Add Edge Gallery and PocketPal AI (#3083)
1 parent cb2ea5e commit 999c246

File tree

3 files changed

+69
-10
lines changed

3 files changed

+69
-10
lines changed

docs/ai-chat.md

Lines changed: 69 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ Alternatively, you can run AI models locally so that your data never leaves your
2525

2626
### Hardware for Local AI Models
2727

28-
Local models are also fairly accessible. It's possible to run smaller models at lower speeds on as little as 8 GB of RAM. Using more powerful hardware such as a dedicated GPU with sufficient VRAM or a modern system with fast LPDDR5X memory offers the best experience.
28+
Local models are also fairly accessible. They can run on most PCs and some high-end smartphones. It's possible to run smaller models at lower speeds on as little as 8 GB of RAM. Using more powerful hardware such as a dedicated GPU with sufficient VRAM or a modern system with fast LPDDR5X memory offers the best experience.
2929

30-
LLMs can usually be differentiated by the number of parameters, which can vary between 1.3B to 405B for open-source models available for end users. For example, models below 6.7B parameters are only good for basic tasks like text summaries, while models between 7B and 13B are a great compromise between quality and speed. Models with advanced reasoning capabilities are generally around 70B.
30+
LLMs can usually be differentiated by the number of parameters, which can vary between 1.3B to 405B for open-source models available for end users. For example, models below 3B parameters are only reliably good for simple lingustic tasks such as summarization, models above 4B start understanding context and have a good knowledge of the world. From 8B, they can exercise basic reasoning. Models with advanced reasoning capabilities start at around 30B parameters.
3131

3232
For consumer-grade hardware, it is generally recommended to use [quantized models](https://huggingface.co/docs/optimum/en/concept_guides/quantization) for the best balance between model quality and performance. Check out the table below for more precise information about the typical requirements for different sizes of quantized models.
3333

@@ -45,16 +45,75 @@ There are many permissively licensed models available to download. [Hugging Face
4545

4646
To help you choose a model that fits your needs, you can look at leaderboards and benchmarks. The most widely-used leaderboard is the community-driven [LM Arena](https://lmarena.ai). Additionally, the [OpenLLM Leaderboard](https://huggingface.co/spaces/open-llm-leaderboard/open_llm_leaderboard) focuses on the performance of open-weights models on common benchmarks like [MMLU-Pro](https://arxiv.org/abs/2406.01574). There are also specialized benchmarks which measure factors like [emotional intelligence](https://eqbench.com), ["uncensored general intelligence"](https://huggingface.co/spaces/DontPlanToEnd/UGI-Leaderboard), and [many others](https://nebuly.com/blog/llm-leaderboards).
4747

48+
#### Recommended models
49+
50+
Below is a table of good models to start with.
51+
52+
|Developer|Model name| Available sizes| Strengths | Weaknesses | Censorship |
53+
|---|---|---|---|---|---|
54+
|Google| Gemma 3|1, 4, 12, 27| Multimodal, efficient| Many hallucinations | Sexuality, Drugs |
55+
|Google| Gemma 3n| >2, >4| Vision capabilities, efficient, mobile-friendly | Many hallucinations | Sexuality, Drugs |
56+
|Alibaba| Qwen 3|0.7, 1.7, 4, 8, 14, 32, 235|Multilingual, efficient, intelligent|Not multimodal| CCP-sensitive topics|
57+
4858
## AI Chat Clients
4959

50-
| Feature | [Kobold.cpp](#koboldcpp) | [Ollama](#ollama-cli) | [Llamafile](#llamafile) |
51-
|---|---|---|---|
52-
| GPU Support | :material-check:{ .pg-green } | :material-check:{ .pg-green } | :material-check:{ .pg-green } |
53-
| Image Generation | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-close:{ .pg-red } |
54-
| Speech Recognition | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-close:{ .pg-red } |
55-
| Auto-download Models | :material-close:{ .pg-red } | :material-check:{ .pg-green } | :material-alert-outline:{ .pg-orange } Few models available |
56-
| Custom Parameters | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-check:{ .pg-green } |
57-
| Multi-platform | :material-check:{ .pg-green } | :material-check:{ .pg-green } | :material-alert-outline:{ .pg-orange } Size limitations on Windows |
60+
| Feature | [Kobold.cpp](#koboldcpp) | [Ollama](#ollama-cli) | [Llamafile](#llamafile) | [Edge Gallery](#edge-gallery-android)| [PocketPal](#pocketpal-ai-mobile)|
61+
|---|---|---|---|---|---|
62+
| GPU Support | :material-check:{ .pg-green } | :material-check:{ .pg-green } | :material-check:{ .pg-green } | / | / |
63+
| Image Generation | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-close:{ .pg-red } | :material-close:{. pg-red } | :material-close:{. pg-red } |
64+
| Vision capabilities | :material-check:{ .pg-green } | :material-check:{ .pg-green }: | :material-check:{ .pg-green }: | :material-check:{ .pg-green }: | :material-alert-outline:{ .pg-orange } Limited quality
65+
| Speech-to-text | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-close:{ .pg-red } | :material-close:{ .pg-red } | :material-close:{ .pg-red } |
66+
| Auto-download Models | :material-close:{ .pg-red } | :material-check:{ .pg-green } |:material-alert-outline:{ .pg-orange } Few models available | :material-alert-outline:{ .pg-orange } Few models available | :material-check:{ .pg-green } |
67+
| Custom Parameters | :material-check:{ .pg-green } | :material-close:{ .pg-red } | :material-check:{ .pg-green } | :material-alert-outline:{ .pg-orange } Model prompt cannot be changed | :material-check:{ .pg-green }|
68+
| Platform | [:simple-linux: Linux] [:fontawesome-brands-windows: Windows][:simple-apple: macOS][:simple-macos:]|[:simple-gnometerminal All CLI] [:simple-linux: Linux] [:fontawesome-brands-windows: Windows][:simple-apple:][:simple-macos:] | [:simple-linux: Linux][:fontawesome-brands-windows: Windows] (Size limitations) [:simple-apple:][:simple-macos:] | [:simple-android: Android] | [:simple-android: Android] [:simple-apple:][:simple-ios:] |
69+
70+
## Edge Gallery (Android)
71+
72+
<div class="admonition recommendation" markdown>
73+
74+
![Edge Gallery Logo](edge_gallery_logo_white.png){align=right}
75+
76+
**Edge Gallery** is an AI client developped by Google that features Google's latest open-weights models. It runs fully locally, but downloading the preloaded models require a Hugging Face account as you will need to [accept Google's Acceptable Use policy](https://github.com/google-ai-edge/gallery/wiki/5.-Model-Management#hugging-face-login--license-acknowledgement) to access the model files. You can import models you downloaded, but the app only accepts the [LiteRT](https://github.com/google-ai-edge/litert) format, which isn't widely used.
77+
78+
The preloaded models are performant and can analyse an image. However, you might not be able to have long conversation or analyse long documents, as the app restricts the maximum context length to an ammount [multiple times smaller](https://github.com/google-ai-edge/gallery/issues/183) than what the AI model can normally support.
79+
80+
[:octicons-repo-16: Repository](https://github.com/google-ai-edge/gallery?tab=readme-ov-file#google-ai-edge-gallery-){ .md-button .md-button--primary }
81+
[:octicons-info-16:](https://github.com/google-ai-edge/gallery/wiki){ .card-link title="Documentation" }
82+
[:octicons-code-16:](https://github.com/google-ai-edge/gallery){ .card-link title="Source Code" }
83+
84+
<details class="downloads" markdown>
85+
<summary>Downloads</summary>
86+
87+
[:-simple-github: GitHub](https://github.com/google-ai-edge/gallery/releases)
88+
[:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=com.google.ai.edge.gallery)
89+
90+
</details>
91+
</div>
92+
93+
## PocketPal AI (Mobile)
94+
95+
<div class="admonition recommendation" markdown>
96+
97+
![PocketPal Logo](pocketpal_dark.png){align=right}
98+
99+
**PocketPal** is an AI client available on both iOS and Android. It focus on customisability, ease-of use, and above all on small language models (SLMs), allowing you to run AI models on basically any Android phone. Keep in mind however that SLMs aren't useful in many domains.
100+
101+
Other models can easily be imported, either from a Hugging Face repo link, of from a gguf file directly. Models can also be customised, and the client also offers "Pals", which are describe as "personalized AI assistants with different personalities: but are essentially presets of a model and a system prompt. You can chose between an assitant pal and a roleplay Pal.
102+
103+
[:octicons-repo-16: Repository](https://github.com/a-ghorbani/pocketpal-ai?tab=readme-ov-file#pocketpal-ai-){ .md-button .md-button--primary }
104+
[:octicons-info-16:](https://github.com/a-ghorbani/pocketpal-ai?tab=readme-ov-file#table-of-contents){ .card-link title="Documentation" }
105+
[:octicons-code-16:](https://github.com/a-ghorbani/pocketpal-ai/){ .card-link title="Source Code" }
106+
107+
<details class="downloads" markdown>
108+
<summary>Downloads</summary>
109+
110+
[:simple-github: GitHub](https://github.com/a-ghorbani/pocketpal-ai/releases)
111+
[:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=com.pocketpalai)
112+
[:simple-appstore: App Store](https://apps.apple.com/us/app/pocketpal-ai/id6502579498)
113+
114+
</details>
115+
116+
</div>
58117

59118
### Kobold.cpp
60119

1.56 KB
Loading
110 KB
Loading

0 commit comments

Comments
 (0)