✨(agents) use uv for dependency management

Change from pip to uv for dependancy management.

Author: cameledev

.dockerignore

@@ -11,7 +11,7 @@ venv
 **/.DS_Store
 
 # Docker
-docker compose.*
+compose.*
 env.d
 
 # Docs

.github/workflows/meet.yml

@@ -150,13 +150,14 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
-          cache: "pip"
-      - name: Install development dependencies
-        run: pip install --user .[dev]
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Install the project
+        run: uv sync --locked --all-extras
       - name: Check code formatting with ruff
-        run: ~/.local/bin/ruff format . --diff
+        run: uv run ruff format . --diff
       - name: Lint code with ruff
-        run: ~/.local/bin/ruff check .
+        run: uv run ruff check .
 
   lint-summary:
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -12,6 +12,10 @@ and this project adheres to
 
 - 🔒️(backend) add validation of Room.configuration
 
+### Changed
+
+- 🧑‍💻(agents) use `uv` for package management
+
 ## [1.15.0] - 2026-04-30
 
 ### Added

compose.yml

@@ -249,6 +249,7 @@ services:
   metadata-collector-dev:
     build:
       context: ./src/agents
+      target: development
     command: ["python", "metadata_collector.py", "dev"]
     environment:
       - LIVEKIT_URL=ws://livekit:7880
@@ -261,6 +262,7 @@ services:
       - AWS_S3_SECURE_ACCESS=False
     volumes:
       - ./src/agents:/app
+      - /app/.venv
     depends_on:
       - livekit
       - minio
@@ -333,10 +335,12 @@ services:
   multi-user-transcriber:
     build:
       context: ./src/agents
+      target: development
     env_file:
       - env.d/development/multi_user_transcriber
     volumes:
       - ./src/agents:/app
+      - /app/.venv
 
 networks:
   default:

src/agents/.dockerignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__
+*.pyc
+**/__pycache__
+**/*.pyc
+venv
+**/.venv
+
+# System-specific files
+.DS_Store
+**/.DS_Store
+
+# Docker
+docker compose.*
+env.d
+
+# Docs
+docs
+*.md
+*.log
+
+# Development/test cache & configurations
+data
+.cache
+.circleci
+.git
+.iml
+db.sqlite3
+.pylint.d
+
+**/.idea
+**/.vscode
+**/.pytest_cache
+**/.mypy_cache
+**/.ruff_cache
+
+# Frontend
+**/node_modules
+
+# Env
+.env

src/agents/Dockerfile

@@ -6,31 +6,61 @@ RUN apt-get update && apt-get install -y \
     libgobject-2.0-0 \
     && rm -rf /var/lib/apt/lists/*
 
+
+# ---- Builder image ----
 FROM base AS builder
 
-WORKDIR /builder
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:0.10.9 /uv /uvx /bin/
+
+WORKDIR /app
+
+# Install production dependencies without the project itself (cacheable layer)
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --no-dev
 
-COPY pyproject.toml .
+# Install the project
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev
 
-RUN mkdir /install && \
-  pip install --prefix=/install .
 
+# ---- Development image ----
 FROM base AS development
 
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+
+COPY --from=ghcr.io/astral-sh/uv:0.10.9 /uv /uvx /bin/
+
 WORKDIR /app
 
-COPY pyproject.toml .
-RUN pip install --no-cache-dir ".[dev]"
+COPY . /app
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --all-extras
 
-COPY . .
+ENV PATH="/app/.venv/bin:$PATH"
 
 CMD ["python", "metadata_collector.py", "dev"]
 
+
+# ---- Production image ----
 FROM base AS production
 
 WORKDIR /app
 
-COPY --from=builder /install /usr/local
+# Copy the pre-built virtualenv and application source
+COPY --from=builder /app /app
+
+ENV PATH="/app/.venv/bin:$PATH"
 
 # Remove pip to reduce attack surface in production
 RUN pip uninstall -y pip
@@ -39,6 +69,4 @@ RUN pip uninstall -y pip
 ARG DOCKER_USER
 USER ${DOCKER_USER}
 
-COPY ./*.py /app/
-
 CMD ["python", "multi_user_transcriber.py", "start"]