I built my own package manager in Rust while building a Linux distro from scratch

ChirallyActive — Sun, 28 Jun 2026 09:21:21 +0000

A few months ago I decided to build a Linux distribution entirely from scratch using LFS (Linux From Scratch) and BLFS. Every package — GCC, glibc, systemd, XFCE — compiled by hand. No shortcuts.

About halfway through I ran into a problem: there's no package manager for LFS systems. You're just supposed to compile everything manually forever.

So I built one.

What is Chiral?

Chiral is a cross-distro binary package manager written in Rust. It works on any Linux system — including custom LFS/BLFS distros, Arch, Debian, and anything in between.

The key idea: instead of being tied to one distro's repos, Chiral uses a 3-way fallback chain:

1. Your own GitHub packages/ repo
         ↓ not found?
2. Debian stable repos
         ↓ not found?
3. Arch Linux repos

If a package exists anywhere in that chain, Chiral finds it and installs it.

Install in one line

curl -L https://github.com/Amaterus1125/Chiral-CrossDistro-Package-Manager/releases/latest/download/chiral -o chiral
chmod +x chiral
sudo mv chiral /usr/local/bin/chiral

100% static musl binary. No Rust, no dependencies, runs on any Linux including a fresh LFS system with nothing installed.

How dependency resolution works

When you run chiral install gtk3, it:

Queries the Arch Linux API for gtk3's full dependency list
Walks the entire tree recursively using BFS
Checks each dep against your system before downloading
Builds a topological install order so deepest deps go first
Installs everything in order, gtk3 last

gtk3
 ├── glib2       ← installed 1st
 ├── cairo
 │    └── pixman ← installed before cairo
 ├── pango
 └── gdk-pixbuf2

The smart part: before downloading anything, Chiral checks if a dep is already on your system via pacman, dpkg, pkg-config, ldconfig, PATH, rustup, and direct filesystem scanning. It works alongside existing package managers without conflicting.

Commands

chiral install <package>   # install with full dep resolution
chiral remove  <package>   # clean remove — tracks every file
chiral update  <package>   # update one package
chiral upgrade             # update everything
chiral search  <query>     # search available packages
chiral list                # list installed packages
chiral info    <package>   # version, source, files
chiral deps    <package>   # dry run — see what would install
chiral self-update         # update chiral itself

chiral info even works on packages not installed by Chiral:

chiral info rust
# Package : rust
# Status  : not managed by chiral
# Version : 1.93.1
# Source  : rustup (installed outside chiral)

The technical bits

Dependency resolution uses BFS to walk the full tree, then Kahn's algorithm for topological sort. Circular deps are detected and broken automatically.

File tracking DB records every installed file path so chiral remove is perfectly clean:

[steam=3.5.0-1|arch]
/usr/local/bin/steam
/usr/local/lib/steam/...

Self-updating — sudo chiral self-update hits the GitHub releases API, compares versions, downloads the new static binary and replaces itself.

Auto-sync — a GitHub Actions workflow runs every Sunday, checks Arch and Debian for newer versions of packages in the repo, repacks them and commits automatically. The package repo updates itself.

Root vs user mode — runs system-wide as root (/usr/local) or per-user as a regular user (~/.local). No configuration needed.

Why I built this

LFS teaches you how Linux actually works by making you build it yourself. But once you've built it, you're stuck installing everything by hand forever. There's no package manager for a system you assembled from scratch.

I wanted one. So I built it in Rust, made it work on any Linux regardless of what's installed, and gave it the ability to pull packages from three different sources so it can find almost anything.

The name comes from chirality in chemistry — molecules that are mirror images of each other. The two UI modes (Dextro and Levo) reflect this. Dextro is the default orange helix animation. Levo is a DNA sequencer animation that shows base pairs (A═T, G≡C) scrolling as packages install.

What's next

Orphan detection (chiral autoremove)
Conflict detection
KDE support on my custom distro

GitHub: Chiral Package Manager

Built by one person while building a Linux distro from scratch. If you're doing LFS/BLFS or want a package manager that works everywhere, give it a try.

DEV Community: ChirallyActive