docs(nix): mark Nix/NixOS as no longer explicitly supported (#52975)

Add a deprecation banner to the top of the dedicated Nix & NixOS setup
guide and consistency notes at the Nix sections of installation, updating,
and the plugin-distribution guide. Nix is now best-effort only; the
supported install paths are the curl|bash installer, Docker, and Windows.
This commit is contained in:
Teknium 2026-06-26 10:17:43 -07:00 committed by GitHub
parent c0568ca95f
commit bb6a4d2a57
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 10 additions and 2 deletions

View file

@ -94,7 +94,7 @@ You do **not** need to install Python, Node.js, ripgrep, or ffmpeg manually. The
:::
:::tip Nix users
If you use Nix (on NixOS, macOS, or Linux), there's a dedicated setup path with a Nix flake, declarative NixOS module, and optional container mode. See the **[Nix & NixOS Setup](./nix-setup.md)** guide.
Nix is **no longer an explicitly supported install path** (best-effort only). If you already use Nix (on NixOS, macOS, or Linux), there's a dedicated setup path with a Nix flake, declarative NixOS module, and optional container mode. See the **[Nix & NixOS Setup](./nix-setup.md)** guide.
:::
---

View file

@ -6,6 +6,10 @@ description: "Install and deploy Hermes Agent with Nix — from quick `nix run`
# Nix & NixOS Setup
:::warning No longer explicitly supported
Nix and NixOS are **no longer an explicitly supported install path** for Hermes Agent. The flake and NixOS module documented here may lag behind `main` and are maintained on a best-effort basis. For a supported setup, use the standard [installation](./installation.md) path (`curl | bash` installer, Docker, or Windows). This page is kept for users already running on Nix.
:::
Hermes Agent ships a Nix flake with three levels of integration:
| Level | Who it's for | What you get |

View file

@ -215,7 +215,7 @@ Rolling back may cause config incompatibilities if new options were added. Run `
### Note for Nix users
If you installed via Nix flake, updates are managed through the Nix package manager:
Nix is no longer an explicitly supported install path (best-effort only) — see [Nix Setup](./nix-setup.md). If you installed via Nix flake, updates are managed through the Nix package manager:
```bash
# Update the flake input

View file

@ -1196,6 +1196,10 @@ pip install hermes-plugin-calculator
## Distribute for NixOS
:::warning Nix is no longer explicitly supported
Nix/NixOS is no longer an explicitly supported install path (best-effort only) — see [Nix Setup](/getting-started/nix-setup). This section is kept for users already deploying on NixOS.
:::
NixOS users can install your plugin declaratively if you provide a `pyproject.toml` with entry points:
**Entry-point plugins** (recommended for distribution):