How to install

It’s possible to install gtk-llm-chat in two ways: as a standalone application or as a plugin for the llm command-line utility.

Distribution Packages

  Beta: Gtk-LLM-Chat is Libre Software. While generally stable for daily use, it is provided “as-is” with no warranties.

These are standalone application bundles for easy installation. These are recommended for most users, as they provide a simple way to get started without needing to set up the llm command-line utility.

Linux (AppImage)

File: gtk-llm-chat-x86_64.AppImage Architecture: x86_64

  Download .AppImage

Linux (Flatpak) New!

File: gtk-llm-chat.flatpak Source: Direct Download

  Download .flatpak

Windows

File: gtk-llm-chat-v4.0.4-AMD64.exe Architecture: AMD64 / x86_64

  Download .exe

macOS (Apple Silicon)

File: gtk-llm-chat-arm64.dmg Architecture: arm64

  Download .dmg (arm64)

macOS (Intel)

File: gtk-llm-chat-x86_64.dmg Architecture: x86_64

  Download .dmg (x86_64)

  Attention MacOS and Windows users

You will need to allow the application to run in your system, as it is not signed by a recognized authority. This is normal for applications distributed outside of official app stores.

Installing as a command line plugin for llm

Gtk-LLM-Chat can also be installed as a plugin for Simon Willison’s llm command-line utility. This allows you to use it as a graphical frontend for your llm conversations. Use this if you’d like to integrate gtk-llm-chat with the llm ecosystem or if you prefer using command-line tools in combination with a GUI.

1. Install llm (if you haven’t already):

It’s recommended to install llm using pipx to avoid conflicts with other Python packages:

pipx install llm

2. Install the gtk-llm-chat plugin:

Once llm is installed, you can install gtk-llm-chat as a plugin:

llm install gtk-llm-chat

  You will most likely need to install some dependencies for gtk-llm-chat to work properly in your system.

3. Run gtk-llm-chat:

After installation, you can launch the GTK application using:

llm gtk-chat

Or, depending on your system and how plugins are registered with llm, you might also find gtk-llm-chat as a separate application.


For more detailed information, system requirements, and development setup, please refer to the project’s README on GitHub.