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

• Host: GitHub
• URL: https://github.com/JHubi1/ollama-app
• Owner: JHubi1
• License: apache-2.0
• Created: 2024-05-23T08:26:49.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-03-14T21:04:42.000Z (about 2 months ago)
• Last Synced: 2025-04-06T23:01:41.466Z (29 days ago)
• Topics: ai, android, app, linux, llama, localai, ollama, ollama-client, windows
• Language: Dart
• Homepage:
• Size: 11.9 MB
• Stars: 1,172
• Watchers: 10
• Forks: 113
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

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)