FacePoke

заголовок	смайлик	цветОт	цветTo	SDK	закрепленный	лицензия	заголовок	файл_приложения	app_port	отключить_вложение	короткое_описание
FacePoke	?‍ ↔️ ?	желтый	красный	докер	истинный	мит	мини	app.py	8080	истинный	Импортируйте портрет, нажмите, чтобы переместить голову!

FacePoke

Оглавление

• Введение
• Благодарности
• Установка
  • Локальная установка
  • Развертывание Докера
• Разработка
• Содействие
• Лицензия

Введение

Приложение для трансформации головы в реальном времени.

Для достижения максимальной производительности запустите приложение со своего компьютера (локального или в облаке).

Репозиторий : GitHub — jbilcke-hf/FacePoke.

Вы можете попробовать демо-версию, но это общее пространство, задержка может быть высокой, если есть несколько пользователей или если вы живете далеко от центра обработки данных, в котором размещено Hugging Face Space.

Живая демонстрация : FacePoke об объятиях лица

Благодарности

Этот проект основан на LivePortrait: https://arxiv.org/abs/2407.03168.

Он использует процедуры преобразования лица из https://github.com/PowerHouseMan/ComfyUI-AdvancedLivePortrait.

Установка

Прежде чем установить

FacePoke тестировался только в среде Linux с использованием Python 3.10 и CUDA 12.4 (то есть графического процессора NVIDIA).

Приветствуются взносы для поддержки других платформ!

Локальная установка

1. Убедитесь, что у вас глобально установлены Git и Git LFS (https://git-lfs.com):

   git lfs install

2. Клонируем репозиторий:

   git clone https://github.com/jbilcke-hf/FacePoke.git
   cd FacePoke

3. Установите зависимости Python:

   Настоятельно рекомендуется использовать виртуальную среду (Python venv).

   FacePoke был протестирован с Python 3.10 .

   pip3 install --upgrade -r requirements.txt

4. Установите зависимости внешнего интерфейса:

    cd client
   bun install

5. Создайте интерфейс:

   bun build ./src/index.tsx --outdir ../public/

6. Запустите внутренний сервер:

   python app.py

7. Откройте http://localhost:8080 в своем веб-браузере.

Развертывание Докера

1. Создайте образ Docker:

   docker build -t facepoke .

2. Запустите контейнер:

   docker run -p 8080:8080 facepoke

3. Для развертывания в Hugging Face Spaces:

   • Форкните репозиторий на GitHub.
   • Создайте новое пространство на обнимающем лице.
   • Подключите свой репозиторий GitHub к Space.
   • Настройте пространство для использования среды выполнения Docker.

Разработка

Структура проекта организована следующим образом:

• app.py : главный серверный сервер, обрабатывающий соединения WebSocket.
• engine.py : Основная логика.
• loader.py : Инициализирует и загружает модели ИИ.
• client/ : приложение Frontend React.
  • src/ : исходные файлы TypeScript.
  • public/ : статические ресурсы и встроенные файлы.

Увеличение частоты кадров

Я тестирую разные вещи для увеличения частоты кадров.

Один проект заключается в передаче только измененной головы, а не всего изображения.

Другой — автоматическая адаптация к скорости сервера и сети.

Содействие

Вклад в FacePoke приветствуется! Пожалуйста, прочтите наше Руководство по участию, чтобы узнать, как отправлять запросы на включение, сообщать о проблемах или запрашивать функции.

Лицензия

FacePoke выпускается под лицензией MIT. Подробности смотрите в файле ЛИЦЕНЗИИ.

Обратите внимание: хотя код LivePortrait и Insightface имеет открытый исходный код и «без ограничений как для академического, так и для коммерческого использования», веса моделей, полученные на основе данных Insightface, доступны только для некоммерческих исследовательских целей.

---

Разработано с помощью ❤️ Джулианом Билке из Hugging Face