fix: resolve Docker build nesting issue and update version to 1.4.1

Author: sim186

CHANGELOG.md

@@ -17,6 +17,11 @@ Keep a Changelog format.
   - `docker-compose.prod.yml` — production overlay, adds Traefik labels and joins the Traefik Docker network.
 - **Docker:** Production deployment now supports Traefik reverse proxy with automatic Let's Encrypt HTTPS via TLS-ALPN-01 challenge. Configure via `.env` (see `.env.example`).
 
+### 🐛 Fixes
+- **Docker build:** Fixed an issue where the `backend/` directory was copied into the image with an extra nesting level, causing import errors. The `COPY` instruction now correctly places the backend files at the root of the image filesystem.
+- **Versioning:** Updated the `VERSION` file to `1.4.1` to reflect the latest patch release.
+
+
 ---
 
 ## [1.4.0] - 2026-04-06

Dockerfile

@@ -13,19 +13,27 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     libavutil-dev \
     && rm -rf /var/lib/apt/lists/*
 
-COPY backend/requirements.txt .
+COPY backend/requirements.txt /tmp/requirements.txt
 
 # Install CPU-only PyTorch from the official CPU index
 # to avoid pulling CUDA-linked wheels (libnppicc, libnvrtc etc.)
 # torchcodec is installed from PyPI via requirements.txt but its C extension
 # is mocked at runtime in main.py (no CPU aarch64 wheel exists).
 RUN pip install --no-cache-dir torch torchaudio --index-url https://download.pytorch.org/whl/cpu
-RUN pip install --no-cache-dir -r requirements.txt
+RUN pip install --no-cache-dir -r /tmp/requirements.txt
 
-COPY backend/ .
-COPY frontend/ ./frontend/
+# Preserve backend/ as a subdirectory so it is importable as the 'backend'
+# package (matching the venv layout where run.py adds backend/ to sys.path).
+COPY backend/ backend/
+COPY frontend/ frontend/
 
-RUN mkdir -p uploads
+# Temp staging area for uploaded files before they are moved to STORAGE_ROOT.
+RUN mkdir -p backend/uploads
+
+# Make every module inside backend/ importable by its short name (state, pipeline,
+# etc.) exactly as run.py does by inserting backend/ into sys.path.
+# /app is WORKDIR so 'from backend import X' also resolves via namespace package.
+ENV PYTHONPATH=/app/backend
 
 EXPOSE 8002
 

VERSION

@@ -1 +1 @@
-1.3.1
+1.4.1

docker-compose.override.yml

@@ -1,6 +1,10 @@
 # Local development overrides — loaded automatically by `docker compose up`.
-# Exposes the app directly on port 8002 without needing Traefik.
+# Exposes the app directly on port 8002 without needing Traefik, and
+# bind-mounts the frontend directory for hot-reloading during development.
+# In production (docker-compose.prod.yml) the frontend baked into the image is used.
 services:
   audioscript:
     ports:
       - "8002:8002"
+    volumes:
+      - ./frontend:/app/frontend:ro

docker-compose.yml

@@ -2,14 +2,18 @@ services:
   audioscript:
     build: .
     volumes:
-      - ./frontend:/app/frontend:ro
       - whisper_models:/root/.cache/huggingface
       - amicoscript_settings:/root/.amicoscript
     environment:
       - PYTHONUNBUFFERED=1
       - HF_TOKEN=${HF_TOKEN:-}
+      # Mirror the sys.path insertion that run.py performs in venv mode so that
+      # short-name imports (state, pipeline, …) and 'from backend import X'
+      # both resolve correctly inside the container.
+      - PYTHONPATH=/app/backend
     restart: unless-stopped
 
 volumes:
+  
   whisper_models:
   amicoscript_settings: