---
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`。