FacePoke

標題	表情符號	顏色來自	顏色到	開發工具包	固定的	執照	標頭	應用程式檔案	應用程式連接埠	禁用嵌入	簡短描述
臉戳	？ ↔️ ？	黃色的	紅色的	泊塢窗	真的	麻省理工學院	小型的	應用程式.py	8080	真的	導入頭像，點擊即可移動頭部！

臉戳

目錄

• 介紹
• 致謝
• 安裝
  • 本地設定
  • Docker部署
• 發展
• 貢獻
• 執照

介紹

即時頭部變換應用程式。

為了獲得最佳效能，請從您自己的電腦（本機或在雲端）執行該應用程式。

儲存庫: 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 GPU）進行了測試。

歡迎捐款以幫助支持其他平台！

本地設定

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. 在 Web 瀏覽器中開啟http://localhost:8080 。

Docker部署

1. 建置 Docker 映像：

   docker build -t facepoke .

2. 運行容器：

   docker run -p 8080:8080 facepoke

3. 要部署到擁抱臉部空間：

   • 在 GitHub 上分叉儲存庫。
   • 在擁抱面上創造一個新空間。
   • 將您的 GitHub 儲存庫連接到 Space。
   • 配置空間以使用 Docker 運行時。

發展

項目結構組織如下：

• app.py ：處理 WebSocket 連線的主後端伺服器。
• engine.py ：核心邏輯。
• loader.py ：初始化並載入AI模型。
• client/ ：前端 React 應用程式。
  • src/ ：TypeScript 原始檔。
  • public/ ：靜態資源和建置文件。

提高幀率

我正在測試各種東西來提高幀率。

一個項目是僅傳輸修改後的頭部，而不是整個影像。

另一種是自動適應伺服器和網路速度。

貢獻

歡迎為 FacePoke 做出貢獻！請閱讀我們的貢獻指南，以了解有關如何提交拉取請求、報告問題或請求功能的詳細資訊。

執照

FacePoke 是根據 MIT 許可證發布的。有關詳細信息，請參閱許可證文件。

請注意，雖然 LivePortrait 和 Insightface 的程式碼是開源的，“學術和商業用途均不受限制”，但從 Insightface 資料訓練的模型權重僅可用於非商業研究目的。

---

由 Hugging Face 的 Julian Bilcke 與 ❤️ 一起開發