fix(sdk): imports and docker handling (#122)

Author: dineshpinto

.env.example

@@ -6,14 +6,14 @@
 # 1. Rename this file from '.env.example' to '.env'.
 # 2. Fill in the required variables for your setup.
 # 3. DO NOT commit the '.env' file to your version control.
+# 4. Run `gcloud-deploy.sh` to deploy to GCP with the following configuration.
 #
 # Uncomment the variable to change it from its default value.
 # ==============================================================================
 
 # ==============================================================================
 #                     CONFIDENTIAL SPACE DEPLOY CONFIGURATION
 # ==============================================================================
-# Run `gcloud-deploy.sh` to deploy to GCP with the following configuration.
 
 GCP__INSTANCE_NAME=flare-ai-kit
 GCP__PROJECT=verifiable-ai-hackathon

Dockerfile

@@ -1,7 +1,8 @@
 # Parametric Dockerfile for running scripts with specific extras
 # Usage:
 #   docker build -t fai-script-pdf --build-arg EXTRAS=pdf --build-arg SCRIPT=ingest_pdf.py .
-#   docker run --rm -it -v "$PWD/data:/app/scripts/data" fai-script-pdf
+#
+#   docker run --rm -it -v "$PWD/scripts/data:/app/scripts/data" --env-file ".env" fai-script-pdf
 
 # Build arguments for parametric behavior
 ARG EXTRAS=""
@@ -20,23 +21,21 @@ ENV UV_COMPILE_BYTECODE=1 \
 
 WORKDIR /app
 
-# Install system dependencies for PDF processing (if needed)
+# Install system dependencies for PDF processing
 RUN apt-get update && apt-get install -y --no-install-recommends \
     tesseract-ocr \
     tesseract-ocr-eng \
     poppler-utils \
     && rm -rf /var/lib/apt/lists/*
 
-# Copy dependency files first for better caching
+# Copy dependency files first
 COPY uv.lock pyproject.toml ./
 
 # Install dependencies based on EXTRAS parameter
 RUN --mount=type=cache,target=/root/.cache/uv \
     if [ -n "$EXTRAS" ]; then \
         echo "Installing with extras: $EXTRAS"; \
-        # Convert comma-separated extras to space-separated for uv
         EXTRAS_ARGS=$(echo "$EXTRAS" | sed 's/,/ --extra /g'); \
-        echo "Installing extras: $EXTRAS_ARGS"; \
         uv sync --locked --no-install-project --extra $EXTRAS_ARGS --no-dev --no-editable; \
     else \
         echo "Installing base dependencies only"; \
@@ -49,9 +48,7 @@ COPY . /app
 # Install the project itself
 RUN --mount=type=cache,target=/root/.cache/uv \
     if [ -n "$EXTRAS" ]; then \
-        # Convert comma-separated extras to space-separated for uv
         EXTRAS_ARGS=$(echo "$EXTRAS" | sed 's/,/ --extra /g'); \
-        echo "Installing project with extras: $EXTRAS_ARGS"; \
         uv sync --locked --extra $EXTRAS_ARGS --no-dev --no-editable; \
     else \
         uv sync --locked --no-dev --no-editable; \
@@ -67,7 +64,7 @@ FROM python:3.12-slim-bookworm AS runtime
 ARG EXTRAS
 ARG SCRIPT
 
-# Install runtime system dependencies for PDF processing (if needed)
+# Install runtime system dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
     tesseract-ocr \
     tesseract-ocr-eng \
@@ -76,7 +73,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
 
 ENV PIP_NO_CACHE_DIR=1 \
     UV_PYTHON_DOWNLOADS=0 \
-    SCRIPT_NAME="$SCRIPT"
+    SCRIPT_NAME="$SCRIPT" \
+    PYTHONPATH="/app/scripts:/app:$PYTHONPATH"
 
 # Create non-root user
 RUN groupadd -r app && \
@@ -96,4 +94,4 @@ USER app
 RUN test -f "/app/scripts/$SCRIPT" || (echo "Error: Script /app/scripts/$SCRIPT not found" && exit 1)
 
 # Default command runs the specified script
-CMD ["sh", "-c", "cd /app/scripts && python \"$SCRIPT_NAME\""]
+CMD ["sh", "-c", "python \"/app/scripts/$SCRIPT_NAME\""]

pyproject.toml

@@ -23,15 +23,14 @@ classifiers = [
 ]
 requires-python = ">=3.12"
 dependencies = [
-    "google-genai>=1.8.0",
+    "google-genai>=1.51.0",
     "httpx>=0.28.1",
-    "pydantic>=2.11.1",
-    "pydantic-ai>=0.0.46",
-    "structlog>=25.2.0",
-    "tenacity>=8.2.3,<9.0.0",
-    "web3>=7.10.0",
+    "pydantic>=2.12.4",
+    "structlog>=25.5.0",
+    "tenacity>=9.0.0,<10.0.0",
+    "web3>=7.14.0",
     "gitpython>=3.1.45",
-    "google-adk>=1.9.0",
+    "google-adk>=1.19.0",
 ]
 
 [project.urls]
@@ -59,55 +58,49 @@ fassets = [
 ]
 pdf = [
     "pillow>=11.3.0",
-    "pymupdf>=1.26.1",
-    "pytesseract>=0.3.13"
+    "pymupdf>=1.26.6",
+    "pytesseract>=0.3.13",
+    "reportlab>=4.4.5",
+    "dulwich>=0.24.10"
 ]
 rag = [
-    "qdrant-client>=1.13.3",
-    "dulwich>=0.23.2"
+    "qdrant-client==1.15.1",
+    "dulwich>=0.24.10"
 ]
 a2a = [
-    "fastapi[standard]>=0.116.1",
+    "fastapi[standard]>=0.118.0",
 ]
 # Additional functionality groups
 social = [
-    "python-telegram-bot>=22.0",
-    "tweepy>=4.15.0",
+    "python-telegram-bot>=22.5",
+    "tweepy>=4.16.0",
     "async_lru>=2.0.5",
-    "slack-sdk>=3.26.2",
-    "discord.py>=2.3.2"
+    "slack-sdk>=3.38.0",
+    "discord.py>=2.6.4"
 ]
 tee = [
-    "cryptography>=44.0.2",
+    "cryptography>=46.0.3",
     "pyjwt>=2.10.1",
-    "pyopenssl>=25.0.0"
+    "pyopenssl>=25.3.0"
 ]
 wallet = [
-    "httpx>=0.28.1",
-    "cryptography>=44.0.2",
-    "eth-account>=0.13.0",
+    "cryptography>=46.0.3",
+    "eth-account>=0.13.7",
     "pyjwt>=2.10.1",
 ]
-ingestion = [
-    "pillow>=11.3.0",
-    "pymupdf>=1.26.1",
-    "pytesseract>=0.3.13"
-]
 
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [dependency-groups]
 dev = [
-    "pyright>=1.1.398",
-    "pytest>=8.3.5",
-    "pytest-asyncio>=0.26.0",
-    "pytest-mock>=3.14.0",
-    "ruff>=0.11.2",
+    "pyright>=1.1.407",
+    "pytest>=9.0.1",
+    "pytest-asyncio>=1.3.0",
+    "pytest-mock>=3.15.1",
+    "ruff>=0.14.5",
     "settings-doc>=4.3.2",
-    "reportlab>=4.2.0",
-    "gitpython>=3.1.45",
 ]
 
 [tool.ruff]

scripts/data/create_sample_invoice.py

@@ -146,7 +146,6 @@ def create_invoice_and_build_template(
     c.drawRightString(width - 0.7 * inch, 4.0 * inch, AMOUNT_DUE)
 
     c.save()
-    print(f"✅ Created {FILE_PATH}")
 
     # ----- Discover coordinates & build template -----
     with fitz.open(str(FILE_PATH)) as doc:
@@ -168,7 +167,6 @@ def create_invoice_and_build_template(
         }
 
     template = _coords_to_template(template_name, coords)
-    print(f"✅ Built PDF template: {template.template_name}")
     return FILE_PATH, template