Release version 0.1.10

### Added
- Changes in CHANGELOG.md
- Changes in README.md
- Changes in containers/browser-service/Dockerfile
- Changes in containers/llm-orchestrator/api.py
- Changes in containers/video-chat/Dockerfile
- Changes in containers/video-chat/package.json
- Changes in install.sh
- Changes in pyproject.toml
- Changes in run.sh
- Changes in setup.py
- Changes in update/version.sh

Author: tom-sapletta-com

CHANGELOG.md

@@ -27,10 +27,13 @@ coBoarding to kompleksowy, kontenerowy system do automatycznego wypełniania for
 ```bash
 git clone https://github.com/coboarding/coboarding.git
 cd coBoarding
-bash run.sh  # lub ./run.ps1 na Windows
+bash install.sh  # automatyczna instalacja zależności i Docker Compose v2
+bash run.sh      # lub ./run.ps1 na Windows
 ```
 
-Pierwsze uruchomienie automatycznie skonfiguruje środowisko (venv, zależności, kontenery).
+Pierwsze uruchomienie automatycznie skonfiguruje środowisko (venv, zależności, kontenery, Docker Compose v2).
+
+> **WAŻNE:** Projekt wymaga Docker Compose v2 (polecenie `docker compose`). Skrypt `install.sh` instaluje go automatycznie jako plugin CLI.
 
 ## Instalacja środowiska (Python 3.11+ / 3.12 na Ubuntu 24.10+)
 
@@ -55,7 +58,12 @@ pip install -r requirements.txt
 
 Możesz także użyć skryptu:
 ```bash
-bash install.sh
+bash install.sh  # automatyczna instalacja Docker Compose v2 (plugin CLI)
+```
+
+Po instalacji Compose v2 dostępne będzie jako polecenie:
+```bash
+docker compose version
 ```
 
 > **Uwaga dot. PyAudio i Python 3.12:**
@@ -209,6 +217,17 @@ System można uruchomić w trzech trybach:
 3. **Problem:** Model LLM nie jest pobierany automatycznie
    **Rozwiązanie:** Pobierz model ręcznie i umieść go w katalogu `models/`
 
+## Szczegółowe logowanie i debugowanie
+
+W plikach Dockerfile, `install.sh` oraz `run.sh` zostały dodane szczegółowe komunikaty [DEBUG] oraz [INFO].
+
+- Każdy kluczowy etap instalacji, budowy obrazu i uruchamiania usług jest logowany.
+- Logi pomagają szybko zlokalizować miejsce, gdzie wystąpił problem.
+- W terminalu zobaczysz wyraźne komunikaty o postępie i ewentualnych błędach.
+
+**Wskazówka:**
+Jeśli coś pójdzie nie tak, sprawdź logi [DEBUG] w konsoli — wskażą, na którym etapie pojawił się problem.
+
 ## Jak to działa
 
 1. System analizuje CV użytkownika, parsując kluczowe informacje (doświadczenie, umiejętności, wykształcenie).

README.md

@@ -1,9 +1,10 @@
 FROM debian:bullseye-slim
 
-# Tymczasowo przekieruj interaktywne dialogi podczas instalacji
+# Temporarily redirect interactive dialogs during installation
 ENV DEBIAN_FRONTEND=noninteractive
 
-# Instalacja zależności
+# Install dependencies
+RUN apt-get update && apt-get install -y xvfb
 RUN apt-get update && apt-get install -y --no-install-recommends \
     python3 python3-pip \
     tigervnc-standalone-server \
@@ -31,70 +32,132 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     unzip \
     && rm -rf /var/lib/apt/lists/*
 
-# Instalacja Chrome (nowy sposób dodania klucza)
+# Install Chrome (new way to add the key)
 RUN set -eux; \
+    echo '[DEBUG] Creating directory for Chrome GPG key...'; \
     mkdir -p /etc/apt/keyrings; \
-    wget -qO /etc/apt/keyrings/google-linux-signing-key.gpg https://dl.google.com/linux/linux_signing_key.pub; \
+    echo '[DEBUG] Downloading Chrome GPG key...'; \
+    wget -qO- https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor > /etc/apt/keyrings/google-linux-signing-key.gpg; \
+    echo '[DEBUG] Adding Chrome repository to sources.list...'; \
     echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/google-linux-signing-key.gpg] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list; \
+    echo '[DEBUG] apt-get update'; \
     apt-get update; \
-    apt-get install -y google-chrome-stable; \
-    rm -rf /var/lib/apt/lists/*
+    echo '[DEBUG] Installing google-chrome-stable'; \
+    apt-get install -y --no-install-recommends google-chrome-stable; \
+    echo '[DEBUG] apt-get clean'; \
+    apt-get clean; \
+    echo '[DEBUG] Cleaning apt cache'; \
+    rm -rf /var/lib/apt/lists/*; \
+    echo '[DEBUG] Chrome installation completed.'
 
-# Instalacja Firefox
-RUN apt-get update && apt-get install -y --no-install-recommends \
+# Install Firefox
+RUN echo '[DEBUG] Installing Firefox...'; \
+    apt-get update && apt-get install -y --no-install-recommends \
     firefox-esr \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/*; \
+    echo '[DEBUG] Firefox installation completed.'
 
-# Instalacja ChromeDriver z fallbackiem na najnowszą wersję
+# Install ChromeDriver with better fallback mechanism
+# Install ChromeDriver with improved fallback mechanism
 RUN set -eux; \
-    CHROME_VERSION=$(google-chrome --version | awk '{print $3}' | cut -d '.' -f 1); \
-    CHROMEDRIVER_VERSION=$(curl -s "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_${CHROME_VERSION}" || curl -s https://chromedriver.storage.googleapis.com/LATEST_RELEASE); \
-    wget -q "https://chromedriver.storage.googleapis.com/${CHROMEDRIVER_VERSION}/chromedriver_linux64.zip"; \
-    unzip chromedriver_linux64.zip -d /usr/local/bin; \
-    rm chromedriver_linux64.zip; \
-    chmod +x /usr/local/bin/chromedriver
+    echo '[DEBUG] Installing ChromeDriver...'; \
+    CHROME_VERSION=$(google-chrome --version | awk '{print $3}'); \
+    CHROME_MAJOR_VERSION=$(echo $CHROME_VERSION | cut -d '.' -f 1); \
+    echo "[DEBUG] Detected Chrome version: ${CHROME_VERSION} (Major: ${CHROME_MAJOR_VERSION})"; \
+    if curl -s -f "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_${CHROME_MAJOR_VERSION}" > /dev/null; then \
+        CHROMEDRIVER_VERSION=$(curl -s "https://chromedriver.storage.googleapis.com/LATEST_RELEASE_${CHROME_MAJOR_VERSION}"); \
+        echo "[DEBUG] Found matching ChromeDriver version: ${CHROMEDRIVER_VERSION}"; \
+    else \
+        echo "[DEBUG] No specific ChromeDriver for Chrome ${CHROME_MAJOR_VERSION}, using latest release"; \
+        CHROMEDRIVER_VERSION=$(curl -s "https://chromedriver.storage.googleapis.com/LATEST_RELEASE"); \
+        if [ -z "$CHROMEDRIVER_VERSION" ] || [[ "$CHROMEDRIVER_VERSION" == *"<?xml"* ]]; then \
+            echo "[DEBUG] Failed to get latest release, using fixed version"; \
+            CHROMEDRIVER_VERSION="114.0.5735.90"; \
+        fi; \
+    fi; \
+    echo "[DEBUG] Using ChromeDriver version: ${CHROMEDRIVER_VERSION}"; \
+    # Try downloading from the standard location
+    if wget -q --spider "https://chromedriver.storage.googleapis.com/${CHROMEDRIVER_VERSION}/chromedriver_linux64.zip"; then \
+        wget -q "https://chromedriver.storage.googleapis.com/${CHROMEDRIVER_VERSION}/chromedriver_linux64.zip"; \
+    # Try alternative location (newer Chrome versions)
+    elif wget -q --spider "https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/${CHROMEDRIVER_VERSION}/linux64/chromedriver-linux64.zip"; then \
+        wget -q "https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/${CHROMEDRIVER_VERSION}/linux64/chromedriver-linux64.zip" -O chromedriver_linux64.zip; \
+    # Fall back to known working version
+    else \
+        echo "[DEBUG] Falling back to known working version 114.0.5735.90"; \
+        wget -q "https://chromedriver.storage.googleapis.com/114.0.5735.90/chromedriver_linux64.zip"; \
+    fi; \
+    # Handle different archive structures
+    mkdir -p /tmp/chromedriver; \
+    unzip -q chromedriver_linux64.zip -d /tmp/chromedriver; \
+    if [ -f /tmp/chromedriver/chromedriver ]; then \
+        mv /tmp/chromedriver/chromedriver /usr/local/bin/; \
+    elif [ -d /tmp/chromedriver/chromedriver-linux64 ]; then \
+        mv /tmp/chromedriver/chromedriver-linux64/chromedriver /usr/local/bin/; \
+    else \
+        find /tmp/chromedriver -name "chromedriver" -type f -exec mv {} /usr/local/bin/ \; ; \
+    fi; \
+    rm -rf /tmp/chromedriver chromedriver_linux64.zip; \
+    chmod +x /usr/local/bin/chromedriver; \
+    echo '[DEBUG] ChromeDriver installation completed.'
 
-# Instalacja GeckoDriver (Firefox)
+# Install GeckoDriver (Firefox)
 RUN set -eux; \
-    GECKO_DRIVER_VERSION=$(curl -s https://api.github.com/repos/mozilla/geckodriver/releases/latest | grep tag_name | cut -d '"' -f 4); \
+    echo '[DEBUG] Installing jq for parsing JSON...'; \
+    apt-get update && apt-get install -y jq && rm -rf /var/lib/apt/lists/*; \
+    echo '[DEBUG] Installing GeckoDriver...'; \
+    GECKO_DRIVER_VERSION=$(curl -s https://api.github.com/repos/mozilla/geckodriver/releases/latest | jq -r .tag_name); \
+    echo "[DEBUG] GeckoDriver version: $GECKO_DRIVER_VERSION"; \
     wget -q "https://github.com/mozilla/geckodriver/releases/download/${GECKO_DRIVER_VERSION}/geckodriver-${GECKO_DRIVER_VERSION}-linux64.tar.gz"; \
     tar -xzf "geckodriver-${GECKO_DRIVER_VERSION}-linux64.tar.gz" -C /usr/local/bin; \
     rm "geckodriver-${GECKO_DRIVER_VERSION}-linux64.tar.gz"; \
-    chmod +x /usr/local/bin/geckodriver
+    chmod +x /usr/local/bin/geckodriver; \
+    echo '[DEBUG] GeckoDriver installation completed.'
 
-# Instalacja menedżerów haseł CLI
-RUN curl -fsSL https://get.bitwarden.com/sh | bash
+# Install CLI password managers
+RUN echo '[DEBUG] Installing Bitwarden CLI...'; \
+    curl -fsSL https://get.bitwarden.com/sh | bash; \
+    echo '[DEBUG] Bitwarden CLI installation completed.'
 
-# Tworzymy strukturę katalogów
-RUN mkdir -p /app/cv /app/config /app/passwords /app/recordings /app/scripts \
+# Create directory structure
+RUN echo '[DEBUG] Creating application directory structure...'; \
+    mkdir -p /app/cv /app/config /app/passwords /app/recordings /app/scripts \
     && mkdir -p /opt/scripts \
     && mkdir -p /root/.vnc \
-    && mkdir -p /var/log/supervisor
+    && mkdir -p /var/log/supervisor; \
+    echo '[DEBUG] Directory structure created.'
 
-# Kopiowanie skryptów
+# Copy scripts
 COPY scripts/ /opt/scripts/
-RUN chmod +x /opt/scripts/*.sh
+RUN echo '[DEBUG] Setting execution permissions for .sh scripts...'; \
+    chmod +x /opt/scripts/*.sh; \
+    echo '[DEBUG] .sh scripts have execution permissions.'
 
-# Kopiowanie plików konfiguracyjnych
+# Copy configuration files
 COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
+RUN echo '[DEBUG] Copied supervisord.conf configuration file.'
 
-# Instalacja zależności Pythona
+# Install Python dependencies
 COPY requirements.txt /app/
-RUN pip3 install --no-cache-dir -r /app/requirements.txt
+RUN echo '[DEBUG] Installing Python dependencies...'; \
+    pip3 install --no-cache-dir -r /app/requirements.txt; \
+    echo '[DEBUG] Python dependencies installation completed.'
 
-# Konfiguracja TigerVNC
-RUN mkdir -p /root/.vnc && \
+# Configure TigerVNC
+RUN echo '[DEBUG] Configuring TigerVNC...'; \
+    mkdir -p /root/.vnc && \
     echo "#!/bin/sh" > /root/.vnc/xstartup && \
     echo "xrdb $HOME/.Xresources" >> /root/.vnc/xstartup && \
     echo "startfluxbox &" >> /root/.vnc/xstartup && \
-    chmod +x /root/.vnc/xstartup
+    chmod +x /root/.vnc/xstartup; \
+    echo '[DEBUG] TigerVNC configuration completed.'
 
-# Ustawienie zmiennych środowiskowych
+# Set environment variables
 ENV DISPLAY=:99
 ENV PYTHONUNBUFFERED=1
 
-# Ekspozycja portu VNC
+# Expose VNC port
 EXPOSE 5900
 
-# Uruchomienie supervisora
+# Run supervisor
 CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

containers/browser-service/Dockerfile

@@ -1,6 +1,11 @@
 # Main API entry point for LLM Orchestrator
 # llm-orchestrator/api.py (fragment)
 
+from flask import Flask, request, jsonify
+import requests
+
+app = Flask(__name__)
+
 @app.route('/fill-form', methods=['POST'])
 def fill_form():
     """Endpoint do wypełniania formularzy (używany przez testy)"""

containers/llm-orchestrator/api.py

@@ -34,6 +34,8 @@ RUN openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
 # Budowa aplikacji
 RUN npm run build
 
+RUN ls -l /app/src
+
 # Ekspozycja portu HTTPS
 EXPOSE 443
 

containers/video-chat/Dockerfile

@@ -9,30 +9,31 @@
     "dev": "webpack --mode development --watch"
   },
   "dependencies": {
-    "express": "^4.18.2",
-    "socket.io": "^4.7.2",
-    "cors": "^2.8.5",
     "axios": "^1.4.0",
-    "ws": "^8.13.0",
-    "node-fetch": "^2.6.12",
-    "https": "^1.0.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
     "fs": "^0.0.1-security",
+    "google-tts-api": "^2.0.2",
+    "https": "^1.0.0",
+    "node-fetch": "^2.6.12",
     "path": "^0.12.7",
+    "socket.io": "^4.7.2",
+    "socket.io-client": "^4.8.1",
     "uuid": "^9.0.0",
-    "google-tts-api": "^2.0.2",
-    "dotenv": "^16.3.1"
+    "ws": "^8.13.0"
   },
   "devDependencies": {
-    "webpack": "^5.88.2",
-    "webpack-cli": "^5.1.4",
-    "css-loader": "^6.8.1",
-    "style-loader": "^3.3.3",
-    "html-webpack-plugin": "^5.5.3",
-    "clean-webpack-plugin": "^4.0.0",
-    "file-loader": "^6.2.0",
-    "babel-loader": "^9.1.3",
     "@babel/core": "^7.22.10",
     "@babel/preset-env": "^7.22.10",
-    "@babel/preset-react": "^7.22.5"
+    "@babel/preset-react": "^7.22.5",
+    "babel-loader": "^9.1.3",
+    "clean-webpack-plugin": "^4.0.0",
+    "css-loader": "^6.8.1",
+    "file-loader": "^6.2.0",
+    "html-webpack-plugin": "^5.5.3",
+    "style-loader": "^3.3.3",
+    "webpack": "^5.88.2",
+    "webpack-cli": "^5.1.4"
   }
-}
+}

containers/video-chat/package.json

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24" width="24"><path d="M0 0h24v24H0z" fill="none"/><path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z"/></svg>

containers/video-chat/src/favicon.ico

@@ -0,0 +1,36 @@
+#!/bin/bash
+# dev.sh - Uruchamianie minimalnego stacka i testowanie llm-orchestrator
+set -e
+
+COMPOSE_FILE="docker-compose.minimal.yml"
+TEST_DIR="test-examples"
+
+# 1. Buduj i uruchom minimalny stack w tle
+echo "[INFO] Buduję i uruchamiam stack ($COMPOSE_FILE)..."
+docker-compose -f "$COMPOSE_FILE" up --build -d
+
+# 2. Poczekaj aż llm-orchestrator będzie dostępny (port 5000)
+echo "[INFO] Czekam na uruchomienie llm-orchestrator na porcie 5000..."
+for i in {1..30}; do
+  if curl -s http://localhost:5000/ > /dev/null; then
+    echo "[INFO] llm-orchestrator jest dostępny."
+    break
+  fi
+  sleep 2
+done
+
+# 3. Uruchom testy przykładowe (jeśli katalog i skrypt istnieją)
+if [ -d "$TEST_DIR" ] && [ -f "$TEST_DIR/run_examples.py" ]; then
+  echo "[INFO] Uruchamiam testy przykładowe..."
+  docker-compose -f "$COMPOSE_FILE" run --rm test-client
+else
+  echo "[WARN] Brak katalogu $TEST_DIR lub pliku run_examples.py - pomijam testy."
+fi
+
+# 4. Wyświetl logi llm-orchestrator po testach
+echo "[INFO] Logi llm-orchestrator po testach:"
+docker-compose -f "$COMPOSE_FILE" logs llm-orchestrator
+
+# 5. Zatrzymaj stack po zakończeniu
+echo "[INFO] Zatrzymuję stack..."
+docker-compose -f "$COMPOSE_FILE" down

dev.sh

@@ -0,0 +1,41 @@
+version: '3.8'
+
+services:
+  llm-orchestrator:
+    build:
+      context: ./containers/llm-orchestrator
+    container_name: llm-orchestrator
+    volumes:
+      - ./volumes/models:/app/models
+      - ./volumes/config:/app/config
+      - ./volumes/cv:/app/cv:ro
+    environment:
+      - NVIDIA_VISIBLE_DEVICES=all
+    deploy:
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: all
+              capabilities: [gpu]
+    ports:
+      - "5000:5000"  # API LLM
+    networks:
+      - autoformfiller-network
+
+  # Dodaj prosty serwis testowy do przykładowych zapytań
+  test-client:
+    image: python:3.9-slim
+    container_name: test-client
+    volumes:
+      - ./test-examples:/test-examples
+    working_dir: /test-examples
+    command: ["python", "run_examples.py"]
+    networks:
+      - autoformfiller-network
+    depends_on:
+      - llm-orchestrator
+
+networks:
+  autoformfiller-network:
+    driver: bridge