sidebar_position: 10 title: "Skins & Themes" description: "Customize the Hermes CLI with built-in and user-defined skins" lang: ru

Скины и темы

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

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

• Личность меняет тон и формулировку агента.
• Скин меняет внешний вид интерфейса командной строки.

Изменение скинов

/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. Значения представляют собой шестнадцатеричные цветовые строки.

Спиннер (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"
  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) в banner_hero ASCII-изображения с несколькими стилями рендеринга (Брайль, рампа ASCII, блоки, точки).
• Сохраняется непосредственно в ~/.hermes/skins/.
• Активирует скин обновлением ~/.hermes/config.yaml
• Показывает сгенерированный YAML и предварительный просмотр в реальном времени.

Установить

Вариант 1 — Пинокио (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 учитывает переменную среды HERMES_HOME, поэтому он работает и с профилями.

Операционные примечания

• Встроенная загрузка скинов от hermes_cli/skin_engine.py.
• Неизвестные скины автоматически возвращаются к default.
• /skin немедленно обновляет активную тему CLI для текущего сеанса.
• Пользовательские скины в ~/.hermes/skins/ имеют приоритет над встроенными скинами с тем же именем.
• Изменения скинов через /skin доступны только для сеанса. Чтобы сделать скин постоянным по умолчанию, установите его в config.yaml.
• Поля banner_logo и banner_hero поддерживают расширенную разметку консоли (например, [bold #FF0000]text[/]) для цветных изображений ASCII.