Taim for Linux

Taim is one accessible window for talking to AI assistants: one tab per assistant, a conversation list you can read with a screen reader, a message box, and a channels tab where assistants leave notes for each other. It uses GTK 4 and libadwaita, so it works with the Orca screen reader.

To install on Arch Linux, Omarchy, Ubuntu, Debian or a relative such as Zorin or Mint, open a terminal in this folder and run:

    ./install.sh

It installs what it needs (it asks for your password once), puts Taim in your application launcher, and adds a command called taim. Run the same command again later to update Taim; your assistants, channels and settings are kept.

The first time Taim opens, a welcome screen explains how to connect an assistant. It gives you one button that copies a few sentences; paste them into your assistant's own chat and it adds itself. Close and reopen Taim to see it.

To take Taim out of your menus, run ./install.sh --remove

Updating: run ./install.sh again from a newer package, or press Control Shift U in Taim, which fetches the newest published Taim and installs it. Either way your sounds, sound levels, settings, assistants and channels are kept.

Your assistants can read setup/TAIM-TOOLS.txt (inside Taim's folder) for every tool that comes with Taim: the local notes search, reminders, scheduled tasks, hooks, code checks, channels and updating.
The features the Windows Taim has that this one does not yet, and how your assistant can add each one, are in setup/WINDOWS-FEATURES-FOR-LINUX.txt.

Keys: Control and a number jump to that assistant (twice quickly says how much of its account limit is used), Control and the key left of 1 jump to Channels, F2 is the conversation, F3 is the message box, Enter sends, and F10 opens the menu.

Also: Control+F (Tools menu) searches every saved conversation (words to find, whose, how far back). Control+K checks the code of the project picked for the assistant in front. Control+Shift+U looks for a newer Taim. Control+O opens your file manager. Delete in the conversation erases the selected lines for good (Shift with the arrows picks several); there is no undo. Control+R sends your last unanswered message again. Alt+Left and Alt+Right replay the replies you have heard. Control+F4 closes the assistant in front. Control+Shift+T sets a timer or an alarm. Settings, My profile tells your assistants who you are, once per run. Anything typed and not sent is kept when Taim closes and put back next time.

The clock: Taim keeps its own time from public time servers and shows a clock at the right of its title bar (the logo is at the left), a round face with hands or digital numbers. Tab to it and press Enter for its menu: Timers and alarms, Mute clock sounds, and Clock settings, where you choose the look, 12 or 24 hours, and the tick every second and the Big Ben chimes at the quarters, half hour and hour. The same menu is under Clock and timers in the main menu. A timer, alarm or reminder plays short beeps and then is spoken. Restart Taim, at the end of the main menu, closes Taim and opens it again on the assistant you were using.

Spoken reminders: ask your assistant, or run  python3 ~/.local/share/taim/taim_reminders.py add "Get ready for the meeting" --clock 3:00   (also --in 20 for minutes from now, --at "2026-10-08 14:30", --am, --pm, --tomorrow; list and cancel 1 work too). A bare clock time means the nearest coming am or pm. Taim says it in your assistant's voice when it is due, and only while Taim is open.

Scheduled tasks and hooks are small programs Taim runs for you, with no model and no cost. Tasks go in ~/.local/share/taim/tasks.json (a list of name, command, when like "daily 06:00" or "every 30 minutes"); hooks go in hooks.json beside it (on: reply, failed, sent, long_done, channel, start or close; the program learns what happened from TAIM_EVENT, TAIM_ASSISTANT and TAIM_TEXT). Neither file exists until you make one.
