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.

v1.2.2

  • 💾 Save and Load Conversation History.

📎 Before Start

We need to set up Ollama 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.2.tar.gz (10.5 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: ollama_gui-1.2.2.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for ollama_gui-1.2.2.tar.gz
Algorithm Hash digest
SHA256 4fc1b9f16efc4ed1d41feeb0ad472a3ac114d11d5d411ef3fe09b23a0a66b915
MD5 f7177358123963581af7c9f72309f076
BLAKE2b-256 800d14b25b1682047319b37363e4dd4454c323b79760b02c8fbb5b7403ad4a00

See more details on using hashes here.

Supported by

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