Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jhubi1/ollama-app

A modern and easy-to-use client for Ollama
https://github.com/jhubi1/ollama-app

ai android app linux llama localai ollama ollama-client windows

Last synced: 28 days ago
JSON representation

A modern and easy-to-use client for Ollama

Awesome Lists containing this project

README 

        
# Ollama App



A modern and easy-to-use client for Ollama. Have the greatest experience while keeping everything private and in your local network.



| ![banner 1: home screen](assets/screenshots/flutter_24.png) | ![banner 2: model selector](assets/screenshots/flutter_15.png) | ![banner 3: sample message](assets/screenshots/flutter_18.png) | ![banner 4: opened sidebar](assets/screenshots/flutter_26.png) |

|-|-|-|-|



> [!IMPORTANT]

> This app does not host a Ollama server on device, but rather connects to one using its api endpoint.

> You don't know what Ollama is? Learn more at [ollama.com](https://ollama.com).



## Getting Started



Ollama App has a pretty simple and intuitive interface to be as open as possible. Everything just works out of the box, you just have to follow the next steps.



### Installation



You'll find the latest recommended version of the Ollama App under the [releases tab](https://github.com/JHubi1/ollama-app/releases). Download the correct executable onto your device and install it. If you want to install on a desktop platform, you might also have to follow the steps listed below, under [Ollama App for Desktop](#ollama-app-for-desktop).



Alternatively, you can also download the app from any of the following stores:



[](https://apt.izzysoft.de/fdroid/index/apk/com.freakurl.apps.ollama/)



That's it, you've successfully installed Ollama App! Now just proceed to [Initial Setup](https://github.com/JHubi1/ollama-app/wiki/Getting-Started#initial-setup) or alternatively [Setup](#setup) below.



### Ollama App for Desktop



> [!WARNING]

> This is still an experimental feature! Some functions may not work as intended. If you come across any errors, please create a new [issue report](https://github.com/JHubi1/ollama-app/issues/new/choose).



There are a few things you might have to keep in mind if you're planning to use the experimental desktop support.



#### Windows



The Windows version is provided in the form of an installer, you can find it attached on the [latest release](https://github.com/JHubi1/ollama-app/releases). It's not signed, you might have to dismiss the Windows Defender screen by pressing "View More" > "Run Anyway".



Windows app data is kept at: `C:\Users\[user]\AppData\Roaming\JHubi1\Ollama App`



#### Linux



The Linux version is provided in the form of a portable executable, you can find it attached on the [latest release](https://github.com/JHubi1/ollama-app/releases). To start it, execute `./ollama` in the extracted folder.



If a message like `error while loading shared libraries: libgtk-3.so.0: cannot open shared object file` appears when you start the app, run the following commands:



- `sudo apt-get update`

- `sudo apt-get upgrade`

- `sudo apt-get install packagekit-gtk3-module`



Linux app data is kept at: `/home/[user]/.local/share/ollama`



### Setup



The most difficult part is setting up the host. To learn more visit the [wiki guide on how to do so](https://github.com/JHubi1/ollama-app/wiki/Getting-Started#setting-up-the-host). After setting up, you normally don't have to enter it again.



And you're done! Just start chatting with your local AI and have fun!



> [!TIP]

> The new Voice Mode is now avaliable as an experimental feature. Learn more about it in [the documentation](https://github.com/JHubi1/ollama-app/wiki/Components#voice).



## Documentation



The documentation for components, settings, functions, etc. has moved to the [Wiki Page](https://github.com/JHubi1/ollama-app/wiki) of this repository. The steps there will be updated with future versions. Still having questions? Feel free to open an issue.



## Translations and Contribution



You want to help me make this project even better? Great, help is always appresheated.



Ollama App is created using [Flutter](https://flutter.dev), a modern and robust frontend framework designed to make a single codebase run on multiple target platforms. The framework itself is based on the [Dart](https://dart.dev) programming language.



Read more in the [Contribution Guide](https://github.com/JHubi1/ollama-app/wiki/Contributing).



## Star History



![Star History Chart](https://api.star-history.com/svg?repos=JHubi1/ollama-app&type=Timeline)