ETH官方钱包

前往
大廳
主題

程式小白自己做50系列顯卡可以用的FramePack獨立執(zhí)行包

A.C | 2025-04-20 20:29:07 | 巴幣 4 | 人氣 896

*last update 2025-05-01:修正內(nèi)文
前言、

用ComfyUI試跑Framepack工作流,但是常常卡在最後的Tiled VAE。搞得一定要降節(jié)點參數(shù),影片才能出來;同時想試試將原作者提供的工具改成支援50系顯卡的version。網(wǎng)路上是有找到一篇用anaconda製作的,個人在這邊想試著用python的虛擬環(huán)境弄個出來。讓AI參照使用anaconda製作的頁面,修改成用python的虛擬環(huán)境。

免責(zé)宣言:個人是程式小白,對Python十竅通了九竅。


正文、

個人提醒

1. python版本依照Framepack作者提供的資料,其建議是3.10的版本。
*個人用3.12版本一樣成功構(gòu)建本篇的執(zhí)行包,所以這篇提供的是3.12版的安裝法,供參。
2. 這篇是程式小白跟AI一起討論出來的安裝方法。
3. 有問題請就教Grok 3跟Gemini 2.5 Pro,個人是跟它們討教的。

AI統(tǒng)整的個人條件,有缺的可以先去安裝:
*使用 Python 3.12 安裝 FramePack(Windows,適用 RTX 50 系列)
Python:已安裝 Python 3.12(確認(rèn):python --version)。
GPU:NVIDIA RTX 50系列,至少 6GB 顯存。
NVIDIA 驅(qū)動與 CUDA:最新驅(qū)動和 CUDA Toolkit 12.8(檢查:nvidia-smi)。
Git:已安裝 Git for Windows(https://git-scm.com/download/win)。
網(wǎng)絡(luò)與硬碟:穩(wěn)定網(wǎng)絡(luò),40GB以上 可用空間。
pip:更新至最新(python -m pip install --upgrade pip)。


安裝步驟

步驟 1:創(chuàng)建並啟動虛擬環(huán)境
*以下步驟均在Power shell下執(zhí)行,建議先創(chuàng)立一個要安裝FramePack的目錄,切換到該目錄下打開Power shell。
*>>表示直接執(zhí)行>>後方的命令。

1-1、確認(rèn) Python 版本:
>>python --version
預(yù)期輸出:Python 3.12.*。

1-2、創(chuàng)建虛擬環(huán)境:
>>mkdir D:\AI\FramePack
*這邊的目錄"D:\AI\FramePack"請修改成自行需要的目錄,修改完後請記好後面還會用到。
>>cd D:\AI\FramePack
*目的為切換到該目錄下,已經(jīng)在目錄下的直接執(zhí)行python -m一行。
>>python -m venv framepack_env
*環(huán)境名framepack_env可以改為自己喜好的名字,同樣的修改完後請記好,後面還會用到。

1-3、啟動虛擬環(huán)境:
>>D:\AI\FramePack\framepack_env\Scripts\activate.ps1
預(yù)期輸出:提示符前面應(yīng)顯示 (framepack_env)。
像這樣:
(framepack_env) PS D:\AI\FramePack>
之後的命令都在這樣的狀況下執(zhí)行。

1-4、更新 pip:
>>python -m pip install --upgrade pip


步驟 2:克隆 FramePack 倉庫
2-1、克隆倉庫:
預(yù)期輸出:目錄 D:\AI\FramePack\FramePack 包含 demo_gradio.py、requirements.txt 等。
確認(rèn):
>>dir D:\AI\FramePack\FramePack
裡的內(nèi)容。


步驟 3:安裝 PyTorch(支援 CUDA)
3-1、進入 FramePack 目錄:
>>cd D:\AI\FramePack\FramePack

3-2、安裝 PyTorch(針對 CUDA 12.8):
>>pip install torch==2.7.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
PyTorch 2.7 正式支援50系顯卡,也支援CUDA 12.8,所以這邊更換成比較穩(wěn)定的PyTorch 2.7
預(yù)期輸出:成功安裝 torch-2.7 或類似版本。

注意:
1.
PyTorch 2.7不再支援舊版 CUDA(例如 CUDA 12.4),並且需要相容於 CUDA 12.8 的 NVIDIA 驅(qū)動程式。如果遇到依賴項問題(例如,flash-attn無法使用 PyTorch 2.7 構(gòu)建,如 X 所述),可能需要暫時固定到 PyTorch 2.6 或等待更新的依賴項版本。
2.
關(guān)於torchvision的視訊解碼/編碼功能已被棄用(將在torchvision 0.24 中刪除)的警告仍然適用。 PyTorch 2.7 包含torchvision 0.22 或更高版本,因此仍然存在警告。從長遠來看,F(xiàn)ramePack 可能需要遷移到TorchCodec,但除非打算更新至torchvision 0.24 或更高版本,否則無需立即採取行動。

3-3、驗證 CUDA:
import torch
print(torch.cuda.is_available())  # 應(yīng)輸出 True
print(torch.cuda.get_device_name(0))  # 應(yīng)顯示 RTX 50XX
將「」裡的文字複製存成Verify_CUDA.py,檔案放到命令行所示目錄下,確認(rèn)輸出。
>>python Verify_CUDA.py
確認(rèn)輸出是否為True與RTX 50XX。


步驟 4:安裝依賴項
4-1、安裝 requirements.txt:
>>pip install -r requirements.txt

4-2、逐一安裝依賴,檢查兼容性:
>>pip install accelerate diffusers gradio huggingface_hub numpy safetensors
預(yù)期輸出:均顯示 Successfully installed。


步驟 5:運行 FramePack Demo
5-1、啟動 Gradio 界面:
>>python demo_gradio.py
首次運行:下載約 30GB 模型(hunyuanvideo-community/HunyuanVideo),需數(shù)分鐘至數(shù)小時。
預(yù)期輸出:
Downloading shards: 100%|██████████| 4/4 [03:24<00:00, 51.12s/it]
* Running on local URL: http://0.0.0.0:7860
Decoded. Current latent shape torch.Size([1, 16, 37, 88, 68]); pixel shape torch.Size([1, 3, 145, 704, 544])

注意:若出現(xiàn) Hugging Face 警告,設(shè)定:
>>set HF_HUB_DISABLE_SYMLINKS_WARNING=1


步驟 6:驗證安裝
6-1、訪問 Gradio 界面:
瀏覽器打開 http://127.0.0.1:7860。

6-2、運行 Sanity Check:
提示詞:The man dances energetically, leaping mid-air with fluid arm swings and quick footwork.
使用 Gradio 界面上傳圖片,保持預(yù)設(shè)參數(shù),關(guān)閉 teacache。
預(yù)期結(jié)果:生成 5 秒影片,顯示舞蹈動作應(yīng)與專案內(nèi)容相似。


步驟 7:設(shè)定BAT執(zhí)行檔
@echo off
echo Starting FramePack execution...

:: 設(shè)定日誌文件
set LOGFILE=D:\AI\FramePack\run_framepack_log.txt
echo [%DATE% %TIME%] Starting execution > "%LOGFILE%"

:: 起動虛擬環(huán)境
echo Activating virtual environment...
echo [%DATE% %TIME%] Activating virtual environment >> "%LOGFILE%"
call D:\AI\FramePack\framepack_env\Scripts\activate.bat
if %ERRORLEVEL% neq 0 (
    echo Error: Failed to activate virtual environment at D:\AI\FramePack\framepack_env
    echo [%DATE% %TIME%] Error: Failed to activate virtual environment >> "%LOGFILE%"
    pause
    exit /b 1
)

:: 切換到 FramePack 目錄
echo Changing to FramePack directory...
echo [%DATE% %TIME%] Changing to FramePack directory >> "%LOGFILE%"
cd /d D:\AI\FramePack\FramePack
if %ERRORLEVEL% neq 0 (
    echo Error: Failed to change to D:\AI\FramePack\FramePack
    echo [%DATE% %TIME%] Error: Failed to change to D:\AI\FramePack\FramePack >> "%LOGFILE%"
    pause
    exit /b 1
)

:: 檢查 demo_gradio.py 是否存在
if not exist "demo_gradio.py" (
    echo Error: demo_gradio.py not found in D:\AI\FramePack\FramePack
    echo [%DATE% %TIME%] Error: demo_gradio.py not found >> "%LOGFILE%"
    pause
    exit /b 1
)

:: 運行 demo_gradio.py
echo Running demo_gradio.py...
echo [%DATE% %TIME%] Running demo_gradio.py >> "%LOGFILE%"
D:\AI\FramePack\framepack_env\Scripts\python.exe demo_gradio.py --server 127.0.0.1 --inbrowser
if %ERRORLEVEL% neq 0 (
    echo Error: Failed to run demo_gradio.py
    echo [%DATE% %TIME%] Error: Failed to run demo_gradio.py >> "%LOGFILE%"
    pause
    exit /b 1
)

echo Done! FramePack Gradio interface should be running at http://127.0.0.1:7860
echo [%DATE% %TIME%] Done! Gradio interface running >> "%LOGFILE%"
pause
exit /b 0
以上內(nèi)容存成Run_framepack.bat (名稱可以自行決定),放到D:\AI\FramePack下面,以後只要執(zhí)行這個BAT就可以跑framepack。裡面的目錄路徑或是環(huán)境名稱如果在前面的步驟有更動過,請根據(jù)您自己修改過的名稱做相應(yīng)修正。想把Framepack換地方放,把「D:\AI\FramePack\」替換為「%~dp0」就好了。

若出錯:
如果上面的BAT有問題,將下面「」裡的內(nèi)容存成BAT,放在 D:\AI\FramePack下面,看看是否可以執(zhí)行。如不能,直接刪除環(huán)境目錄(個人這邊是:D:\AI\FramePack\framepack_env),全部流程自步驟 1起再跑一遍
@echo off
call D:\AI\FramePack\framepack_env\Scripts\activate.bat
cd /d D:\AI\FramePack\FramePack
python demo_gradio.py --server 127.0.0.1 --inbrowser
pause
目錄或環(huán)境有做修正的人,整個流程內(nèi)的步驟請自行做相對應(yīng)修正。


給看得懂的人用的簡短安裝(Power shell)

cd FramePack
python -m venv venv
.\venv\Scripts\activate
pip install torch==2.7.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
pip install -r requirements.txt
python .\demo_gradio.py

browser open:

option: SageAttention
pip install triton-windows
pip install 下載的輪子檔名.whl (到 https://github.com/woct0rdho/SageAttention/releases  下載對應(yīng)的輪子)
or


個人結(jié)語

加速的一些attention組件, xformers, flash-attn,都沒裝,TeaCache降低的就很明顯了,再上去個人無法接受。不過有時候為了提升AI產(chǎn)出影片速度還是會用TeaCache。

triton-windows專案的作者woct0rdho有在這個Issues發(fā)言。
"@slow-down You just need SageAttention rather than xformers or FlashAttention. SageAttention is faster than the latter two with no quality loss in most cases. When FramePack finds that SageAttention is installed, it does not use the latter two.

Feel free to install my SageAttention wheels https://github.com/woct0rdho/SageAttention/releases"

意思是使用者只需要安裝 SageAttention,而不是 xformers 或 FlashAttention。 SageAttention 比後兩者更快,並且在大多數(shù)情況下沒有品質(zhì)損失。而且當(dāng)FramePack發(fā)現(xiàn)安裝了SageAttention時,它就不會使用後兩者。


所以個人在簡短安裝中新增加了SageAttention的安裝,不直接提供指令是因為每個人的環(huán)境不同。
追蹤 創(chuàng)作集

作者相關(guān)創(chuàng)作

更多創(chuàng)作