diff --git a/README.md b/README.md index 3505585..f0550f3 100644 --- a/README.md +++ b/README.md @@ -7,25 +7,36 @@ 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-0-3](https://github.com/chyok/ollama-gui/assets/32629225/4a733a19-3201-4440-b6d5-eddd62294a0b) +![ollama-gui-1-1-0](https://github.com/user-attachments/assets/d70925e7-bc25-40f8-b1e0-6dca152a4e23) -+ one file project. -+ no external dependencies. +## πŸš€ Features -## Before Start ++ 🎨 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. + +## πŸ“ŽBefore Start We need to set up llama service first. -Please refer to: [Ollama](https://ollama.com/) +Please refer to: ++ [Ollama](https://ollama.com/) ++ [Ollama Github](https://github.com/ollama/ollama) -## Run +## βš™οΈ 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` +``` +python ollama_gui.py +``` ### using pip @@ -39,20 +50,25 @@ ollama-gui | Platform | Download Link | |----------|----------------------------------------------------------| | Windows | [Download](https://github.com/chyok/ollama-gui/releases) | +| Mac (Apple Silicon) | [Download](https://github.com/chyok/ollama-gui/releases) | -## QA +## πŸ“‹ 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. +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: +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/ -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. 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 +Here is the issue: https://github.com/python/cpython/issues/110218 ## License