推荐使用官方一键安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，自动适配各发行版并完成依赖安装、环境配置与验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Linux 系统上成功运行 Hermes Agent，但遇到依赖缺失、网络超时或权限报错等问题，则可能是由于发行版差异导致的环境适配不一致。以下是适用于主流 Linux 发行版（Ubuntu、Debian、CentOS、Rocky、AlmaLinux、openEuler、UOS、麒麟等）的通用部署方案：
一、使用官方一键安装脚本（推荐：全发行版兼容）
该方法通过官方维护的 install.sh 脚本自动检测系统类型、安装必要依赖、配置 Python 环境并完成 Hermes Agent 的二进制安装与初始化，无需手动判断包管理器或版本分支。
1、下载并执行官方安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、等待脚本自动完成依赖检查、pip 升级、hermes-agent 包安装及 ~/.bashrc 环境变量写入
3、加载新环境变量：source ~/.bashrc
4、验证安装结果：hermes --version，预期输出类似 hermes v0.8.0 (v2026.4.8)
二、离线环境部署（适用于无外网或防火墙严格限制场景）
当目标服务器无法访问 GitHub 或 PyPI 时，可预先在联网机器下载全部资源，再通过 SCP 或 U 盘导入，规避网络中断与证书校验失败问题。
1、在联网机器上创建离线包目录：mkdir -p ~/hermes-offline && cd ~/hermes-offline
2、下载官方源码压缩包：wget https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -O hermes-main.zip
3、下载依赖轮子包（以 Python 3.11 为例）：pip download --no-deps --platform manylinux2014_x86_64 --python-version 311 --only-binary=:all: hermes-agent -d ./wheels
4、将整个 ~/hermes-offline 目录复制至目标服务器的相同路径
5、在目标服务器执行离线安装：pip install --find-links ./wheels --no-index hermes-agent
6、解压源码并进入目录：unzip hermes-main.zip && cd hermes-agent-main
7、手动运行初始化：python -m hermes --setup
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
三、Docker 容器化部署（隔离性强、免环境冲突）
此方式将 Hermes Agent 运行于标准容器中，完全屏蔽宿主机 Python 版本、系统库版本差异，适合多服务共存或需快速重置状态的场景。
1、确保 Docker 已就绪：docker version 应返回 Server 和 Client 版本信息
2、拉取预构建镜像（使用轩辕镜像加速）：docker pull registry.xuanyuan.cloud/hermes/agent:latest
3、创建配置挂载目录：mkdir -p ~/hermes-config && touch ~/hermes-config/config.yaml
4、首次启动容器并交互式配置：docker run -it --rm -v ~/hermes-config:/app/config registry.xuanyuan.cloud/hermes/agent:latest --setup
5、配置完成后，以后台模式运行：docker run -d --name hermes-prod -p 8080:8080 -v ~/hermes-config:/app/config registry.xuanyuan.cloud/hermes/agent:latest
四、基于源码编译安装（适用于安全审计或定制化需求）
该方式完整暴露所有构建环节，支持审查 Rust 核心、Python 技能加载器及第三方依赖来源，符合金融、政务等高合规要求场景的交付规范。
1、安装构建工具链：sudo apt install build-essential git curl -y（Ubuntu/Debian）或 sudo dnf groupinstall "Development Tools" -y（RHEL/CentOS/Rocky）
2、安装 Rust 编译器：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
3、克隆源码仓库：git clone https://github.com/NousResearch/hermes-agent.git && cd hermes-agent
4、安装 Python 构建依赖：pip install build setuptools wheel
5、执行本地构建：python -m build
6、安装生成的包：pip install dist/hermes_agent-*.whl
7、验证可执行文件路径：which hermes
