Skorpion OS

A Debian-based Linux distribution with integrated local AI — built for privacy and full control.

Flashing

This ISO is hybrid — write it directly to a USB drive, no extraction needed. Boots in both Legacy BIOS and UEFI.

• Ventoy (recommended) — install Ventoy on your USB once, then just copy the .iso onto it like a normal file. Supports multiple ISOs on one drive, no reflashing needed for updates. Safest option for most users.

• GNOME Disks — built into most GNOME-based distros, handles hybrid ISOs correctly.

  Open Disks → select your USB drive → menu → Restore Disk Image → pick the .iso → start

• dd (advanced) — writes byte-for-byte, works fine with this ISO, but no safety net: wrong device = wrong disk overwritten. Terminal users only.

  lsblk sudo dd if=skorpion_lite-3.5.iso of=/dev/sdX bs=4M status=progress oflag=sync

  Replace /dev/sdX with your actual drive (whole disk, not a partition like /dev/sdb1).

• balenaEtcher — strictly not recommended — long-standing bug detecting hybrid ISOs, often throws false "corrupted archive" or "flasher sidecar" errors, even on official Debian/Ubuntu/Mint ISOs. If your SHA256 checksum matches, the file is fine — the problem is in Etcher.

What is Skorpion OS?

Skorpion OS is a custom GNU/Linux distribution built on top of Debian, designed around a single core idea: AI should run locally, on your hardware, under your control.

No cloud. No telemetry. No subscriptions. Just raw computing power with an intelligent layer baked right in.

The distro combines two clean environments (i3 WM and Cinnamon DE) with deep AI integration through Ollama, giving you an AI assistant that never calls on the internet.

Key Features

• SKAI — Integrated local AI subsystem powered by Ollama
• SkAifox Extension — Browser-integrated AI that talks to your local model
• skai — Natural language file manager agent (CLI-based, LLM-powered)
• sk_suite — Mail, Notes and Calendar managed by AI
• kitty terminal — Terminal emulator
• Debian Trixie base — Stable, up-to-date, and familiar
• Privacy-first — No external AI calls by default; all inference runs on-device

System Requirements

Component	Minimum	Recommended
CPU	x86_64, 4+ cores, Intel/AMD with AVX2	8+ cores
RAM	8 GB	16 GB (for LLM inference)
GPU	4 GB VRAM	NVIDIA + CUDA 11+
Storage	20 GB (OS + base AI model)	50+ GB
Architecture	64-bit only	64-bit only
Internet	Optional	Only for updates & model downloads

SKAI — The AI Subsystem

SKAI is the brain of Skorpion OS. It exposes a local HTTP API (via Ollama) that all system components talk to — the Firefox extension, skai, and any custom apps.

skai — Natural Language File Manager

skai lets you manage your filesystem using plain English (or Italian):

$ skai "move all pdf's in ~/documents"
$ skai "find all files larger than 100MB and list them"
$ skai "delete temp files in /tmp older than 7 days"

skai interprets your intent using the local LLM and executes safe shell commands — no cloud required.

Contributing

Skorpion OS is an open project. Contributions welcome:

• Bug reports & feature requests
• Code contributions
• New Ollama model profiles, scripts, codes, apps, ideas

License

Skorpion OS is released under the GNU General Public License v3.0. Individual components may carry their own licenses — see each subfolder for details.

Author

Built by Enrico (Endrx/Kadmin) — a 17-year-old tinkerer hobbyist, passionate about Linux, local AI and privacy.