Hermes Agent本地私有化部署需五步：克隆仓库、运行安装脚本、配置.env文件、显式绑定本地路径、启动验证服务；全程数据不出本地，模型可控，技能可审计。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将Hermes Agent完全运行于自有设备之上，实现数据不出本地、模型可控、技能可审计的私有化运行，则需跳过云托管方案，直接在本地机器完成全链路部署。以下是完成本地私有化部署的具体步骤：
一、克隆代码仓库并进入项目目录
获取最新稳定版Hermes Agent源码是私有化部署的第一步。该操作确保您使用的是官方维护的主干分支，所有本地配置与技能模块均从源码根目录出发进行管理。
1、打开终端（Linux/macOS）或PowerShell（Windows，建议以管理员身份运行）。
2、执行Git克隆命令：git clone https://gitcode.com/GitHub_Trending/he/hermes-agent。
3、切换至项目根目录：cd hermes-agent。
二、执行一键安装脚本
该脚本自动完成Python环境隔离、依赖安装与基础工具链配置，避免手动安装引发的版本冲突或缺失依赖问题，是本地私有化部署的核心自动化环节。
1、确认当前位于hermes-agent目录下。
2、赋予脚本执行权限（Linux/macOS）：chmod +x ./setup-hermes.sh。
3、运行安装脚本：./setup-hermes.sh。
4、如提示输入sudo密码，请确认授权系统级依赖安装（如uv、build-essential等）。
三、配置本地环境变量
私有化部署要求所有敏感凭证与连接参数严格限定于本地文件，不上传、不同步、不参与任何远程初始化流程。.env文件即为该策略的落地载体，必须手工编辑并保存在项目根目录。
1、查看已生成的模板文件：cat .env。
2、使用文本编辑器打开该文件：nano .env（或Windows下用Notepad++/VS Code）。
本地音视频转录整理技能 — 接收音频、视频、播客链接、字幕、原始转写稿或未整理文字，完成 ASR 转录（本地 faster-whisper / mlx-whisper）、文本清洗整理，输出分享式提纯版中文原文到本地 .txt 文件。所有产物保存在本地。
3、填入本地可用的LLM接入信息，例如Ollama配置：LLM_PROVIDER=ollama，LLM_BASE_URL=http://localhost:11434/v1，LLM_MODEL=llama3.1。
4、若使用本地数据库，设置DB_PATH为绝对路径，例如：DB_PATH=/home/user/hermes-data/db.sqlite3。
四、启用本地优先模式并验证路径绑定
Hermes Agent的“本地优先”特性依赖显式路径声明，所有memories/、skills/、config/子目录必须指向本地可写位置，禁止使用默认临时路径或云同步目录。
1、检查项目根目录是否存在config/目录，若无则创建：mkdir -p config。
2、复制默认CLI配置模板：cp cli-config.yaml.example config/cli-config.yaml。
3、编辑config/cli-config.yaml，将memories_dir字段设为绝对路径，例如：memories_dir: "/home/user/hermes-data/memories"。
4、同理设置skills_dir与logs_dir为本地独立路径。
五、启动并验证本地运行实例
仅当所有组件均在本地进程内完成初始化且不触发任何外网HTTP请求时，方可视为完成私有化部署。此步骤通过CLI指令与进程监听状态双重确认。
1、执行版本检查：hermes --version，输出应包含v0.1.0及本地Python路径。
2、运行诊断命令：hermes doctor，确认所有检查项前缀为✓，且网络连接项显示未启用远程调用或类似提示。
3、启动本地Agent服务：hermes serve --host 127.0.0.1 --port 8000。
4、在浏览器中访问http://127.0.0.1:8000/health，返回{"status":"ok","mode":"local"}即表示私有化服务已就绪。
