# NousResearch/hermes-agent · Linux install missing xz-utils dependency

## Open now

- Nothing open on GitHub.

Multiple reports and fixes around xz-utils (and sometimes curl) being absent on Linux, causing Node.js tarball extraction to fail during installation. Members include bug reports, documentation updates listing prerequisites, and code fixes to handle or install the missing dependency.

## TL;DR

- 10 member(s): 0 open issue(s), 3 closed issue(s), 0 open PR(s), 1 merged PR(s), 6 PR(s) closed without merging.
- A fix was merged to main in PR #109128. Verify it addresses your case.
- **Recommended:** read PR #109128 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `partially_resolved` · deciding PR(s): `pr-109128`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.17`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #50: Installation issue - cannot move ... to '/root/.hermes/node'
- #11197: \[Bug\]: install.sh Needs xz-utils
- #47033: \[Bug\]: Missing dependencies

## Prior & competing PRs

- **#109128: fix(install): Node.js download falls back to .tar.gz when the host has no xz (#11197)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `scripts/install.sh`, `scripts/lib/node-bootstrap.sh`, `tests/test_install_sh_node_tarball_without_xz.py`
- **#4229: fix(install): graceful fallback when xz is missing for Node.js tarball extraction**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`
- **#11217: fix: : install.sh Needs xz-utils**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`
- **#11278: fix 11197: install xz-utils before extracting tar.xz**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `a7cf8ef8b2`, `#109128`
- **#47037: fix(docs): document xz-utils and curl as Linux prerequisites**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`
- **#47631: fix(docs): document xz-utils and curl as Linux prerequisites**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#47637`
- **#48329: docs(install): list Linux bootstrap prerequisites**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#47631`, `#47033`, `#47037`, `#47631`, `#47631`

## Fix status

- Merged to main in PR #109128 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-12`.
- Subsystem: `apps/bootstrap-installer`