{"id":26909703,"url":"https://github.com/icarito/gtk-llm-chat","last_synced_at":"2026-04-16T22:01:11.041Z","repository":{"id":278647077,"uuid":"936317310","full_name":"icarito/gtk-llm-chat","owner":"icarito","description":"A GTK graphical interface for chatting with large language models (LLMs)","archived":false,"fork":false,"pushed_at":"2025-09-04T15:59:36.000Z","size":2030,"stargazers_count":80,"open_issues_count":15,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-18T11:27:42.721Z","etag":null,"topics":["ai","chat","chatbot","gemini","gtk","ia","llm","openai"],"latest_commit_sha":null,"homepage":"https://gtk-llm-chat.fuentelibre.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/icarito.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"icarito","patreon":"icarito","buy_me_a_coffee":"icarito"}},"created_at":"2025-02-20T22:09:39.000Z","updated_at":"2025-06-09T15:53:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"5c0e3d09-f886-434e-89c0-ccdd7acd2214","html_url":"https://github.com/icarito/gtk-llm-chat","commit_stats":null,"previous_names":["icarito/gtk_llm_chat","icarito/gtk-llm-chat"],"tags_count":122,"template":false,"template_full_name":null,"purl":"pkg:github/icarito/gtk-llm-chat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icarito%2Fgtk-llm-chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icarito%2Fgtk-llm-chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icarito%2Fgtk-llm-chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icarito%2Fgtk-llm-chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/icarito","download_url":"https://codeload.github.com/icarito/gtk-llm-chat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icarito%2Fgtk-llm-chat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31905895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chat","chatbot","gemini","gtk","ia","llm","openai"],"created_at":"2025-04-01T13:19:47.959Z","updated_at":"2026-04-16T22:01:11.036Z","avatar_url":"https://github.com/icarito.png","language":"Python","funding_links":["https://github.com/sponsors/icarito","https://patreon.com/icarito","https://buymeacoffee.com/icarito"],"categories":[],"sub_categories":[],"readme":"# GTK LLM Chat\n\nA GTK graphical interface for chatting with Large Language Models (LLMs).\n\n![screenshot](./docs/screenshot01.png)\n\n\n## Key Features\n\n- Simple and easy-to-use graphical interface built with GTK\n- Support for multiple conversations in independent windows\n- Integration with python-llm for chatting with various LLM models\n- Modern interface using libadwaita\n- Support for real-time streaming responses\n- Message history with automatic scrolling\n- Windows installer, Linux AppImage, and Macos bundles available!\n- Markdown rendering of the responses\n\n- **Sidebar Navigation:** Modern sidebar for model/provider selection, parameters, and settings.\n- **Model Parameters:** Adjust temperature and system prompt per conversation.\n- **API Key Management:** Banner with symbolic icons for setting/changing API keys per provider.\n- **Keyboard Shortcuts:**\n    - `F10`: Toggle sidebar\n    - `F2`: Rename conversation\n    - `Escape`: Minimize window\n    - `Enter`: Send message\n    - `Shift+Enter`: New line in input\n    - `Ctrl+W`: Delete the current conversation\n    - `Ctrl+M`: Open model selector\n    - `Ctrl+S`: Edit system prompt\n    - `Ctrl+N`: New conversation window\n- **Conversation Management:** Rename and delete conversations.\n- **Tray Applet:** Use a system tray applet for quick access to recent conversations.\n- **Error Handling:** Clear error messages displayed in the chat.\n- **Dynamic Input:** The input area dynamically adjusts its height.\n\n**Gtk-LLM-Chat** is a graphical frontend for the command-line llm utility. Just as `llm` integrates large language models into the [command line interface](https://llm.datasette.io/en/stable/usage.html), Gtk-LLM-Chat aims to bring that same power to the desktop environment. Its goal is to provide intuitive affordances and seamless integration for using LLMs in everyday tasks — all while remaining convenient, lightweight, and transparent in its behavior.\n\n## Installation\n\n### Downloadable application bundles\n\nWhile the command line is fun in every operating system, **Gtk-LLM-Chat** also offers prepackaged binary application bundles for all three major operating sytems: Windows installers, Linux Appimages and Macos Application Bundles are available in our [_releases_](https://github.com/icarito/gtk-llm-chat/releases) section.\n\nAn effort has been made to support desktop integration across systems but _your mileage may vary_ - as the Gtk tools are still maturing outside of the GNU/Linux ecosystem.\n\n### As an `llm` plugin\n\nPlaying with LLMs in the command line is fun! I recommend you to install `llm` and play around with it to size up the possibilities. Gtk-LLM-Chat can be installed as a plugin extension for `llm` itself, thus extending the possibilities of `llm` with some graphical features. Not all features of `llm` are exposed yet.\n\n```\npipx install llm               # required by gtk-llm-chat\nllm install gtk-llm-chat\n```\n\nYou may want to copy the provided .desktop files to your ~/.local/share/applications/ folder. A welcome assistant will do this in the future for you.\n\n\n### System Requirements\n\n- [llm](https://llm.datasette.io/en/stable/) (when installing as an llm plugin)\n- Python 3.8 or higher\n- GTK 4.0\n- libadwaita\n- libayatana-appindicator (on linux)\n\nThese dependency installation instructions are collected here for reference only:\n\n```\n # fedora: # sudo dnf install cairo-devel object-introspection-devel gtk4-devel pkgconf-pkg-config gcc redhat-rpm-config\n # debian: # sudo apt install libgtk-4-1 python3-gi python3-gi-cairo libadwaita-1-0 libayatana-appindicator3\n # arch: # sudo pacman -S python-gobject gtk4\n # windows (msys2): # pacman -S mingw-w64-$(uname -m)-gtk4 mingw-w64-$(uname -m)-python-pip mingw-w64-$(uname -m)-python3-gobject mingw-w64-$(uname -m)-libadwaita mingw-w64-x86_64-python3-pillow\n # macos (homebrew): # brew install pygobject3 gtk4 adwaita-icon-theme libadwaita\n```\n\n## Usage\n\n### Running the Application\n\nTo start the applet (system tray mode):\n```\nllm gtk-applet\n```\n\nTo start a single chat window:\n```\nllm gtk-chat\n```\n\n#### Optional arguments:\n```\nllm gtk-chat --cid CONVERSATION_ID   # Continue a specific conversation\nllm gtk-chat -s \"System prompt\"      # Set system prompt\nllm gtk-chat -m model_name           # Select specific model\nllm gtk-chat -c                      # Continue last conversation\n```\n\n## Development\n\nTo set up the development environment:\n```\ngit clone https://github.com/icarito/gtk-llm-chat.git\ncd gtk-llm-chat\npython -m venv venv\nsource venv/bin/activate\npip install -e .\n```\n\n## Shoulders of giants\n\nThis project is made possible thanks to these great components, among others:\n\n- [llm](https://llm.datasette.io/en/stable/) by @simonw\n- [hello-world-gtk](https://github.com/zevlee/hello-world-gtk) by @zevlee\n\n## License\n\nGPLv3 License - See LICENSE file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficarito%2Fgtk-llm-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficarito%2Fgtk-llm-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficarito%2Fgtk-llm-chat/lists"}