6.5 KiB
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
- Create
pkgs/<name>/default.nixwith a standard derivation - Add an entry to the overlay in
modules/core/default.nix:(final: _prev: { <name> = final.callPackage ../../pkgs/<name> { }; }) - Reference it as
pkgs.<name>anywhere in the flake - Optionally expose it as a flake output in
flake.nixunderpackages
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 haveupdate.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-updatehook (defined inflake.nix) runsskyg pkgs update --allon 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 underpkgs/, 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.licenseandmeta.sourceProvenanceaccurately - Use
stdenvNoCCfor prebuilt binaries that don't need compilation - Hash updates: use
nix hash file --type sha256 --sri <file>after downloading the new binary