当uv包管理器安装失败时，可手动部署Python依赖：一、切换Python至3.11+版本；二、用pip+venv构建环境；三、离线预装依赖包；四、用conda替代pip管理依赖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装 Hermes Agent 时遇到 uv 包管理器下载或初始化失败，导致依赖无法自动拉取，则可能是由于网络连接中断、GitHub 原始资源不可达或系统缺少基础构建工具。以下是绕过 uv 自动安装流程、手动部署 Python 依赖的可行路径：
一、验证并切换 Python 版本至 3.11+
uv 脚本失败常因系统默认 Python 版本过低（如 Ubuntu 22.04 自带 Python 3.10），而 Hermes Agent 强制要求 Python 3.11 或更高版本。需先确认并激活合规版本。
1、在 WSL2 终端中执行 python3 --version 查看当前版本。
2、若版本低于 3.11，执行 sudo apt update && sudo apt install -y python3.12 python3.12-venv python3.12-dev 安装 Python 3.12。
立即学习“Python免费学习笔记（深入）”；
3、使用 sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 设置优先级。
4、运行 sudo update-alternatives --config python3 并选择编号对应 python3.12 的条目。
二、跳过 uv，直接用 pip + venv 构建运行环境
uv 是可选加速层，Hermes Agent 的核心逻辑兼容标准 pip 工具链。可通过手动创建虚拟环境并安装依赖替代 uv 流程。
1、执行 python3.12 -m venv ~/hermes-env 创建独立虚拟环境。
2、运行 source ~/hermes-env/bin/activate 激活该环境。
3、升级 pip 至最新版：pip install --upgrade pip。
4、从 Hermes 仓库手动拉取依赖清单：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/requirements.txt -o requirements.txt。
5、执行 pip install -r requirements.txt --no-cache-dir 完成依赖安装。
三、离线预装依赖包并导入
当网络受限无法实时访问 PyPI 或 GitHub 时，可在另一台联网机器上预先打包所有依赖，再复制至目标环境安装。
1、在联网 Linux 环境中新建临时目录，激活相同 Python 3.12 环境。
2、运行 pip download -r requirements.txt --no-deps --platform manylinux2014_x86_64 --only-binary=:all: -d ./pkg 下载轮子文件。
3、将整个 ./pkg 文件夹压缩后拷贝至 WSL2 目标路径。
4、在目标环境中解压，并执行 pip install --find-links ./pkg --no-index --trusted-host None *.whl 安装全部离线包。
四、使用 conda 替代 pip 管理依赖
conda 提供跨平台二进制分发与环境隔离能力，可规避 uv 对底层编译工具链的强依赖，在部分 WSL2 配置异常场景下更稳定。
1、先安装 Miniconda3：curl -fsSL https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -o miniconda.sh && bash miniconda.sh -b -p $HOME/miniconda3。
2、初始化 conda：$HOME/miniconda3/bin/conda init bash，然后关闭并重开终端。
3、创建专用环境：conda create -n hermes-py312 python=3.12。
4、激活环境：conda activate hermes-py312。
5、安装依赖：pip install -r requirements.txt（仍使用 pip 安装，因 Hermes 未提供 conda-forge 镜像）。
