Скины и темы

Скины управляют визуальным представлением Hermes CLI: цвета баннера, лица и глаголы спиннера, метки полей ответа, текст брендинга и префикс активности инструментов.

Разговорный стиль и визуальный стиль — это разные концепции:

• Личность (Personality) меняет тон и формулировки агента.

• Скин (Skin) меняет внешний вид CLI.

Смена скинов

/skin                # show the current skin and list available skins
/skin ares           # switch to a built-in skin
/skin mytheme        # switch to a custom skin from ~/.hermes/skins/mytheme.yaml

Или укажите скин по умолчанию в ~/.hermes/config.yaml:

display:
  skin: default

Встроенные скины

Полный список настраиваемых ключей

Цвета (colors:)

Управляет всеми цветовыми значениями в CLI. Значения — строки с hex-кодами цветов.

Спиннер (spinner:)

Управляет анимированным спиннером, отображаемым в ожидании ответа от API.

Когда значения спиннера пусты (как в default и mono), используются жёстко заданные значения по умолчанию из display.py.

Брендинг (branding:)

Текстовые строки, используемые в интерфейсе CLI.

Другие ключи верхнего уровня

Пользовательские скины

Создавайте YAML-файлы в ~/.hermes/skins/. Пользовательские скины наследуют недостающие значения от встроенного скина default, поэтому вам нужно указать только те ключи, которые вы хотите изменить.

Полный шаблон YAML пользовательского скина

# ~/.hermes/skins/mytheme.yaml
# Complete skin template — all keys shown. Delete any you don't need;
# missing values automatically inherit from the 'default' skin.

name: mytheme
description: My custom theme

colors:
  banner_border: "#CD7F32"
  banner_title: "#FFD700"
  banner_accent: "#FFBF00"
  banner_dim: "#B8860B"
  banner_text: "#FFF8DC"
  ui_accent: "#FFBF00"
  ui_label: "#4dd0e1"
  ui_ok: "#4caf50"
  ui_error: "#ef5350"
  ui_warn: "#ffa726"
  prompt: "#FFF8DC"
  input_rule: "#CD7F32"
  response_border: "#FFD700"
  session_label: "#DAA520"
  session_border: "#8B8682"
  status_bar_bg: "#1a1a2e"
  voice_status_bg: "#1a1a2e"
  selection_bg: "#333355"
  completion_menu_bg: "#1a1a2e"
  completion_menu_current_bg: "#333355"
  completion_menu_meta_bg: "#1a1a2e"
  completion_menu_meta_current_bg: "#333355"

spinner:
  waiting_faces:
    - "(⚔)"
    - "(⛨)"
    - "(▲)"
  thinking_faces:
    - "(⚔)"
    - "(⌁)"
    - "(<>)"
  thinking_verbs:
    - "processing"
    - "analyzing"
    - "computing"
    - "evaluating"
  wings:
    - ["⟪⚡", "⚡⟫"]
    - ["⟪●", "●⟫"]

branding:
  agent_name: "My Agent"
  welcome: "Welcome to My Agent! Type your message or /help for commands."
  goodbye: "See you later! ⚡"
  response_label: " ⚡ My Agent "
  prompt_symbol: "⚡"
  help_header: "(⚡) Available Commands"

tool_prefix: "┊"

# Per-tool emoji overrides (optional)
tool_emojis:
  terminal: "⚔"
  web_search: "🔮"
  read_file: "📄"

# Custom ASCII art banners (optional, Rich markup supported)
# banner_logo: |
#   [bold #FFD700] MY AGENT [/]
# banner_hero: |
#   [#FFD700]  Custom art here  [/]

Минимальный пример пользовательского скина

Поскольку всё наследуется от default, минимальный скин нужно изменить только то, что отличается:

name: cyberpunk
description: Neon terminal theme

colors:
  banner_border: "#FF00FF"
  banner_title: "#00FFFF"
  banner_accent: "#FF1493"

spinner:
  thinking_verbs: ["jacking in", "decrypting", "uploading"]
  wings:
    - ["⟨⚡", "⚡⟩"]

branding:
  agent_name: "Cyber Agent"
  response_label: " ⚡ Cyber "

tool_prefix: "▏"

Hermes Mod — Визуальный редактор скинов

Hermes Mod — это веб-интерфейс, созданный сообществом, для визуального создания и управления скинами. Вместо написания YAML вручную вы получаете редактор с графическим интерфейсом и предварительным просмотром в реальном времени.

Что он делает:

• Показывает все встроенные и пользовательские скины

• Открывает любой скин в визуальном редакторе со всеми полями скинов Hermes (цвета, спиннер, брендинг, префикс инструментов, эмодзи инструментов)

• Генерирует текстовый арт banner_logo из текстового запроса

• Преобразует загруженные изображения (PNG, JPG, GIF, WEBP) в ASCII-арт banner_hero с несколькими стилями рендеринга (шрифт Брайля, ASCII-градиент, блоки, точки)

• Сохраняет напрямую в ~/.hermes/skins/

• Активирует скин, обновляя ~/.hermes/config.yaml

• Показывает сгенерированный YAML и предварительный просмотр

Установка

Вариант 1 — Pinokio (в 1 клик):

Найдите его на pinokio.computer и установите одним нажатием.

Вариант 2 — npx (быстрее всего из терминала):

npx -y hermes-mod

Вариант 3 — Вручную:

git clone https://github.com/cocktailpeanut/hermes-mod.git
cd hermes-mod/app
npm install
npm start

Использование

1. Запустите приложение (через Pinokio или терминал).

2. Откройте Skin Studio.

3. Выберите встроенный или пользовательский скин для редактирования.

4. Сгенерируйте логотип из текста и/или загрузите изображение для главного арта. Выберите стиль рендеринга и ширину.

5. Отредактируйте цвета, спиннер, брендинг и другие поля.

6. Нажмите Сохранить, чтобы записать YAML скина в ~/.hermes/skins/.

7. Нажмите Активировать, чтобы установить его как текущий скин (обновляет display.skin в config.yaml).

Hermes Mod учитывает переменную окружения HERMES_HOME, поэтому он работает и с профилями.

Эксплуатационные заметки

• Встроенные скины загружаются из hermes_cli/skin_engine.py.

• Неизвестные скины автоматически используют запасной вариант default.

• /skin мгновенно обновляет активную тему CLI для текущей сессии.

• Пользовательские скины в ~/.hermes/skins/ имеют приоритет над встроенными скинами с таким же именем.

• Изменения скина через /skin действуют только в рамках сессии. Чтобы сделать скин постоянным по умолчанию, укажите его в config.yaml.

• Поля banner_logo и banner_hero поддерживают Rich-разметку консоли (например, [bold #FF0000]text[/]) для цветного ASCII-арта.