# Comprehensive Project Updates: LTX Video API and Client

.env.example

@@ -0,0 +1,24 @@
+# Model paths
+CKPT_DIR=./app/model
+
+# Default generation parameters
+DEFAULT_NUM_INFERENCE_STEPS=40
+DEFAULT_NUM_IMAGES_PER_PROMPT=1
+DEFAULT_GUIDANCE_SCALE=3.0
+DEFAULT_HEIGHT=480
+DEFAULT_WIDTH=704
+DEFAULT_NUM_FRAMES=121
+DEFAULT_FRAME_RATE=25
+DEFAULT_NEGATIVE_PROMPT="worst quality, inconsistent motion, blurry, jittery, distorted"
+
+# Model precision configuration
+USE_BFLOAT16=true
+
+# Output configuration
+OUTPUT_DIR=/app/outputs
+
+# Version configuration for Docker tags
+VERSION_PREFIX=v
+
+# Logging level
+LOG_LEVEL=INFO

.github/workflows/docker-build.yml

@@ -0,0 +1,63 @@
+name: Docker Build
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  ltx-video-api:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+
+      - name: Set up Docker Buildx
+        uses: docker/[email protected]
+
+      - name: Cache Docker layers
+        uses: actions/cache@v3
+        with:
+          path: /tmp/.buildx-cache
+          key: ${{ runner.os }}-buildx-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-buildx-
+
+      - name: Docker Login
+        uses: docker/[email protected]
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: Generate version tags
+        id: tags
+        run: |
+          # Get current date in YYYYMMDD format
+          DATE_TAG=$(date +'%Y%m%d')
+          # Get short SHA
+          SHA_TAG=$(echo ${{ github.sha }} | cut -c1-7)
+          # Load version prefix from .env
+          VERSION_PREFIX=$(grep VERSION_PREFIX .env | cut -d '=' -f2)
+          # Create tag list
+          TAGS="${{ secrets.DOCKERHUB_USERNAME }}/ltx-video-api:latest,${{ secrets.DOCKERHUB_USERNAME }}/ltx-video-api:${VERSION_PREFIX}${DATE_TAG},${{ secrets.DOCKERHUB_USERNAME }}/ltx-video-api:${VERSION_PREFIX}${SHA_TAG}"
+          echo "tags=${TAGS}" >> $GITHUB_OUTPUT
+
+      - name: Build and push LTX Video API Docker image
+        uses: docker/[email protected]
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ steps.tags.outputs.tags }}
+          cache-from: type=local,src=/tmp/.buildx-cache
+          cache-to: type=local,dest=/tmp/.buildx-cache-new,mode=max
+          platforms: linux/amd64
+
+      # Move cache to prevent cache growth
+      - name: Move cache
+        run: |
+          rm -rf /tmp/.buildx-cache
+          mv /tmp/.buildx-cache-new /tmp/.buildx-cache

Dockerfile

@@ -0,0 +1,44 @@
+# Use NVIDIA CUDA base image
+FROM nvidia/cuda:12.2.0-runtime-ubuntu22.04
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    python3-pip \
+    python3-dev \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first to leverage Docker cache
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip3 install --no-cache-dir -r requirements.txt
+
+# Copy application files
+COPY . .
+
+# Install LTX-Video package and inference dependencies
+RUN pip3 install . && \
+    pip3 install accelerate matplotlib "imageio[ffmpeg]"
+
+# Set environment variables
+ENV PYTHONUNBUFFERED=1
+ENV CKPT_DIR=/app/models
+ENV OUTPUT_DIR=/app/outputs
+
+# Create directories
+RUN mkdir -p /app/models /app/outputs
+
+# Expose port
+EXPOSE 8000
+
+# Run the FastAPI server
+CMD ["python3", "api.py"]
+
+# Add labels
+LABEL maintainer="Lightricks" 
+LABEL description="LTX-Video API service"
+LABEL version="1.0"