Repository navigation
Releases
Kai 0.3.0
Kai 0.3.0 brings Kai into Firefox: with the new Kai for Firefox extension, Kai reads and operates the pages open in Firefox, and Firefox's sidebar runs lmgw's Chat through Kai. It needs lmgw 0.6.0.
- Kai for Firefox. The RPM ships
kai-browser-host, the native- messaging host the extension talks to, and registers it with Firefox. The extension itself is released on its own and signed by Mozilla: https://github.com/lmgw-dev/kai-firefox. Kai takes the link only from a Firefox that Plasma started; Firefox's app scopes in the settings lists the units it accepts. - Browser tools. While a Firefox is linked, Kai's tools gain the browser's: tabs, reading (outline, controls, text, tables, PDFs in Firefox's viewer), screenshots for a vision model, pressing, filling and choosing, numbered hints over the controls in view, Firefox's zoom, Reader view, bookmarks, history and downloads, and tools for developers. A PDF's text comes from poppler's
pdftotext, run in a bubblewrap sandbox. The tools leave the list when the last Firefox quits. - Site rules and asking first. Each site is
act,readornone, set by host, domain or origin. Reading runs for you, acting asks first. Kai may act in Firefox without asking (the hands-and-eyes switch) lets Kai act unasked, but only on the tab you brought to the front, on the site where you last acted. Ask before committing still asks before a buy, send or delete, a form that goes to another site or a site your history has never seen. For Kai's own calls, Kai also asks out loud, and the talk key answers with a spoken yes or no. - The rules reach the desktop tools. Looking at or reading a Firefox window on a
nonesite is refused, a screenshot blanks such windows grey, and typing into areadornonepage is refused. - Firefox's own pages and dialogs. Where the desktop's accessibility is on, Kai reads and presses a page's dialogs, a site's permission prompts, the notification bars and Firefox's own pages around the tab in front. It never reads
about:logins, the password manager or a password field, and never presses in Firefox's settings or an add-on's prompt. - Announcements and reading aloud. Kai can say on its own that a page loaded, a dialog opened or a field shows an error, without a model turn, and read a page aloud paragraph by paragraph with pause, resume and skip. This speech comes from lmgw in Kai's own voice, waits for a quiet moment, and stops when you talk or press the talk key. Announcements have their own switch; turning hands and eyes on from the settings window turns them on too, and you can turn them off.
- The sidebar is Kai. Kai relays only the Chat's own requests from the sidebar to lmgw, with its device certificate, and tells the sidebar each site's rule.
- Admin level warning. While a Firefox is linked and Kai's lmgw admin level is read only or full, Kai warns once, and again when the level is raised: a page's text could steer a model to lmgw's configuration.
- Install it from the settings. The new Firefox section counts the connected Firefox profiles and has Install Kai for Firefox; a build without the install link says how to install it by hand.
- Settings in plain words. Every setting has a label, a help line, a section, a unit and a fitting control, with Advanced folded away and the key only in a tooltip. Switches are checkboxes, Reset shows only off the default, audio devices and screens are picked from lists, and a footer lists what waits for a restart, with Restart Kai now.
- Conversation. Choose Shared with your other Kai apps or Only on this computer; the own name starts as "Kai ", and nothing changes until Use this conversation. Listening goes on in the new conversation.
- When pairing, Kai gives lmgw this computer's name for the Devices card.
Upgrading: Kai 0.3.0 needs lmgw 0.6.0; it is built and tested against that release. The RPM now also requires poppler-utils and mozilla-filesystem and recommends bubblewrap. Requirements are otherwise as for 0.2.0: KDE Plasma 6 on Wayland, PipeWire, KWallet, and lmgw with its device listener on. Install the RPM from this release, or let Kai's update check offer it. For the browser, install Kai for Firefox 0.1.0 (Firefox 154 or newer).
Kai 0.2.0
Kai moves to lmgw's device link: a key of its own, mutual TLS and no bearer. It needs lmgw 0.5.0 or later.
- Pairing over the device link. A pairing link now carries https URLs, lmgw's fingerprint and a one-time token. Kai makes its own key, enrols it over a connection pinned to that fingerprint, keeps the key in KWallet and connects with a certificate. Kai shows a code, lmgw's Devices card shows the same one, and you click Confirm there. Pasting or clicking the same link again after a failure enrols the same key.
- One link for everything. The feed, voice sessions, the tool link and the window's requests all use the same mutually authenticated client. Kai tries the link's URLs and then follows the address that answered. It takes the URL list and the dashboard address lmgw reports (Open in lmgw uses it), and the tooltip says when the certificate is due.
- Refusals in plain words. Kai says whether it waits for your Confirm, the certificate has lapsed or it must pair again. A stray TLS alert from another host on the address never makes Kai drop its pairing.
- Approvals follow the feed. The approval card shows calls that waited before Kai started, and a call you already decided does not come back.
- "Always allow" in a tool's confirmation sets that tool to allow for trusted callers.
- The tray's update check always shows its answer; new app and tray icons.
- Kai mobile, the Android client, is released alongside: https://github.com/lmgw-dev/kai-mobile
- MIT licence. Kai was FSL-1.1-MIT.
Upgrading: a pairing from Kai 0.1.0 used a bearer key, which lmgw 0.5.0 no longer accepts. Kai tells you to pair again; do it from the Devices card in lmgw, confirm the code, and Kai removes the old key from KWallet. Requirements are otherwise as for 0.1.0: KDE Plasma 6 on Wayland, PipeWire, KWallet, and lmgw 0.5.0 or later with its device listener on. Install the RPM from this release, or let Kai's update check offer it.
Kai 0.1.0
Kai's first public release: a voice assistant for the KDE Plasma desktop that runs on the models of your own lmgw gateway.
- Talk from anywhere. A global talk key (tap, or hold for push-to-talk) starts listening in any app; Kai answers out loud, and you can talk over it to interrupt. Everything goes into one ongoing conversation in lmgw's Chat, which you can read and continue in the dashboard. Conversation mode keeps listening for longer exchanges, and the tray switches personality profiles.
- See what Kai is doing. The tray icon shows idle, listening, thinking, speaking or muted; the ring over the desktop moves with the voice.
- Desktop tools over MCP. Windows (list, focus, tile, move, close), screenshots and window text for a vision model, the selection, clipboard and files, opening files and apps, running commands, typing and keys, notifications, do not disturb, Night Light, media and volume.
lookandfindhand a question to a second model; long tasks run as background jobs; routines are your own scripted tools. - You stay in control. Every tool has a policy (allow, allow if trusted, confirm, deny, off) and a caller level. The approval card shows what a call would do and takes Enter, Esc or a spoken yes or no. Nothing runs while the screen is locked.
- Overlays and MCP Apps. The model can show text, a sandboxed HTML card, an image, an emote or a weather card over the desktop, and a tool's own MCP Apps view.
- A settings window for tools, desktop permissions, every setting and personality profiles.
Requirements: KDE Plasma 6 on Wayland (Fedora; the RPM is built on the current release), PipeWire, and lmgw 0.4.3 or later with a paired device key. Install the RPM from this release; Kai checks GitHub for updates and installs only an RPM whose sha256 matches the release's.
Licence: FSL-1.1-MIT, as lmgw.