Аватары

Аватары — персонажи, с которыми вы разговариваете. Питомцы (Pets) остаются косметическими спрайтами; при выборе питомца создаётся парный профиль аватара в <VIBEOS_HOME>/avatars/.

Установка спрайтов и жесты overlay — в Питомцах. Эта страница — про разговорный слой Avatar dialogue.

Что получаете

Возможность	Поведение
Текст на питомце	Preview в speech bubble; полный ответ в чате
Персона	Personality / system prompt через cache-safe ephemeral overlay
Голос ввод	Mic на overlay → STT → submit (работает и при выключенном auto-speak)
Голос вывод	TTS с voice preset, пока питомец виден (`display.avatar.auto_speak`)
Несколько аватаров	Cmd+K Avatars…, `/avatar`, Settings → Appearance → Pet
Мягкая память	Тег `avatar:<id>` по умолчанию; `memory=shared` — общий профиль
Talking-head	`off` \| `wave` \| `skill` (локальное talking-photo; опциональный vendor-плагин)
Hard Core (opt-in)	Отдельный Core в `memories/avatars/<id>/` — нужен `hard_memory` + `isolation=hard`

Быстрый старт

Выберите питомца (Settings → Pet или /pet <slug>).
Avatar с тем же id создаётся автоматически.
При необходимости задайте persona, voice, talking-head и memory.
Пишите из overlay composer или обычного чата при видимом pet.
Слушайте ответы при включённом Auto-speak; mic доступен всегда.

Команды

/avatar list
/avatar <id>
/avatar none
/avatar create boba pet=boba personality=concise voice=edge:en-US-AriaNeural
/avatar update boba talking-head=skill memory=shared

Поля: pet=, name=, personality=, voice=, memory=, talking-head=, portrait=.

Режимы talking-head

Режим	Поведение
`wave`	Celebrate/jump питомца во время TTS
`off`	Без celebrate / clip
`skill`	Локальное talking-photo (TTS + ffmpeg); при сбое — TTS + toast
Prefer vendor (opt-in)	При `prefer_vendor: true` сначала user-plugin `talking_head_vendor_render`, иначе ffmpeg

vibeos skills install official/creative/talking-head

Vendor lip-sync (standalone plugin)

Vendor SaaS остаётся вне дерева plugins/ репозитория. Только ~/.vibeos/plugins/:

bash scripts/scaffold-talking-head-vendor-plugin.sh

Ключи в ~/.vibeos/.env: TALKING_HEAD_VENDOR_API_KEY, TALKING_HEAD_VENDOR_BASE_URL.
Реализуйте HTTP-клиент в scaffolded __init__.py.
Режим skill + Prefer vendor в Settings (или prefer_vendor: true).
Офлайн-проверка проводки: TALKING_HEAD_VENDOR_MOCK=1 (backend: mock-vendor — не настоящий lip-sync).

Встроенные клипы честно помечены как talking-photo (ffmpeg-still), пока vendor-tool не завершится успешно.

Конфиг

display:
  avatar:
    enabled: false
    id: ""
    auto_speak: true
    hard_memory: false
    talking_head:
      enabled: true
      mode: wave
      portrait_path: ""
      prefer_vendor: false

Проверка

bash scripts/smoke-avatar-dialogue.sh

Что получаете​

Быстрый старт​

Команды​

Режимы talking-head​

Vendor lip-sync (standalone plugin)​

Конфиг​

Проверка​

См. также​