Turn any Linux into
one you can work on.
A project by Erik Dubois — creator of Kiro.
ArcoLinux Nemesis is a collection of Bash scripts that install, configure, and personalize Arch Linux and 30+ other distributions. Minimal scripting turns a fresh install into a system that’s yours — and lets you reproduce it on any distro.
These scripts are meant to be examined and run at your own discretion. Read before you run.
What is “Nemesis”?
Not a distribution. A collection of scripts and methodologies — a DIY toolkit for building your own Linux system, on whatever distro you already run.
Learn by doing
Real system building, not theory. Every script is plain Bash you can read, judge, and adapt.
Reproducible
Recreate the same setup again and again. Scripts make installs consistent and repeatable.
Cross-distribution
Arch, Debian, Fedora, Ubuntu, FreeBSD, Void and more — the same toolkit, the right package manager.
Full control
Remove what you don’t want, install what you do, apply your own configs. Your system, your rules.
Quick start
Add the nemesis_repo, then run the orchestrator. A backup of your current config is made first.
1 · Add the repo
The repo is signed. The helper trusts the key, installs kiro-keyring + kiro-mirrorlist, and adds the repo:
curl -sL bit.ly/nemesis-repo | sudo bash
Your /etc/pacman.conf ends up with:
[nemesis_repo]
Include = /etc/pacman.d/kiro-mirrorlistManual key-trust steps are on the getting started page.
2 · Run the orchestrator
Clone the repo, then run the main entry point:
bash 0-current-choices.sh
It detects your OS, configures repos, updates the system, and runs the numbered pipeline. Enable or disable steps by commenting lines in that one file.
How the pipeline worksAny desktop you like
One script per environment — Awesome, I3, Leftwm, Qtile, Bspwm, Chadwm, Ohmychadwm, Plasma, Gnome, Cinnamon, Mate, Budgie, Xfce. Click an image to zoom.
Runs on the distro you already have
Built on Arch, but the toolkit reaches far beyond it. Arch-based distros work out of the box; Debian, Fedora, Ubuntu, FreeBSD, Void and more are handled per-distro.
The ArcoLinux Nemesis series
A technical video collection on building, customizing, and experimenting with Arch-based Linux systems. Follow along on YouTube.