Building from Source

Building from Source

Everything SkillFishOS does is documented and reproducible. The repo is MTSistemi/SkillFishOS (GPL-3.0).

Repo layout

Path	What
apps/	the native PyQt6 apps (tuner, ai-panel, monitor, kernel-manager, hub, iso-mount) + build scripts
kernel-build/	the linux-tkg recipe + BC-250 userpatches
system/	a snapshot of the live system config (/usr/local/bin, systemd units, /etc, boot/login branding, KDE config for /etc/skel) — a reproducible mirror
theme/	the steampunk theme (GRUB/Plymouth/SDDM/Plasma/icons/cursors/Kvantum/wallpapers)
iso/	the live-build / penguins-eggs recipe
docs/	OPTIMIZATIONS, BUILD, DESKTOP, GAMING, AI
website/	the Astro source for skillfishos.com

Kernel

See kernel-build/ and docs/BUILD.md. In short: clone linux-tkg, apply the BC-250 userpatches (freq-unlock 350–2230, 40-CU, RDSEED-quiet), set the -march for the flavour you want (znver2 / x86-64), build the .deb. The image is published as a GitHub Release asset (it's >100 MB) and wrapped by skillfishos-kernel — see Kernel.

Apps

The apps are plain Python (PyQt6). Build the .debs with apps/build-debs.sh (or rebuild from the live system with the generic rebuilder: copy the files dpkg -L <pkg> lists, take the control from dpkg-query -s with a bumped Version, keep the maintainer scripts, dpkg-deb --build). Ship them through the APT Repository.

ISOs

Built with penguins-eggs (eggs produce -n -N -K <kver> --basename=<name>); output lands in the eggs mount, then moved to the output dir. The Calamares installer is branded to show "SkillFishOS 26.06 Aetherium". Sanitization is safe by default (eggs doesn't include /root; the live user is fresh from /etc/skel).

Contributing

PRs and issues welcome — see CONTRIBUTING.md. The optimisation rationale for every hardware workaround is in docs/OPTIMIZATIONS.md.