应执行hermes update命令在线升级，该方法为官方推荐快捷路径，可一键拉取最新代码、重建依赖、同步配置模板并自动启动新版Web UI服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在运行Hermes Agent，但发现功能缺失、命令失效或Web UI无法加载，则可能是当前版本已落后于最新稳定发布。以下是升级Hermes Agent版本的具体操作说明：
一、使用hermes-cli内置升级命令
该方法适用于所有通过pip或源码安装且保留了CLI工具链的部署场景，利用项目内建的版本检查与依赖同步逻辑，确保配置合并机制（_deep_merge）自动生效。
1、打开终端或命令行界面，确认当前已激活Hermes Agent运行环境。
2、执行hermes-cli upgrade命令，系统将自动检测远程最新稳定版本（如v0.9.0）及本地当前版本。
3、确认升级提示后，工具将拉取新版本包、备份原有config.py与workspace/目录结构，并调用_deep_merge函数完成默认配置与用户自定义配置的深度融合。
4、升级完成后，运行hermes-cli health-check验证记忆索引服务、技能加载器及MCP网关连接状态。
二、执行hermes update在线升级
该方法为官方推荐的快捷升级路径，适用于已正确注册全局hermes命令的用户，可一键拉取最新代码、重建依赖并同步配置模板。
1、在任意目录下打开终端，确保网络可达GitHub与PyPI源。
2、输入并执行hermes update命令。
3、等待输出中出现Upgrade completed successfully提示，期间系统将自动处理venv重编译与config.yaml字段兼容性校验。
4、升级完毕后，直接运行hermes dashboard启动新版Web UI服务。
三、基于Git分支的手动版本切换
该方法适用于从GitHub源码构建、需精确控制修订号或需回滚至特定次版本的高级用户，可绕过包管理器限制，直接复用现有workspace路径与数据目录。
1、进入Hermes Agent项目根目录，执行git fetch origin同步全部远程分支与标签。
2、运行git tag --sort=version:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | tail -n 5查看最近五个语义化版本标签。
3、检出目标版本，例如git checkout v0.9.0，确保工作区处于干净状态（无未提交修改）。
4、执行pip install -e . --force-reinstall --no-deps仅重装当前代码，跳过依赖重复安装，保留已配置的模型路径、Nous Portal凭证及datagen-config-examples/映射关系。
5、启动代理前，手动确认hermes_cli/config.py中DEFAULT_CONFIG结构与user_config.yaml字段无键冲突；若存在主版本变更（如v0.8.x → v0.9.0），必须查阅对应版本CHANGELOG.md中的迁移字段说明。
四、离线手动升级
该方法适用于无外网访问权限的生产环境，通过预下载发布包并本地部署，避免网络依赖导致的中断风险。
1、在有网络的机器上访问https://github.com/NousResearch/hermes-agent/releases，下载最新release的.tar.gz归档文件（如hermes-agent-v0.9.0.tar.gz）。
2、将压缩包复制至目标服务器指定路径（如/home/user/hermes-updates/）。
3、解压并进入目录：tar -xzf hermes-agent-v0.9.0.tar.gz && cd hermes-agent-v0.9.0。
4、执行pip install -e . --force-reinstall --no-deps完成本地安装。
5、运行hermes migrate-config触发离线配置迁移脚本，自动适配v0.9.0新增的dashboard_port、fast_mode_enabled等字段。
五、指定版本精确升级
该方法适用于需要锁定特定小版本（如v0.9.0-beta.3）或规避某次发布中已知问题的场景，支持通过版本标识符强制覆盖。
1、确认当前安装方式为pip管理：运行pip show hermes-agent检查Package Location是否指向site-packages。
2、执行pip install --force-reinstall --no-deps 'hermes-agent==0.9.0'，注意单引号包裹以防止shell解析错误。
3、若提示依赖冲突，添加--ignore-installed参数并显式指定依赖版本，例如：pip install --force-reinstall --ignore-installed 'pydantic>=2.6.0,。
4、升级后运行hermes doctor执行全栈诊断，重点检查TUI渲染层、MCP网关握手协议及/config页面表单字段加载状态。
