Docker image for FramePack: Official implementation and desktop software for "Packing Input Frame Context in Next-Frame Prediction Models for Video Generation".

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

• Ubuntu 22.04 LTS
• FramePack
• Jupyter Lab
• code-server
• runpodctl
• OhMyRunPod
• RunPod File Uploader
• croc
• rclone

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

• Linux
• Windows

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?