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 hashes)

Uploaded Source

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