| title: Hermes Agent | |
| emoji: 🦅 | |
| colorFrom: indigo | |
| colorTo: purple | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| # Hermes Agent on Hugging Face Spaces | |
| 这个 Space 运行的是 **Hermes Agent**，并且已经从 `rclone` 迁移到 **Hugging Face Buckets** 做备份与恢复。 | |
| ## 当前状态 | |
| - 数据目录：`/opt/data` | |
| - 备份目标：`hf://buckets/guntp/hersb` | |
| - 备份方式：`hf buckets sync` | |
| - 恢复方式：`hf buckets sync` 反向同步 | |
| - 自动备份：**启动后立刻备份一次，然后每 1 小时备份一次** | |
| ## 需要配置的 Secrets | |
| 到 Space 的 **Settings → Repository secrets** 里添加： | |
| - `HF_TOKEN`：Hugging Face 访问 token，必须对 bucket 有读写权限 | |
| - `HF_BUCKET_REMOTE`：可选，默认 `hf://buckets/guntp/hersb` | |
| - `HF_BUCKET_BACKUP_INTERVAL`：可选，默认 `3600` | |
| - Hermes 运行所需的其它变量：LLM、Telegram、Dashboard 相关配置照旧 | |
| ## 常用命令 | |
| ```bash | |
| # 备份到 bucket | |
| hf buckets sync /opt/data hf://buckets/guntp/hersb --delete | |
| # 从 bucket 恢复到本地 | |
| hf buckets sync hf://buckets/guntp/hersb /opt/data | |
| # 查看 bucket 内容 | |
| hf buckets ls guntp/hersb --tree | |
| ``` | |
| ## 说明 | |
| - `/health` 仍然用于 HF 健康检查 | |
| - 这个 Space 仍然**不提供网页聊天 UI**，它是 Hermes Agent 本体 | |
| - 备份逻辑在容器启动脚本里自动运行，不需要再配置 cron | |
| - `rclone` 相关脚本已经移除，不再使用 | |
| ## 变更后的行为 | |
| 1. Space 启动 | |
| 2. 先写入默认配置并修正目录属主 | |
| 3. 如果检测到 `HF_TOKEN`，立即执行一次 bucket 备份 | |
| 4. 后台循环按 `HF_BUCKET_BACKUP_INTERVAL` 继续同步 | |
| 如果你想把备份频率改成更短、更长，或者完全关闭自动备份，只需要改 `HF_BUCKET_BACKUP_INTERVAL`。 | |