A very simple ollama GUI, implemented using the built-in Python Tkinter library, with no additional dependencies.
Project description
Ollama-GUI
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.
🚀 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.