必须确认系统为ubuntu 22.04/24.04、debian 12、centos stream 9或almalinux 9，git≥2.25且已手动安装，网络可通github.com和hermes-agent.org，用户具备免密sudo权限，shell为bash/zsh且为登录shell。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Linux服务器上安装Hermes Agent v0.19.1前，必须确认系统满足最低运行门槛，否则安装脚本会中途退出、CLI命令无法识别、甚至导致后续模型调用失败。
系统与网络基础要求
使用 lsb_release -a 或 cat /etc/os-release 确认发行版为 Ubuntu 22.04/24.04、Debian 12、CentOS Stream 9 或 AlmaLinux 9；ARM64 架构需额外验证内核版本 ≥ 5.15（uname -r）。
执行 ping -c 2 github.com 和 curl -I https://hermes-agent.org 双重检测——若任一失败，国内用户须先配置镜像源，否则 install.sh 将卡在依赖下载阶段。
确保当前用户具备 【sudo 权限且可免密执行 apt/yum/dnf】，安装脚本内部会自动调用包管理器，无此权限会导致 uv、Node.js、ffmpeg 等核心组件安装中断。
唯一强制手动准备的依赖：Git
运行 git --version，输出必须为 2.25+；低于该版本将导致子模块克隆失败，进而使 skills 和 memory 初始化为空。
若未安装或版本过低，根据系统执行对应命令：
Ubuntu/Debian：sudo apt update && sudo apt install -y git
CentOS/AlmaLinux：sudo dnf install -y git。
这一步不可跳过，【官方一键脚本不包含 Git 安装逻辑】，即使系统自带旧版 Git，也必须手动升级——因为子模块递归拉取依赖 --recurse-submodules 在 Git 2.17 以下会静默忽略。
Python 与 Shell 环境校验
检查默认 shell 是否为 bash 或 zsh：echo $SHELL，输出应含 /bin/bash 或 /bin/zsh；若为 dash 或 fish，需先切换登录 shell，否则 ~/.bashrc 中注入的 hermes 命令路径不会生效。
运行 python3 --version，只要 ≥ 3.9 即可——v0.19.1 的安装脚本会强制部署 Python 3.11 并隔离使用，不污染系统 Python。
确认当前终端是登录 shell：新开一个 terminal 执行 hermes --version，若提示 command not found，说明环境变量未加载，需手动运行 source ~/.bashrc 或重启终端。
