Highlights
The API container now runs as a non-root user and shuts down
gracefully. Package overrides for the gradio companion container are
now documented and wired through the compose file.
⚠️ Breaking / Upgrade notes
- The container runs as
1000:1000by default instead of root.
Override at build time with thePUID/PGIDbuild args, or at
runtime viauser:in docker-compose (user: "${PUID:-1000}:${PGID:-1000}").
No action needed for a standard compose deployment.
Changes
- Run as non-root user with configurable
PUID/PGID(#2d7d6f1) - Graceful shutdown: CMD switched to exec form — the server now
receives stop signals directly instead of being killed after a timeout - Fix startup crash under non-root: uv cache moved to a writable
location (/tmp/uv-cache) - Python bumped to 3.14, dependencies refreshed
Docs & configuration
- Documented
UV_OVERRIDE/UV_EXTRA_INDEX_URLfor overriding
PyTorch builds in the gradio container (older/newer GPUs), and
UV_CACHE_DIRsemantics (path inside the container) - docker-compose: commented example of sharing one uv cache between
projects;.env.examplerefreshed (PUID/PGID,HF_TOKEN)
Full Changelog: 1.0.0...1.1.0