chy (pronounced "chai") is a byte-sized, portable, source-based package manager written in POSIX shell.

Everything is under $CHY_ROOT, ~/.chy by default. Packages get built into store/ and linked into a usr/ symlink farm. chy lives in userland and won't write outside its root, so deleting the folder is equal to a full uninstall. Running chy with no arguments prints the list of all options.

git clone https://github.com/alperien/chy && cd chy
git clone https://github.com/alperien/chy-recipes
export CHY_ROOT=$HOME/.chy PATH="$HOME/.chy/usr/bin:$PATH"
mkdir -p "$CHY_ROOT" && ln -s "$PWD/chy-recipes/recipes" "$CHY_ROOT/recipes"
cp chy-recipes/shlibs.map "$CHY_ROOT/shlibs.map"
sh chy/chy install freetype
eval "$(sh chy/chy env)"          # add to your profile; prints nothing
                                  # until the root has a bin dir

the db/provided file lists library and tool names the host system
already supplies, so chy skips building recipes that would only
duplicate them. install seeds it automatically from the repo's
provided.suggested.

repositories: $CHY_PATH adds more, colon-separated, searched in
order between the root's overlay/ and the default repo; the first
repo carrying a package wins, so your overrides go first and the
default repo is the fallback.

recipes carrying `kind binary` and no build file install their single
checksummed archive directly: the tarball IS the package, layout and
all, and the digest in the recipe is the whole trust surface.

Packages are recipe based and easily readable and tweakable. A recipe is a folder containing a bunch of text files: version, sources, checksums, depends, makedepends, a build script, patches/, and an optional patchlevel for patches that don't apply at -p1. For quick tweaks there's also $CHY_ROOT/overlay/, which chy reads before the repo.

The default repo, chy-recipes, is converted from Void Linux's xbps by the chytrans tool. Void's maintainers do the packaging; a nightly sync snapshots their templates, translates the set, and pushes what builds. Fixes go into the translator; recipe PRs against chy-recipes get closed.

alperien.github.io/chy, inspired by kiss.

Contributions welcome.

MIT.