Awesome
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 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.