Repository navigation
Tuxistant 0.1.0, a preview
Pre-release
Pre-release
The first tagged release. It is a preview: everything here is built and tested, but some of it has only run in tests and in an isolated GNOME Shell, not yet on a desktop in daily use. docs/ROADMAP.md says which parts those are, under "Where things stand".
It needs GNOME Shell 50 on Wayland, Python 3.14, and a LocalAI server of your own with an 8 GB NVIDIA GPU. README.md has the full list and the install steps, and server/ sets up the server.
What it does:
- Talk and listen. Press
Ctrl+Super+Spaceor hold Fn, ask, and Tux answers out loud. A blob on screen reacts while captions show what was heard and said. Speech, the model and the voice all run on your own server. - Dictation. Tap Fn, then hold it and speak, and your words are typed where the cursor is. It never presses Enter.
- Skills. Weather and news, finding and opening files, sending a file to your phone or ringing it, moving old files to the Trash, Tapo smart lights, translation spoken in a native voice, facts about this computer, and shell commands.
- Approval cards. Anything that changes something or sends a file off the computer shows exactly what will happen and waits for a click. Read-only commands run in a sandbox without one.
- Several steps in one request, on your own server, or with Claude if you turn on Cloud and add your own key. Cloud is off by default.
- Four themes, and you can write your own as a JSON file and a shader.
- A Settings app for the server, voice, look, skills and history, and
tuxistant doctorto check an install. - A server kit in
server/: one script that installs LocalAI, the models and the voices, then tests them.
Known limits are listed in docs/ROADMAP.md, and what the security reviews found and didn't cover is in docs/SECURITY.md.