8000 GitHub - p34t1k/ultron: Local-first voice assistant and KDE theme for a Kali laptop: rule engine -> local LLM -> Claude, with safety gates · GitHub
[go: up one dir, main page]

Skip to content
p34t1kPublic

About

Local-first voice assistant and KDE theme for a Kali laptop: rule engine -> local LLM -> Claude, with safety gates

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ULTRON

A local-first, voice-driven personal assistant and desktop theme for a Kali Linux / KDE Plasma 6 laptop — JARVIS's courtesy fused with a cold edge.

Built for a daily-driver machine (Intel Core Ultra 7 255HX, 16 GB RAM, RTX 5060 + Intel NPU), so everything is designed to idle at a few percent CPU and to keep the heavy hardware asleep.

How it thinks (cheapest tier first)

  1. Rule engine (core/ultron_intent.py) — instant, no model, 83/84 on the author's test set with zero wrong actions.
  2. Local LLM — Qwen3 via llama.cpp (dGPU) / OpenVINO (NPU) for chat; never trusted for actions on its own.
  3. Claude (claude -p) — executive brain for anything complex, with tools restricted to the ultron-act command set, a web-fetch guard and a safety policy (ultron_policy.py). Destructive or root actions always go through an approval popup / spoken-yes gate that lives outside the model.

Layout

path what
core/ wake listener, brain service, intent rules, policy, exec session, personal wake-word head
bin/ ultron-act (the "hands"), lock/unlock watchers, phone helpers, shutdown/start, voice sampling
systemd/ user units
plasma/ Plasma widgets, wallpaper plugins (barn-door lock, ambient), look-and-feel
ui/ SDDM / Plymouth / Aurorae / lock-screen theme sources and generators
research/ local-intelligence benchmarks, personal wake-word training

Not included (on purpose)

Model weights, voice recordings, API keys, Piper voices, fonts and the recoloured third-party icon pack. Paths such as /home/redknight appear throughout — search and replace for your user. Expect to adapt it; this is a personal system published as-is.

Sibling project: MControlCenter fork with the MSI dashboard and Power & Battery integration used here.

License: MIT (see LICENSE). Third-party components keep their own licenses.

About

Local-first voice assistant and KDE theme for a Kali laptop: rule engine -> local LLM -> Claude, with safety gates

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0