https://github.com/ashleykleynhans/framepack-docker
Docker image for FramePack: Official implementation and desktop software for "Packing Input Frame Context in Next-Frame Prediction Models for Video Generation"
https://github.com/ashleykleynhans/framepack-docker
docker docker-image framepack image-to-video image-to-video-generation runpod video-generation
Last synced: 5 months ago
JSON representation
Docker image for FramePack: Official implementation and desktop software for "Packing Input Frame Context in Next-Frame Prediction Models for Video Generation"
- Host: GitHub
- URL: https://github.com/ashleykleynhans/framepack-docker
- Owner: ashleykleynhans
- License: gpl-3.0
- Created: 2025-04-20T16:33:55.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-23T06:44:08.000Z (about 1 year ago)
- Last Synced: 2025-09-16T03:47:22.086Z (10 months ago)
- Topics: docker, docker-image, framepack, image-to-video, image-to-video-generation, runpod, video-generation
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Docker image for FramePack: Official implementation and desktop software for "Packing Input Frame Context in Next-Frame Prediction Models for Video Generation".
[](https://github.com/ashleykleynhans/framepack-docker)
[](https://hub.docker.com/repository/docker/ashleykza/framepack)
## 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](https://console.runpod.io/deploy?template=ttpsmdrpha&ref=2xxro4sy) |
| cu128-py311 | 12.8 | 3.11 | 2.10.0 | N/A | [Deploy](https://console.runpod.io/deploy?template=nkscfv1dts&ref=2xxro4sy) |
## Installs
* Ubuntu 22.04 LTS
* [FramePack](
https://github.com/lllyasviel/FramePack)
* [Jupyter Lab](https://github.com/jupyterlab/jupyterlab)
* [code-server](https://github.com/coder/code-server)
* [runpodctl](https://github.com/runpod/runpodctl)
* [OhMyRunPod](https://github.com/kodxana/OhMyRunPod)
* [RunPod File Uploader](https://github.com/kodxana/RunPod-FilleUploader)
* [croc](https://github.com/schollz/croc)
* [rclone](https://rclone.org/)
## Available on RunPod
This image is designed to work on [RunPod](https://runpod.io?ref=2xxro4sy).
| Name | Docker Image | RunPod Template |
|---------------------|---------------------------------------|-----------------------------------------------------------------------------|
| FramePack CUDA 12.4 | ashleykza/framepack:cu124-py311-1.0.1 | [Deploy](https://console.runpod.io/deploy?template=ttpsmdrpha&ref=2xxro4sy) |
| FramePack CUDA 12.8 | ashleykza/framepack:cu128-py311-1.0.1 | [Deploy](https://console.runpod.io/deploy?template=nkscfv1dts&ref=2xxro4sy) |
## 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.
```bash
# 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](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html)
- [Windows](https://docs.nvidia.com/cuda/cuda-installation-guide-microsoft-windows/index.html)
### Start the Docker container
```bash
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](#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:
```bash
tail -f /workspace/logs/framepack.log
```
## Community and Contributing
Pull requests and issues on [GitHub](https://github.com/ashleykleynhans/framepack-docker)
are welcome. Bug fixes and new features are encouraged.
## Appreciate my work?
