Skorpion OS

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

---

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 a clean, minimal desktop environment (i3 WM) with deep AI integration through Ollama, giving you an AI assistant that never call on the internet.

---

Key Features

• SKAI — Integrated local AI subsystem powered by Ollama (qwen2.5:14b)
• SkAifox Extension — Browser-integrated AI that talks to your local model
• skai — Natural language file manager agent (CLI-based, LLM-powered)
• i3 WM — Tiling window manager for maximum screen efficiency
• kitty terminal — GPU-accelerated 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

⚠️ Running qwen2.5:14b requires at least 8 GB RAM. Smaller Ollama models are available for lower-end machines.

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.

Default model: qwen2.5:14b

---

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, i3 configs, scripts

---

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) — a 17-year-old developer passionate about Linux, local AI, privacy, and electronic hacking.