Skip to main content

A very simple ollama GUI, implemented using the built-in Python Tkinter library, with no additional dependencies.

Project description

Ollama-GUI

GitHub License PyPI - Version PyPI - Python Version

A very simple ollama GUI, implemented using the built-in Python Tkinter library, with no additional dependencies. Provide you with the simplest possible visual Ollama interface.

ollama-gui-1 2 0

🚀 Features

v1.1.0

  • 📁 One file project.
  • 📦 No external dependencies, only tkinter which is usually bundled.
  • 🔍 Auto check ollama model list.
  • 🌐 Customizable ollama host support.
  • 💬 Multiple conversations.
  • 📋 Menu bar and right-click menu.
  • 🛑 Stop generating at any time.

v1.2.0

  • 🗂️ Model Management: Download and Delete Models.
  • 🎨 UI Enhancement: Bubble dialog theme.
  • 📝 Editable Conversation History.

📎 Before Start

We need to set up llama service first.

Please refer to:

⚙️ Run

Choose any way you like:

Note: If you are using a Mac and the system version is Sonoma, please refer to the Q&A at the bottom.

source code

python ollama_gui.py

using pip

pip install ollama-gui
ollama-gui

binary file

Platform Download Link
Windows Download
Mac (Apple Silicon) Download
Linux Download

📋 Q&A

I'm using a Mac, why does the application sometimes not respond when I click on it?

The issue affects macOS Sonoma users running applications that use Tcl/Tk versions 8.6.12 or older, including various Python versions.
When the mouse cursor is inside the Tkinter window during startup, GUI elements become unresponsive to clicks.

Solution:
Update to Tcl/Tk version 8.6.13 or newer, which fixes this problem.

For Python users, this can be done by:
Using Python 3.11.7 or later, which bundles the fixed Tcl/Tk version.
Using Python 3.12 or later, which already includes the fix.
https://www.python.org/downloads/macos/

For other Python versions, installing Tcl/Tk 8.6.13+ separately (e.g., via Homebrew) and ensuring Python uses this version.

Here is the issue: https://github.com/python/cpython/issues/110218

ImportError: No module named 'Tkinter'

This probably happens because the Tk library is not installed.

For Ubuntu or other distros with Apt:

sudo apt-get install python3-tk

For Fedora:

sudo dnf install python3-tkinter

For macOS:

brew install python-tk

For Windows:

make sure to check in the Python install the optional feature "tcl/tk and IDLE".

Refer to: https://stackoverflow.com/questions/25905540/importerror-no-module-named-tkinter

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ollama_gui-1.2.1.tar.gz (10.2 kB view details)

Uploaded Source

File details

Details for the file ollama_gui-1.2.1.tar.gz.

File metadata

  • Download URL: ollama_gui-1.2.1.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for ollama_gui-1.2.1.tar.gz
Algorithm Hash digest
SHA256 51eff33ded71a0e933887bea616404b4c24b911d42ea5453d0cd14890332813d
MD5 1a687184d034d94cedd80b83dc3d8ad8
BLAKE2b-256 89bc429a2de2833fe866e0b63ef0d87f75c36fd9118eb1f5301938235e66d7ba

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page