Files
2026-11-17 14:10:00 -05:00

6.5 KiB

pkgs/

Custom Nix package derivations for software not available in nixpkgs (or needing local overrides). Packages here are exposed via an overlay defined in modules/core/default.nix.

Contents

Package Description
colibri/ colibrì (JustVugg/colibri) — GLM-5.2/OLMoE local inference engine, built from source, pinned to a tagged release. Backend-parameterized (backend = "cpu" | "rocm"). Exposed as pkgs.colibri (cpu, default), pkgs.colibri-rocm (Strix Halo / gfx1151). Installs the coli CLI (wrapped with the Python env its converter/bench subcommands need) plus the bundled colibri/olmoe engine binaries. Model weights are a runtime concern and not packaged.
niri-touchscreen-gestures/ Python daemon that reads multi-touch events from a touchscreen via evdev, detects 2/3/4-finger swipes (up/down/left/right), and dispatches configurable niri msg action commands. Configured via TOML; exposed as pkgs.niri-touchscreen-gestures.
buzz-desktop/ Block Buzz desktop (Type-2 AppImage from block/buzz). Wrapped with appimageTools.wrapType2 plus extra FHS libs (elfutils, zstd, WebKit/tray, GStreamer good/bad) so it runs on NixOS. Exposed as pkgs.buzz-desktop (buzz-desktop binary + desktop entry / icons).
buzz-cli/ Buzz CLI (buzz, crates/buzz-cli of block/buzz), built with rustPlatform.buildRustPackage from the same tag as buzz-desktop. Hermes's Buzz platform shells out to it. Bump with update.sh (sets the source hash, resets cargoHash to lib.fakeHash; build once and paste the got: hash). Robots call it with pkgs.callPackage (their nixpkgs has no host overlay).
delta-editor/ Delta Editor (Zed Industries' AI-native editor, delta.dev) prebuilt tarball. No stable URL exists — the release API returns a short-lived signed R2 link — so src is a fixed-output derivation that resolves the API at build time. Interpreter/RPATH patched (--force-rpath, dontPatchELF), dlopen'd graphics libs (libglvnd, vulkan-loader, wayland) added via wrapper, XKB_CONFIG_ROOT set for the bundled libxkbcommon. Exposed as pkgs.delta-editor (delta-editor binary + desktop entry / icons); named -editor to avoid clashing with the delta git diff pager.
llama-cpp/ llama.cpp pinned to v0.8.0, the first release with DFlash2 drafters (--spec-type draft-dflash). nixpkgs only carries v0.6.0 in the unstable input and an older tree in the stable one, so the server is built here. HIP build for Strix Halo (CMAKE_HIP_ARCHITECTURES=gfx1151, ROCm clang++, autoPatchelfHook). Backend-parameterized: pkgs.llama-cpp-halo (rocm, default) and pkgs.llama-cpp-halo-cpu (same tree, no GPU backend). Web UI is off — it downloads prebuilt assets at build time, which the sandbox cannot do. Model weights are not packaged.

Adding a New Package

  1. Create pkgs/<name>/default.nix with a standard derivation
  2. Add an entry to the overlay in modules/core/default.nix:
    (final: _prev: {
      <name> = final.callPackage ../../pkgs/<name> { };
    })
    
  3. Reference it as pkgs.<name> anywhere in the flake
  4. Optionally expose it as a flake output in flake.nix under packages

Updating Packages

Each package can have an update.sh script that automates version bumps.

  • skyg pkgs update --all — auto-detect the latest version for all packages that have update.sh.
  • skyg pkgs update <pkg-name> — auto-detect the latest version for a single package.
  • skyg pkgs update <pkg-name> <version> — bump a specific package to a specific version.
  • Pre-commit hook — a pkgs-update hook (defined in flake.nix) runs skyg pkgs update --all on the first commit attempt and then at most once every seven days. It records successful runs in Git's local metadata; failed updates are retried on the next commit. If it changed anything under pkgs/, it blocks the commit (review + git add pkgs/, then commit again without rerunning the update).

Each update.sh supports two modes:

  • ./update.sh <version> — bump to the given version.
  • ./update.sh (no args) — auto-detect the latest version from upstream.

Notes

  • For unfree or binary packages, set meta.license and meta.sourceProvenance accurately
  • Use stdenvNoCC for prebuilt binaries that don't need compilation
  • Hash updates: use nix hash file --type sha256 --sri <file> after downloading the new binary