Available Image Variants
| Docker Image Tag |
CUDA |
Python |
Torch |
xformers |
RunPod |
| cu124-py311 |
12.4 |
3.11 |
2.6.0 |
0.0.29.post3 |
Deploy |
| cu128-py311 |
12.8 |
3.11 |
2.10.0 |
N/A |
Deploy |
Installs
Available on RunPod
This image is designed to work on RunPod.
| Name |
Docker Image |
RunPod Template |
| FramePack CUDA 12.4 |
ashleykza/framepack:cu124-py311-1.0.1 |
Deploy |
| FramePack CUDA 12.8 |
ashleykza/framepack:cu128-py311-1.0.1 |
Deploy |
Building the Docker image
[!NOTE]
You will need to edit the docker-bake.hcl file and update REGISTRY_USER,
and RELEASE. You can obviously edit the other values too, but these
are the most important ones.
# Clone the repo
git clone https://github.com/ashleykleynhans/framepack-docker.git
# Log in to Docker Hub
docker login
# Build the image, tag the image, and push the image to Docker Hub
cd framepack-docker
docker buildx bake -f docker-bake.hcl --push
# Same as above but customize registry/user/release:
REGISTRY=ghcr.io REGISTRY_USER=myuser RELEASE=my-release docker buildx \
bake -f docker-bake.hcl --push
Running Locally
Install Nvidia CUDA Driver
Start the Docker container
docker run -d \
--gpus all \
-v /workspace \
-p 3000:3001 \
-p 7777:7777 \
-p 8888:8888 \
-p 2999:2999 \
-e VENV_PATH=/workspace/venvs/framepack \
ashleykza/framepack:cu124-py311-1.0.1
Replace cu124-py311-1.0.1 with your preferred variant and version. See Available Image Variants for options.
Ports
| Connect Port |
Internal Port |
Description |
| 3000 |
3001 |
FramePack |
| 7777 |
7777 |
Code Server |
| 8888 |
8888 |
Jupyter Lab |
| 2999 |
2999 |
RunPod File Uploader |
Environment Variables
| Variable |
Description |
Default |
| VENV_PATH |
Set the path for the Python venv for the app |
/workspace/venvs/framepack |
| JUPYTER_LAB_PASSWORD |
Set a password for Jupyter lab |
not set - no password |
| DISABLE_AUTOLAUNCH |
Disable FramePack from launching automatically |
(not set) |
| DISABLE_SYNC |
Disable syncing if using a RunPod network volume |
(not set) |
Logs
FramePack creates a log file, and you can tail the log instead of
killing the service to view the logs.
| Application |
Log file |
| FramePack |
/workspace/logs/framepack.log |
For example:
tail -f /workspace/logs/framepack.log
Community and Contributing
Pull requests and issues on GitHub
are welcome. Bug fixes and new features are encouraged.
Appreciate my work?

评论