https://github.com/chyok/ollama-gui
A single-file tkinter-based Ollama GUI project with no external dependencies.
https://github.com/chyok/ollama-gui
llm ollama ollama-app ollama-chat ollama-gui ollama-interface ollama-ui single-file tkinter tkinter-gui
Last synced: 2 days ago
JSON representation
A single-file tkinter-based Ollama GUI project with no external dependencies.
- Host: GitHub
- URL: https://github.com/chyok/ollama-gui
- Owner: chyok
- License: mit
- Created: 2024-06-29T15:45:30.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-21T13:50:21.000Z (about 2 months ago)
- Last Synced: 2025-05-16T15:02:49.683Z (2 days ago)
- Topics: llm, ollama, ollama-app, ollama-chat, ollama-gui, ollama-interface, ollama-ui, single-file, tkinter, tkinter-gui
- Language: Python
- Homepage: https://chyok.github.io/ollama-gui/
- Size: 46.9 KB
- Stars: 187
- Watchers: 7
- Forks: 31
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
+ [Ollama](https://ollama.com/)
+ [Ollama Github](https://github.com/ollama/ollama)
## ⚙️ 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](https://github.com/chyok/ollama-gui/releases) |
| Mac (Apple Silicon) | [Download](https://github.com/chyok/ollama-gui/releases) |
| Linux | [Download](https://github.com/chyok/ollama-gui/releases) |
## 📋 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](LICENSE).