FacePoke

judul	emoji	warnaDari	warnaUntuk	SDK	disematkan	lisensi	tajuk	file_aplikasi	aplikasi_port	nonaktifkan_penyematan	deskripsi_pendek
Poke Wajah	?‍ ↔️ ?	kuning	merah	buruh pelabuhan	BENAR	mit	mini	app.py	8080	BENAR	Impor potret, klik untuk menggerakkan kepala!

Poke Wajah

Daftar isi

• Perkenalan
• Ucapan Terima Kasih
• Instalasi
  • Pengaturan Lokal
  • Penerapan Docker
• Perkembangan
• Berkontribusi
• Lisensi

Perkenalan

Aplikasi transformasi kepala waktu nyata.

Untuk kinerja terbaik, jalankan aplikasi dari mesin Anda sendiri (lokal atau di cloud).

Gudang : GitHub - jbilcke-hf/FacePoke

Anda dapat mencoba demo tetapi ini adalah ruang bersama, latensi mungkin tinggi jika ada banyak pengguna atau jika Anda tinggal jauh dari pusat data yang menghosting Hugging Face Space.

Demo Langsung : FacePoke di Ruang Memeluk Wajah

Ucapan Terima Kasih

Proyek ini didasarkan pada LivePortrait: https://arxiv.org/abs/2407.03168

Ia menggunakan rutinitas transformasi wajah dari https://github.com/PowerHouseMan/ComfyUI-AdvancedLivePortrait

Instalasi

Sebelum Anda menginstal

FacePoke hanya diuji di lingkungan Linux, menggunakan Python 3.10 dan CUDA 12.4 (jadi GPU NVIDIA).

Kontribusi dipersilakan untuk membantu mendukung platform lain!

Pengaturan Lokal

1. Pastikan Anda telah menginstal Git dan Git LFS secara global (https://git-lfs.com):

   git lfs install

2. Kloning repositori:

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

3. Instal dependensi Python:

   Menggunakan lingkungan virtual (Python venv) sangat disarankan.

   FacePoke telah diuji dengan Python 3.10 .

   pip3 install --upgrade -r requirements.txt

4. Instal dependensi frontend:

    cd client
   bun install

5. Bangun bagian depan:

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

6. Mulai server backend:

   python app.py

7. Buka http://localhost:8080 di browser web Anda.

Penerapan Docker

1. Bangun gambar Docker:

   docker build -t facepoke .

2. Jalankan wadah:

   docker run -p 8080:8080 facepoke

3. Untuk diterapkan ke Hugging Face Spaces:

   • Cabangkan repositori di GitHub.
   • Buat Ruang baru di Memeluk Wajah.
   • Hubungkan repositori GitHub Anda ke Space.
   • Konfigurasikan Space untuk menggunakan runtime Docker.

Perkembangan

Struktur proyek disusun sebagai berikut:

• app.py : Server backend utama yang menangani koneksi WebSocket.
• engine.py : Logika inti.
• loader.py : Menginisialisasi dan memuat model AI.
• client/ : Aplikasi React Frontend.
  • src/ : File sumber TypeScript.
  • public/ : Aset statis dan file yang dibuat.

Meningkatkan kecepatan bingkai

Saya menguji berbagai hal untuk meningkatkan framerate.

Salah satu proyeknya adalah hanya mengirimkan bagian kepala yang dimodifikasi, bukan keseluruhan gambar.

Cara lainnya adalah secara otomatis beradaptasi dengan server dan kecepatan jaringan.

Berkontribusi

Kontribusi ke FacePoke dipersilakan! Silakan baca Pedoman Berkontribusi kami untuk detail tentang cara mengirimkan permintaan penarikan, melaporkan masalah, atau meminta fitur.

Lisensi

FacePoke dirilis di bawah Lisensi MIT. Lihat file LISENSI untuk detailnya.

Harap perhatikan bahwa meskipun kode LivePortrait dan Insightface bersifat open-source dengan "tidak ada batasan untuk penggunaan akademis dan komersial", bobot model yang dilatih dari data Insightface tersedia untuk tujuan penelitian non-komersial saja.

---

Dikembangkan dengan ❤️ oleh Julian Bilcke di Hugging Face