Upload 9 files

.github/workflows/deploy.yml

@@ -0,0 +1,88 @@
+name: Build and Deploy to Hugging Face Spaces
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  SPACE_REPOSITORY: ${{ secrets.HF_SPACE_REPO }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build Docker image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: false
+        tags: hermes-spaces:test
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Configure Git
+      run: |
+        git config --global user.name "GitHub Actions"
+        git config --global user.email "actions@github.com"
+
+    - name: Deploy to Hugging Face Spaces
+      env:
+        HF_TOKEN: ${{ secrets.HF_TOKEN }}
+      run: |
+        # Install Hugging Face CLI
+        pip install huggingface-hub
+
+        # Clone the Space repository
+        git clone https://user:$HF_TOKEN@huggingface.co/spaces/${{ secrets.HF_SPACE_REPO }} space-repo
+        
+        # Copy files to Space repository
+        cp -r . space-repo/
+        cd space-repo
+        
+        # Remove .git directory to avoid conflicts
+        rm -rf .git
+        
+        # Initialize git and push
+        git init
+        git add .
+        git commit -m "Deploy from GitHub Actions - $(date)"
+        git push --force https://user:$HF_TOKEN@huggingface.co/spaces/${{ secrets.HF_SPACE_REPO }} main
+
+    - name: Wait for Space to be ready
+      env:
+        HF_TOKEN: ${{ secrets.HF_TOKEN }}
+      run: |
+        echo "Waiting for Space to be ready..."
+        sleep 30
+        
+        # Check if Space is running
+        SPACE_URL="https://${{ secrets.HF_SPACE_REPO }}.hf.space/health"
+        for i in {1..10}; do
+          if curl -f $SPACE_URL > /dev/null 2>&1; then
+            echo "✅ Space is ready!"
+            exit 0
+          fi
+          echo "⏳ Waiting... ($i/10)"
+          sleep 10
+        done
+        
+        echo "⚠️ Space may not be fully ready yet, but deployment was successful"

.gitignore

@@ -0,0 +1,137 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Hermes specific
+.hermes/
+/data/
+/tmp/hermes_*/
+
+# Logs
+logs/
+*.log
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+.dockerignore
+
+# Hugging Face
+.hf_token

Dockerfile

@@ -0,0 +1,61 @@
+FROM python:3.11-slim
+
+LABEL maintainer="Hermes Agent Community"
+LABEL version="0.9.0"
+LABEL description="Hermes Agent v0.9.0 on Hugging Face Spaces with persistent storage"
+
+# 设置环境变量
+ENV PYTHONUNBUFFERED=1
+ENV DEBIAN_FRONTEND=noninteractive
+ENV HERMES_HOME=/data/.hermes
+ENV PYTHONPATH=/app
+
+# 安装系统依赖
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    nodejs \
+    npm \
+    ffmpeg \
+    git \
+    curl \
+    unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装 Python 依赖
+COPY requirements.txt /tmp/
+RUN pip install --no-cache-dir -r /tmp/requirements.txt
+
+# 安装 Hermes Agent [web] 包含 Dashboard 依赖
+RUN pip install --no-cache-dir hermes-agent[all,web]==0.9.0
+
+# 安装 Playwright（使用精简版以减小镜像体积）
+RUN npx playwright install chromium --with-deps --only-shell
+
+# 创建应用目录
+WORKDIR /app
+
+# 复制应用代码
+COPY src/ /app/src/
+COPY entrypoint.sh /app/
+
+# 创建数据目录
+RUN mkdir -p /data/.hermes && \
+    mkdir -p /app/logs && \
+    chmod +x /app/entrypoint.sh
+
+# 设置非 root 用户（Hugging Face Spaces 要求）
+RUN useradd -m -u 1000 appuser && \
+    chown -R appuser:appuser /data && \
+    chown -R appuser:appuser /app
+
+USER appuser
+
+# 暴露端口（Hugging Face Spaces 默认 7860）
+EXPOSE 7860
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD curl -f http://localhost:7860/health || exit 1
+
+# 启动脚本
+ENTRYPOINT ["/app/entrypoint.sh"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Hermes Agent Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,12 +1,213 @@
----
-title: Hermes
-emoji: 🏢
-colorFrom: green
-colorTo: red
-sdk: docker
-pinned: false
-license: apache-2.0
-short_description: agent
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Hermes Agent v0.9.0 on Hugging Face Spaces
+
+智能AI代理，支持16个消息平台，持久化记忆，和Web管理界面。
+
+## 功能
+
+- 🤖 AI 对话与工具调用
+- 🌐 Web Dashboard 管理
+- 💾 数据持久化到 Hugging Face Dataset
+- 🔔 支持消息网关（Telegram/Discord/Slack等）
+- ⚡ 自动唤醒保持在线
+
+## 技术栈
+
+- Hermes Agent v0.9.0
+- FastAPI Web Dashboard
+- Hugging Face Datasets 持久化
+- Docker Spaces
+
+## 数据目录映射
+
+| Hermes 目录 | Dataset 路径 | 说明 |
+|------------|-------------|------|
+| `~/.hermes/config.yaml` | `/config/config.yaml` | 核心配置 |
+| `~/.hermes/.env` | `/config/.env` | 环境变量 |
+| `~/.hermes/auth.json` | `/config/auth.json` | OAuth认证 |
+| `~/.hermes/SOUL.md` | `/personality/SOUL.md` | 代理人格 |
+| `~/.hermes/memories/` | `/memories/` | 持久记忆 |
+| `~/.hermes/skills/` | `/skills/` | 自定义技能 |
+| `~/.hermes/sessions/` | `/sessions/` | 会话历史 |
+| `~/.hermes/state.db` | `/state/state.db` | SQLite数据库 |
+| `~/.hermes/logs/` | `/logs/` | 日志文件 |
+| `~/.hermes/cron/` | `/cron/` | 定时任务 |
+
+## 环境变量
+
+```bash
+# 必需
+HF_DATASET_REPO=your-username/hermes-data
+
+# 可选
+HERMES_HOME=/data/.hermes
+SYNC_INTERVAL=300  # 同步间隔（秒）
+HF_TOKEN=your-huggingface-token  # 用于访问私有 dataset
+```
+
+## 快速开始
+
+### 1. 创建 Hugging Face Dataset
+
+```bash
+# 创建一个新的 dataset 用于存储数据
+huggingface-cli repo create hermes-data --type dataset
+```
+
+### 2. 设置环境变量
+
+在 Hugging Face Spaces 的 Settings 中设置：
+- `HF_DATASET_REPO`: 你的 dataset 名称 (例如: username/hermes-data)
+- `HF_TOKEN`: Hugging Face access token
+
+### 3. 配置唤醒服务
+
+使用 UptimeRobot 或 Cron-job.org 定期访问 Space URL 以保持在线。
+
+## 部署步骤
+
+### 部署到 Hugging Face Spaces
+
+#### 方式一：通过 Web 界面部署
+
+1. **创建 Space**: 访问 https://huggingface.co/new-space
+   - 选择 "Docker" SDK
+   - 设置 Space 名称
+   - 选择硬件配置（免费版即可开始）
+
+2. **克隆 Space 仓库**:
+```bash
+git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+cd YOUR_SPACE_NAME
+```
+
+3. **复制项目文件**:
+```bash
+# 复制所有项目文件到 Space 目录
+cp -r /path/to/hermes-spaces/* .
+```
+
+4. **配置环境变量**:
+   - 在 Space Settings → Variables 中设置:
+     - `HF_DATASET_REPO`: `your-username/hermes-data`
+     - `HF_TOKEN`: `your-huggingface-token`
+
+5. **提交并推送**:
+```bash
+git add .
+git commit -m "Initial deployment"
+git push
+```
+
+6. **等待部署完成**:
+   - 访问 `https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME`
+   - 查看 Build 日志，等待部署完成
+
+#### 方式二：通过 GitHub Actions 自动部署
+
+1. **Fork 本仓库** 到你的 GitHub 账号
+
+2. **在 Hugging Face 创建 Space**:
+   - 访问 https://huggingface.co/new-space
+   - 选择 Docker SDK
+   - 记下 Space 名称
+
+3. **配置 GitHub Secrets**:
+   - 进入 GitHub 仓库 → Settings → Secrets and variables → Actions
+   - 添加以下 secrets:
+     - `HF_TOKEN`: 你的 Hugging Face access token
+     - `HF_SPACE_REPO`: `YOUR_USERNAME/YOUR_SPACE_NAME`
+
+4. **推送代码到 main 分支**:
+```bash
+git push origin main
+```
+
+5. **GitHub Actions 会自动部署**:
+   - 查看 Actions 标签页查看部署进度
+   - 部署完成后访问 Space URL
+
+## 配置唤醒服务
+
+由于 Hugging Face Spaces 免费版会在 48 小时无活动后休眠，建议配置外部唤醒服务：
+
+### 使用 UptimeRobot（推荐）
+
+1. 访问 https://uptimerobot.com 并注册账号
+2. 点击 "Add New Monitor"
+3. 配置如下：
+   - **Monitor Type**: HTTP(s)
+   - **Friendly Name**: Hermes Agent
+   - **URL**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health`
+   - **Monitoring Interval**: 5 minutes
+4. 点击 "Create Monitor"
+
+### 使用 Cron-job.org（备选）
+
+1. 访问 https://cron-job.org
+2. 创建新的 cron job
+3. 配置 URL: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health`
+4. 设置每 5 分钟执行一次
+
+## 首次使用
+
+1. 访问 Space URL: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space`
+2. 首次启动会创建默认配置，从 Dataset 恢复数据（如果存在）
+3. 在 Web Dashboard 中配置：
+   - API Keys（OpenAI, OpenRouter, etc.）
+   - 消息网关（Telegram, Discord, etc.）
+   - 代理人格（SOUL.md）
+
+## 故障排除
+
+### Space 无法启动
+
+1. **检查构建日志**:
+   - 访问 Space 页面 → Files → "Build logs"
+   - 查看错误信息
+
+2. **常见问题**:
+   - **内存不足**: 升级到付费硬件（CPU Upgrade）
+   - **依赖安装失败**: 检查 requirements.txt 格式
+   - **权限错误**: 确保 Dockerfile 中设置了 USER appuser
+
+### 数据未持久化
+
+1. **检查环境变量**:
+   - 确认 `HF_DATASET_REPO` 已正确设置
+   - 确认 `HF_TOKEN` 有写入 Dataset 的权限
+
+2. **检查 Dataset 权限**:
+   - 确保 Dataset 是私有的（推荐）
+   - 确保 Token 有 `write` 权限
+
+3. **查看同步日志**:
+   - 在 Space 的 Logs 中查看 data-sync 相关日志
+
+### 消息网关断开
+
+1. **这是正常现象**: Spaces 休眠后所有连接会断开
+2. **解决方案**:
+   - 升级到付费版保持持续运行
+   - 或配置网关自动重连（在 Hermes 配置中设置）
+
+## 文件说明
+
+- `Dockerfile` - Docker 镜像定义
+- `entrypoint.sh` - 容器启动脚本
+- `requirements.txt` - Python 依赖
+- `src/data_sync.py` - 数据同步服务
+- `.github/workflows/deploy.yml` - GitHub Actions 自动部署
+
+## 许可证
+
+MIT License - 详见 LICENSE 文件
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 相关链接
+
+- [Hermes Agent 官方仓库](https://github.com/NousResearch/hermes-agent)
+- [Hugging Face Spaces 文档](https://huggingface.co/docs/hub/spaces-overview)
+- [Hermes Agent 文档](https://hermes-agent.com)

entrypoint.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# Entrypoint script for Hermes Agent on Hugging Face Spaces
+
+set -e
+
+echo "🚀 Hermes Agent v0.9.0 - Hugging Face Spaces"
+echo "=============================================="
+
+# 检查必要的环境变量
+if [ -z "$HF_DATASET_REPO" ]; then
+    echo "⚠️  警告: HF_DATASET_REPO 未设置，数据将不会持久化到 Dataset"
+    echo "   设置方式: export HF_DATASET_REPO=your-username/hermes-data"
+fi
+
+# 创建必要的目录
+echo "📁 初始化目录结构..."
+mkdir -p /data/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
+mkdir -p /app/logs
+
+# 从 Dataset 恢复数据（如果配置了）
+if [ -n "$HF_DATASET_REPO" ]; then
+    echo "📥 从 Dataset 恢复数据..."
+    python -m src.data_sync restore || {
+        echo "⚠️  数据恢复失败，使用空配置启动"
+        echo "   首次运行时会创建新的配置文件"
+    }
+fi
+
+# 设置同步间隔（默认5分钟）
+SYNC_INTERVAL=${SYNC_INTERVAL:-300}
+echo "🔄 数据同步间隔: ${SYNC_INTERVAL}秒"
+
+# 启动后台数据同步服务（守护进程模式）
+echo "🔄 启动数据同步服务..."
+python -m src.data_sync daemon &
+SYNC_PID=$!
+echo "   同步服务 PID: $SYNC_PID"
+
+# 注册优雅关闭处理函数
+cleanup() {
+    echo ""
+    echo "🛑 收到关闭信号，执行清理..."
+    
+    # 停止数据同步服务
+    if kill -0 $SYNC_PID 2>/dev/null; then
+        echo "   停止数据同步服务..."
+        kill $SYNC_PID 2>/dev/null || true
+        wait $SYNC_PID 2>/dev/null || true
+    fi
+    
+    # 执行最终备份
+    if [ -n "$HF_DATASET_REPO" ]; then
+        echo "   执行最终数据备份..."
+        python -m src.data_sync backup --force || echo "   备份失败"
+    fi
+    
+    echo "👋 再见！"
+    exit 0
+}
+
+trap cleanup SIGTERM SIGINT
+
+echo ""
+echo "🌐 启动 Hermes Web Dashboard..."
+echo "   访问地址: http://localhost:7860"
+echo "   健康检查: http://localhost:7860/health"
+echo ""
+
+# 启动 Hermes Web Dashboard
+exec hermes web --host 0.0.0.0 --port 7860 --no-open

requirements.txt

@@ -0,0 +1,24 @@
+# Hermes Agent on Hugging Face Spaces
+# Python 依赖
+
+# 核心依赖
+huggingface-hub>=0.20.0
+datasets>=2.14.0
+requests>=2.31.0
+pydantic>=2.0.0
+python-dotenv>=1.0.0
+
+# 数据处理和加密
+cryptography>=41.0.0
+
+# 日志和监控
+loguru>=0.7.0
+psutil>=5.9.0
+
+# 异步支持
+aiohttp>=3.9.0
+aiocron>=1.8
+
+# 工具
+click>=8.1.0
+rich>=13.0.0

src/data_sync.py

@@ -0,0 +1,279 @@
+#!/usr/bin/env python3
+"""
+Hermes Agent Data Sync Service
+Handles data persistence to/from Hugging Face Dataset
+"""
+
+import os
+import sys
+import time
+import json
+import shutil
+import tarfile
+import argparse
+from pathlib import Path
+from datetime import datetime
+from typing import Optional, Dict, List
+
+from huggingface_hub import HfApi, hf_hub_download, upload_folder
+from loguru import logger
+
+
+class DatasetManager:
+    """Manages data synchronization with Hugging Face Dataset"""
+    
+    def __init__(self, dataset_repo: Optional[str] = None, token: Optional[str] = None):
+        self.dataset_repo = dataset_repo or os.environ.get('HF_DATASET_REPO')
+        self.token = token or os.environ.get('HF_TOKEN') or os.environ.get('HUGGING_FACE_HUB_TOKEN')
+        self.api = HfApi(token=self.token)
+        self.hermes_home = Path(os.environ.get('HERMES_HOME', '/data/.hermes'))
+        self.temp_dir = Path('/tmp/hermes_sync')
+        
+        # 数据路径映射
+        self.path_mapping = {
+            'config': self.hermes_home / 'config.yaml',
+            'env': self.hermes_home / '.env',
+            'auth': self.hermes_home / 'auth.json',
+            'soul': self.hermes_home / 'SOUL.md',
+            'memories': self.hermes_home / 'memories',
+            'skills': self.hermes_home / 'skills',
+            'sessions': self.hermes_home / 'sessions',
+            'state_db': self.hermes_home / 'state.db',
+            'logs': self.hermes_home / 'logs',
+            'cron': self.hermes_home / 'cron',
+        }
+        
+    def validate(self) -> bool:
+        """验证配置是否正确"""
+        if not self.dataset_repo:
+            logger.error("HF_DATASET_REPO not set")
+            return False
+        
+        if not self.token:
+            logger.warning("HF_TOKEN not set, will try public dataset")
+            
+        return True
+    
+    def prepare_backup_data(self) -> Path:
+        """准备备份数据到临时目录"""
+        logger.info("Preparing backup data...")
+        
+        # 清理并创建临时目录
+        if self.temp_dir.exists():
+            shutil.rmtree(self.temp_dir)
+        self.temp_dir.mkdir(parents=True)
+        
+        # 创建目录结构
+        (self.temp_dir / 'config').mkdir()
+        (self.temp_dir / 'personality').mkdir()
+        (self.temp_dir / 'memories').mkdir()
+        (self.temp_dir / 'skills').mkdir()
+        (self.temp_dir / 'sessions').mkdir()
+        (self.temp_dir / 'state').mkdir()
+        (self.temp_dir / 'logs').mkdir()
+        (self.temp_dir / 'cron').mkdir()
+        
+        # 复制文件
+        try:
+            # 配置文件
+            if self.path_mapping['config'].exists():
+                shutil.copy2(self.path_mapping['config'], self.temp_dir / 'config' / 'config.yaml')
+            
+            # 环境变量（敏感信息）
+            if self.path_mapping['env'].exists():
+                shutil.copy2(self.path_mapping['env'], self.temp_dir / 'config' / '.env')
+            
+            # OAuth 认证
+            if self.path_mapping['auth'].exists():
+                shutil.copy2(self.path_mapping['auth'], self.temp_dir / 'config' / 'auth.json')
+            
+            # 人格定义
+            if self.path_mapping['soul'].exists():
+                shutil.copy2(self.path_mapping['soul'], self.temp_dir / 'personality' / 'SOUL.md')
+            
+            # 记忆
+            if self.path_mapping['memories'].exists():
+                shutil.copytree(self.path_mapping['memories'], self.temp_dir / 'memories', dirs_exist_ok=True)
+            
+            # 技能
+            if self.path_mapping['skills'].exists():
+                shutil.copytree(self.path_mapping['skills'], self.temp_dir / 'skills', dirs_exist_ok=True)
+            
+            # 会话
+            if self.path_mapping['sessions'].exists():
+                shutil.copytree(self.path_mapping['sessions'], self.temp_dir / 'sessions', dirs_exist_ok=True)
+            
+            # 数据库
+            if self.path_mapping['state_db'].exists():
+                shutil.copy2(self.path_mapping['state_db'], self.temp_dir / 'state' / 'state.db')
+            
+            # 日志
+            if self.path_mapping['logs'].exists():
+                shutil.copytree(self.path_mapping['logs'], self.temp_dir / 'logs', dirs_exist_ok=True)
+            
+            # 定时任务
+            if self.path_mapping['cron'].exists():
+                shutil.copytree(self.path_mapping['cron'], self.temp_dir / 'cron', dirs_exist_ok=True)
+            
+            # 添加元数据
+            metadata = {
+                'timestamp': datetime.now().isoformat(),
+                'version': '0.9.0',
+                'hermes_home': str(self.hermes_home)
+            }
+            with open(self.temp_dir / 'metadata.json', 'w') as f:
+                json.dump(metadata, f, indent=2)
+            
+            logger.success(f"Backup prepared at {self.temp_dir}")
+            return self.temp_dir
+            
+        except Exception as e:
+            logger.error(f"Failed to prepare backup: {e}")
+            raise
+    
+    def upload_to_dataset(self, force: bool = False) -> bool:
+        """上传数据到 Hugging Face Dataset"""
+        try:
+            backup_dir = self.prepare_backup_data()
+            
+            logger.info(f"Uploading to dataset: {self.dataset_repo}")
+            
+            # 上传文件夹到 dataset
+            self.api.upload_folder(
+                folder_path=str(backup_dir),
+                repo_id=self.dataset_repo,
+                repo_type="dataset",
+                commit_message=f"Hermes Agent backup - {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}"
+            )
+            
+            logger.success("Backup uploaded successfully")
+            return True
+            
+        except Exception as e:
+            logger.error(f"Failed to upload to dataset: {e}")
+            return False
+    
+    def download_from_dataset(self) -> bool:
+        """从 Hugging Face Dataset 下载数据"""
+        try:
+            logger.info(f"Downloading from dataset: {self.dataset_repo}")
+            
+            # 创建临时下载目录
+            download_dir = Path('/tmp/hermes_download')
+            if download_dir.exists():
+                shutil.rmtree(download_dir)
+            download_dir.mkdir(parents=True)
+            
+            # 下载所有文件
+            self.api.snapshot_download(
+                repo_id=self.dataset_repo,
+                repo_type="dataset",
+                local_dir=str(download_dir)
+            )
+            
+            logger.success("Download completed")
+            
+            # 恢复数据到 Hermes 目录
+            self.restore_from_download(download_dir)
+            return True
+            
+        except Exception as e:
+            logger.error(f"Failed to download from dataset: {e}")
+            return False
+    
+    def restore_from_download(self, download_dir: Path):
+        """从下载的目录恢复数据"""
+        logger.info("Restoring data to Hermes home...")
+        
+        # 确保目标目录存在
+        self.hermes_home.mkdir(parents=True, exist_ok=True)
+        
+        # 恢复各个部分
+        restore_mapping = {
+            'config/config.yaml': self.path_mapping['config'],
+            'config/.env': self.path_mapping['env'],
+            'config/auth.json': self.path_mapping['auth'],
+            'personality/SOUL.md': self.path_mapping['soul'],
+            'memories': self.path_mapping['memories'],
+            'skills': self.path_mapping['skills'],
+            'sessions': self.path_mapping['sessions'],
+            'state/state.db': self.path_mapping['state_db'],
+            'logs': self.path_mapping['logs'],
+            'cron': self.path_mapping['cron'],
+        }
+        
+        for src_rel, dst in restore_mapping.items():
+            src = download_dir / src_rel
+            if src.exists():
+                try:
+                    if src.is_file():
+                        dst.parent.mkdir(parents=True, exist_ok=True)
+                        shutil.copy2(src, dst)
+                        logger.info(f"Restored: {src_rel}")
+                    elif src.is_dir():
+                        if dst.exists():
+                            shutil.rmtree(dst)
+                        shutil.copytree(src, dst)
+                        logger.info(f"Restored directory: {src_rel}")
+                except Exception as e:
+                    logger.error(f"Failed to restore {src_rel}: {e}")
+            else:
+                logger.warning(f"Not found in backup: {src_rel}")
+        
+        logger.success("Data restoration completed")
+
+
+def run_daemon():
+    """后台守护进程模式 - 定期同步"""
+    logger.info("Starting data sync daemon...")
+    
+    sync_interval = int(os.environ.get('SYNC_INTERVAL', '300'))  # 默认5分钟
+    manager = DatasetManager()
+    
+    if not manager.validate():
+        logger.error("Configuration invalid, exiting")
+        sys.exit(1)
+    
+    logger.info(f"Sync interval: {sync_interval} seconds")
+    
+    while True:
+        try:
+            time.sleep(sync_interval)
+            logger.info("Performing scheduled backup...")
+            manager.upload_to_dataset()
+        except KeyboardInterrupt:
+            logger.info("Daemon stopped")
+            break
+        except Exception as e:
+            logger.error(f"Sync error: {e}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Hermes Agent Data Sync')
+    parser.add_argument('action', choices=['backup', 'restore', 'daemon'],
+                       help='Action to perform')
+    parser.add_argument('--force', '-f', action='store_true',
+                       help='Force backup even if no changes')
+    
+    args = parser.parse_args()
+    
+    manager = DatasetManager()
+    
+    if not manager.validate():
+        logger.error("Configuration invalid")
+        sys.exit(1)
+    
+    if args.action == 'backup':
+        success = manager.upload_to_dataset(force=args.force)
+        sys.exit(0 if success else 1)
+    
+    elif args.action == 'restore':
+        success = manager.download_from_dataset()
+        sys.exit(0 if success else 1)
+    
+    elif args.action == 'daemon':
+        run_daemon()
+
+
+if __name__ == '__main__':
+    main()