Mesh Avatar Studio CLI
Из одной иллюстрации агент собирает анимированный 2D-аватар, моргающий и говорящий, а вы доводите его в локальном редакторе
- 1 874 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Codex запускается с `--approve-for-me`: его запросы на запуск инструментов вне песочницы проверяются автоматически, без вашего решения
- Иллюстрация и маски уходят в OpenAI при рисовании вариантов глаз и рта
- Страница Live получает доступ к камере и микрофону браузера
Установка
- Работает в
Ручная установка
npx create-mesh-avatar-studioСкачивает репозиторий, ставит пакеты и проверяет инструменты. Дальше `cd mesh-avatar-studio` и `npm run dev`. Нужны Node.js 22.17+ и Git.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Codex запускается с `--approve-for-me`: его запросы на запуск инструментов вне песочницы проверяются автоматически, без вашего решения
- Иллюстрация и маски уходят в OpenAI при рисовании вариантов глаз и рта
- Страница Live получает доступ к камере и микрофону браузера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mesh Avatar Studio превращает одну иллюстрацию в 2D-аватар на сетке деформации: он моргает, говорит, поворачивает голову, дышит и качает волосами. Работа делится на четыре шага. Первый и четвертый выполняет агент (Claude Code или Codex) в папке репозитория по инструкции `docs/agent-guide.md`: размечает слои на увеличенных сетках, режет изображение и проверяет аватар в фиксированных позах. Второй и третий шаги вы делаете в редакторе: открываете проект и тянете точки на картинке, превью обновляется сразу. Попробовать можно на встроенном образце командами `npx create-mesh-avatar-studio`, затем `npm run dev`. С установленным Codex CLI одна команда `npm run create -- /path/to/your-image.png` создает проект без вопросов и открывает редактор. Codex дорисовывает закрытые глаза, формы рта и выражения через генерацию изображений OpenAI, Claude Code этого не умеет и готовит маски и подсказки для сторонней модели. Готовый аватар выгружают одним файлом `.mavatar` вместе с исходником или без него. Страница Live ведет аватар по вашей камере и микрофону, а адрес для OBS Browser Source дает прозрачный фон для стрима. Есть и Player в браузере, он работает без установки.
Для кого. Для стримеров, авторов и разработчиков, которым нужен анимированный аватар из собственной иллюстрации без ручной настройки сетки в специальных программах.
Подходит, если
- Есть арт персонажа, и нужен аватар, который моргает и говорит под ваш голос для стрима в OBS
- Нужно быстро проверить, как рисунок оживает: встроенный образец Miko запускается за пару команд
- Аватар надо передать коллеге одним файлом `.mavatar` с исходником для дальнейшего редактирования
- Агент должен разметить слои сам, а вы только поправите точки, которые стоят неверно
- Нужен аватар в видеозвонке Zoom или Meet через виртуальную камеру OBS
Не подходит, если
- Вам нужна трехмерная модель или полный скелет тела: проект собирает 2D-сетку, а отслеживание тела отмечено как экспериментальное
- Исходный рисунок не анфас или с неразделимым фоном: лучше всего подходит портрет по плечи на прозрачном фоне
- Нельзя отправлять изображения во внешние сервисы: рисованные варианты глаз и рта требуют отправки в OpenAI
Пример запроса к агенту
Создай аватар из этого изображения по docs/agent-guide.md: /path/to/your-image.pngОграничения
- Нужны Node.js 22.17 и новее и Git. Для пересборки слоев нужны uv и Python, для проверки движения при создании аватара агентом нужен Chromium из Playwright. Команда `npm run doctor` предупреждает о каждом отсутствующем.
- Рисованные глаза, рот и выражения делает только Codex, он отправляет изображение и маски в OpenAI. Команда спрашивает согласие, ключ `--yes` соглашается заранее, а `--no-variants` оставляет все на вашей машине. Создание занимает десятки минут.
- Codex запускается с `--approve-for-me`, поэтому его запросы на запуск инструментов вне песочницы, например Chromium для проверки поз, одобряются автоматически, без вашего участия.
- Отслеживание тела по веб-камере экспериментальное и покачивается сильнее лица, особенно на юбках и ткани. Рекомендованные автором модели: Claude Opus 5.5 и GPT-6.1 Sol.
Как отключить. Удалите папку репозитория `mesh-avatar-studio` вместе с `projects/`, там лежат ваши проекты, сохраните нужные файлы `.mavatar` заранее. Глобально ничего не устанавливается, `npx` только скачивает пакет `create-mesh-avatar-studio`.
Частые вопросы
Как попробовать Mesh Avatar Studio?
Выполните `npx create-mesh-avatar-studio`, перейдите в папку `mesh-avatar-studio` и запустите `npm run dev`. Откроется редактор со встроенным образцом Miko. Образец только для чтения, при правке редактор предложит сохранить копию.
Нужен ли Codex, или хватит Claude Code?
Аватар собирают оба. Рисованные закрытые глаза, формы рта и выражения умеет только Codex, потому что у него есть встроенная генерация изображений. Claude Code готовит для этого маски и подсказки, которые вы отдаете стороннему генератору.
Какое изображение лучше подходит?
Портрет анфас по плечи в формате PNG на прозрачном фоне. Агент размечает слои по рисунку, поэтому чем чище исходник, тем меньше правок в редакторе.
Как вывести аватар в OBS?
Откройте проект в редакторе, выберите Live, включите камеру и нажмите Calibrate, затем Copy OBS URL и добавьте адрес как Browser Source. Страницу Live держите открытой в отдельном окне. Прозрачный фон работает в OBS напрямую.
Можно ли работать без установки?
Да, Player в браузере (Chrome или Edge) запускает отслеживание лица, синхронизацию губ по микрофону, выражения и свет. Откройте образец или свой файл `.mavatar`, он никуда не загружается.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТри скилла для Meshy CLI: агент делает 3D-модели по тексту и фото, текстурирует и готовит их к 3D-печати
Aseprite AI Artist — пиксель-арт через агента
Aseprite AI Artist
Плагин и MCP-сервер дают агенту рисовать и анимировать в уже открытом окне Aseprite, каждое действие откатывается одним Ctrl+Z
Motion Anything
motion-anything
Локальный чат-движок анимации: опишите ощущение, и агент выдаст анимацию, анимированные страницы и ролики. Без npm install, нужен Node 18 и ваш агент
Скилл для Cursor, Claude Code и Codex: по названию продукта или ссылке собирает 4K-ролик с музыкой, озвучкой и проверкой
Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер
Скилл собирает озвученный ролик в стиле бумажного коллажа из темы, видео с ведущим или одного фото
Коротко о README
README показывает путь от иллюстрации до стрима: проба образца, четыре шага создания аватара, обмен файлом `.mavatar`, режим Live с OBS и Player без установки. Дальше идут ссылки на справочник, формат файла и руководство для агента.