# 🔄 Восстановление Hermes Agent из бекапа

> **Файл бекапа:** `~/Desktop/hermes-v0.10.0-backup.tar.gz`  
> **Версия:** v0.10.0 (2026.4.16)  
> **Создан:** 14 июня 2026  
> **Размер:** 309 MB  

---

## Содержимое бекапа

```
.hermes/
├── config.yaml          # Конфигурация (провайдеры, модели, инструменты)
├── .env                 # API-ключи (OpenRouter, Telegram и т.д.)
├── hermes-agent/        # Исходный код Hermes + зависимости
├── skills/              # Все установленные скиллы (20MB)
├── memories/            # Persistent memory (user profile + notes)
├── state.db             # Сессии и история разговоров (81MB)
├── sessions/            # Архив сессий (326MB)
├── auth.json            # Токены авторизации
├── cron/                # Запланированные задачи
├── scripts/             # Пользовательские скрипты
├── plugins/             # Плагины
├── data/                # Данные
├── SOUL.md              # «Душа» агента
├── launch.sh            # Скрипт запуска
├── channel_directory.json  # Каналы связи
├── gateway_state.json   # Состояние гейтвея
└── backups/             # Предыдущие бекапы (461MB)
```

---

## 🔧 Полное восстановление

### Если Hermes не установлен

```bash
# 1. Распаковать бекап в домашнюю папку
cd ~
tar xzf ~/Desktop/hermes-v0.10.0-backup.tar.gz

# 2. Создать виртуальное окружение и установить зависимости
cd ~/.hermes/hermes-agent
python3.11 -m venv .venv --without-pip
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync --frozen

# 3. Проверить
~/.hermes/hermes-agent/.venv/bin/hermes --version
# Должно показать: Hermes Agent v0.10.0 (2026.4.16)
```

### Если Hermes уже стоит — замена

```bash
# 1. Сохранить старую версию (на всякий случай)
mv ~/.hermes ~/.hermes.old

# 2. Распаковать бекап
cd ~
tar xzf ~/Desktop/hermes-v0.10.0-backup.tar.gz

# 3. Пересоздать venv (если нужно)
cd ~/.hermes/hermes-agent
rm -rf .venv
python3.11 -m venv .venv --without-pip
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync --frozen

# 4. Запустить
~/.hermes/hermes-agent/.venv/bin/hermes chat
```

---

## 🧪 Проверка после восстановления

### 1. Версия
```bash
~/.hermes/hermes-agent/.venv/bin/hermes --version
```
✅ Должно быть: `Hermes Agent v0.10.0 (2026.4.16)`

### 2. Конфигурация
```bash
cat ~/.hermes/config.yaml | head -20
```
✅ Должны быть: провайдер `opencode-go`, модель `deepseek-v4-flash`

### 3. API-ключи
```bash
cat ~/.hermes/.env | grep -E "OPENCODE|TELEGRAM"
```
✅ Должны быть: `OPENCODE_GO_API_KEY`, `TELEGRAM_BOT_TOKEN`, и т.д.

### 4. Скиллы
```bash
ls ~/.hermes/skills/ | wc -l
```
✅ Должно быть ~40+ скиллов (число может отличаться)

### 5. Память
```bash
# Запустить Hermes в режиме CLI и проверить /memory
~/.hermes/hermes-agent/.venv/bin/hermes chat
# Внутри чата: /memory
# Должны быть: user profile + заметки о проектах (YachtGs, ESP32, флот и т.д.)
```

### 6. Gateway (Telegram)
```bash
~/.hermes/hermes-agent/.venv/bin/hermes gateway run
```
✅ Должен запуститься без ошибок, бот в Telegram отвечает

### 7. Сессии
```bash
ls ~/.hermes/state.db
```
✅ Файл существует (81MB) — вся история на месте

### 8. Cron (если есть задачи)
```bash
cat ~/.hermes/cron/jobs.json
```
✅ Запланированные задачи на месте

---

## 📁 Структура скиллов

Скиллы лежат в `~/.hermes/skills/` и организованы по категориям:

```
skills/
├── android/
├── apple/
├── autonomous-ai-agents/
├── brainstorming/
├── code-reviewer/
├── creative/
├── data-science/
├── devops/
├── hardware/
├── hermes-agent/
├── incident-commander/
├── marketing/
├── media/
├── mlops/
├── n8n-code-javascript/
├── n8n-code-python/
├── note-taking/
├── seo/
├── social-media/
├── software-development/
├── speech-to-text/
├── telegram/
├── vision-analysis/
├── voice-transcription/
├── writing/
└── ...
```

**Как добавить скилл:** положить .md файл в нужную папку или через `/skills install` в чате.

---

## ⚠️ Важные заметки

1. **Python 3.11 обязателен** — Hermes v0.10.0 не работает на 3.12/3.13
2. **API-ключи** — если восстанавливаете на другом компьютере, проверьте `.env`
3. **Telegram bot token** — если токен сменился, обновите в `config.yaml` и `.env`
4. **state.db** — если не нужна старая история, можно удалить (Hermes создаст новую)
5. **Зависимости** — `uv sync --frozen` устанавливает всё необходимое из `uv.lock`

---

## 🚀 Быстрый старт после восстановления

```bash
# Просто запустить чат
cd ~/.hermes/hermes-agent
source .venv/bin/activate
hermes chat
```

Или с Telegram-ботом:
```bash
hermes gateway run
```

---

*Документация создана 14 июня 2026 для Hermes Agent v0.10.0*