Genjustsu Open Source Workflow di Windows 11

Repo: https://github.com/sirioberati/Genjustsu-Open-Source-Workflow
Fungsi: Mengganti karakter/objek dalam video memakai colored depth, SAM 3 masks, dan Seedance (via Enhancor). Audio final = audio asli dari video sumber.
Jalur di Windows 11: WSL2 + Ubuntu (jalur resmi yang disarankan README).

📋 Ringkasan Alur

0️⃣ Prasyarat

• Windows 11 (64-bit) dengan virtualisasi aktif (Task Manager → Performance → CPU → Virtualization: Enabled). Jika Disabled, aktifkan Intel VT-x / AMD SVM di BIOS.

Beda komputer beda cara akses BIOS untuk enablekan Virtualization Technology.

• Koneksi internet stabil.

• Disk kosong minimal ±10 GB. Mode face mesh butuh lebih banyak.

• API key milik sendiri:

  • ENHANCOR_API_KEY → https://app.enhancor.ai/api-dashboard

  • REPLICATE_API_TOKEN → https://replicate.com/account/api-tokens

  • HF_TOKEN (opsional, alternatif depth via Hugging Face)

• Pastikan akun API sudah di-top up / diaktifkan. Generate video itu berbayar. 💸

Applikasi di dalam Enhancor:Login ke Github untuk koneksikan ReplicateAPI tokens --> Create token --> replikasi. Copy keynya dan simpan di tempat yang aman.

✅ Tidak perlu GPU lokal. Setup default memakai layanan hosted.

---

1️⃣ Aktifkan WSL2 + Ubuntu

1. Klik kanan tombol Start → Terminal (Admin) atau Windows PowerShell (Admin).

2. Jalankan:
   wsl --install -d Ubuntu

3. Restart Windows jika diminta.

4. Setelah restart, jendela Ubuntu akan terbuka sendiri. Buat username dan password Linux. Password tidak tampil saat diketik, itu normal.

5. Cek versi WSL di PowerShell:
   wsl -l -v

Kolom VERSION harus bernilai 2. Jika 1, jalankan:
wsl --set-version Ubuntu 2

1. Cek versi Ubuntu di terminal Ubuntu:
   lsb_release -a
   python3 --version
   

• Ubuntu 24.04 → Python 3.12 sudah bawaan ✅

• Ubuntu 22.04 atau lebih lama → Python masih 3.10. Lihat bagian Troubleshooting nomor 6.

💡 Mulai dari sini, semua perintah dijalankan di terminal Ubuntu (buka lewat Start → ketik "Ubuntu"), kecuali dinyatakan lain.

---

2️⃣ Install Paket Dasar

sudo apt update && sudo apt upgrade -y
sudo apt install -y rubberband-cli python3-venv python3-pip git curl unzip dos2unix ffmpeg

• rubberband-cli dan python3-venv wajib menurut README.

• git, curl, unzip, dos2unix adalah alat bantu.

• ffmpeg tidak disebut README, tetapi hampir pasti dibutuhkan untuk memproses video. Memasangnya tidak merugikan.

Cek:
sudo apt install rubberband-cli
rubberband --version
python3 --version

3️⃣ Install cloudflared

Aplikasi membutuhkan webhook HTTPS publik untuk menerima callback dari Enhancor. Saat launch, launch.py membuat Quick Tunnel sementara lewat cloudflared. Yang terekspos hanya callback. UI dan media tetap di localhost.
curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared.deb
rm cloudflared.deb
cloudflared --version

Punya webhook receiver HTTPS sendiri? Cloudflared boleh dilewati. Isi saja ENHANCOR_WEBHOOK_URL di .env nanti.

---

4️⃣ Ambil Project

⚠️ Simpan project di filesystem Linux (~), bukan di /mnt/c/.... Kalau di /mnt/c, performanya jauh lebih lambat dan sering bermasalah dengan permission dan line ending.

Opsi A: git clone (disarankan)
cd ~
git clone https://github.com/sirioberati/Genjustsu-Open-Source-Workflow.git
cd Genjustsu-Open-Source-Workflow
Opsi B: dari ZIP yang sudah diunduh di Windows
cd ~
cp /mnt/c/Users//Downloads/Genjustsu-Open-Source-Workflow-main.zip .
unzip Genjustsu-Open-Source-Workflow-main.zip
cd Genjustsu-Open-Source-Workflow-main
# Perbaiki line ending Windows (CRLF) agar skrip .sh bisa jalan
dos2unix *.sh start.command

Pastikan isinya benar:
ls
Harus terlihat app.py, setup.sh, start.command, requirements.txt, dan lainnya.

5️⃣ Jalankan Setup Utama

bash setup.sh

Skrip ini, menurut README:

• membuat virtual environment terisolasi .venv

• meng-install requirements.txt

• membuat file .env kosong

• memeriksa dependensi

Tunggu sampai selesai tanpa error merah. ☕

Cek manual:
.venv/bin/python doctor.py

6️⃣ (Opsional) Aktifkan Mode Face Mesh

Langkah ini untuk mengaktifkan ketiga mode workflow. Face mesh butuh Python 3.13 terpisah.
python3.13 --version # pastikan ada
bash setup-face-mesh.sh
.venv/bin/python doctor.py --mesh

Kalau python3.12 tidak ditemukan, lihat Troubleshooting nomor 6.

Hanya mau mencoba alur dasar dulu? Langkah 6 boleh dilewati dan dikerjakan belakangan.

---

7️⃣ Isi File .env

Buka dengan editor nano:
nano .env
Isi (ganti dengan key milik Kakak sendiri):
ENHANCOR_API_KEY=isi_key_enhancor_kakak
REPLICATE_API_TOKEN=isi_token_replicate_kakak
# Opsional:
# HF_TOKEN=isi_token_huggingface
# ENHANCOR_WEBHOOK_URL=https://webhook-publik-kakak.example.com
Simpan: Ctrl+O → Enter → keluar Ctrl+X.

🔐 Jangan bagikan .env, jangan commit ke Git, dan jangan tempel key di chat. Kalau perlu cek variabel lain, lihat .env.example:

cat .env.example

8️⃣ Jalankan Aplikasi

bash start.command

Kalau port 8770 sudah dipakai:
PORT=8771 bash start.command
Yang terjadi:

• Web UI lokal jalan di port 8770.

• cloudflared otomatis membuat tunnel callback jika webhook belum diatur.

⚠️ Biarkan terminal ini tetap terbuka. Kalau ditutup, app dan tunnel ikut mati.

Cek kesiapan. Buka terminal Ubuntu kedua, lalu:
cd ~/Genjustsu-Open-Source-Workflow
.venv/bin/python doctor.py --require-keys
Jika semua hijau (OK), berarti siap. ✅

9️⃣ Pakai UI di Browser Windows

Buka Chrome/Edge di Windows:

👉 http://127.0.0.1:8770 (atau port 8771 jika diganti)

WSL2 meneruskan localhost ke Windows secara otomatis.

Alur kerja di UI:

1. Upload video MP4/MOV sendiri.

2. Prepare video.

3. Periksa seluruh mask dan video hasil prepare.

4. Approve mask yang persis dipilih.

5. Berikan referensi karakter sendiri.

6. Review prompt.

7. Klik Create Draft (draft dulu, lebih murah).

8. Kalau draft sudah bagus, klik tombol persetujuan 1080p.

9. Draft dan hasil HD tersimpan terpisah. Kedua preview final memakai audio asli sumber.

🧰 TroubleshootingInstall Python 3.12 di Ubuntu lama (nomor 6):
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev
python3.12 --version

Ulangi bash setup.sh jika sebelumnya gagal. Jika perlu, hapus dulu .venv dengan rm -rf .venv.

🔄 Menjalankan Lagi di Hari Berikutnya

# Buka terminal Ubuntu
cd ~/Genjustsu-Open-Source-Workflow
bash start.command
# lalu buka http://127.0.0.1:8770 di browser Windows

Untuk menghentikan, tekan Ctrl+C di terminal tempat app berjalan.

🤖 Jalur Alternatif: Biar Coding Agent yang Pasang

Repo ini juga punya runbook docs/SETUP-AGENT.md. Kakak bisa membuka folder project di coding agent yang punya akses terminal (misalnya Codex) di dalam WSL. Minta agent membaca file itu dan memasang semuanya. Tetap isi API key sendiri secara privat, dan minta agent tidak men-submit generasi berbayar.

✅ Checklist Akhir

• WSL2 + Ubuntu aktif

• rubberband, python3-venv, cloudflared terpasang

• Project ada di ~/Genjustsu-Open-Source-Workflow

• bash setup.sh sukses

• (Opsional) setup-face-mesh.sh sukses

• .env terisi key milik sendiri

• doctor.py --require-keys hijau

• UI terbuka di http://127.0.0.1:8770