Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
chyok authored Jul 12, 2024
1 parent fa22ba0 commit f61ae1d
Showing 1 changed file with 29 additions and 13 deletions.
42 changes: 29 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand Down

0 comments on commit f61ae1d

Please sign in to comment.