refactor(yolo-coral-tpu): migrate from docker to native python execution

Author: solderzzc

skills/detection/yolo-detection-2026-coral-tpu/Dockerfile

@@ -5,13 +5,24 @@ version: 1.0.0
 icon: assets/icon.png
 entry: scripts/monitor.js
 deploy: deploy.sh
-runtime: docker
+runtime: node
 
 requirements:
-  docker: ">=20.10"
-  usb: true
   platforms: ["linux", "macos", "windows"]
 
+manual_setup:
+  macos: |
+    # 1. Fix Homebrew permissions and install libusb
+    sudo chown -R $(whoami) /opt/homebrew
+    brew install libusb
+
+    # 2. Add Apple Silicon Edge TPU native driver
+    curl -sSLO https://github.com/feranick/libedgetpu/releases/download/16.0TF2.19.1-1/libedgetpu-16.0-tf2.19.1-1_MacOS_Silicon.zip
+    unzip -q -o libedgetpu-16.0-tf2.19.1-1_MacOS_Silicon.zip
+    sudo mkdir -p /usr/local/lib
+    sudo cp libedgetpu.1.dylib /usr/local/lib/
+    rm -rf libedgetpu*
+
 parameters:
   - name: auto_start
     label: "Auto Start"

skills/detection/yolo-detection-2026-coral-tpu/SKILL.md

@@ -1,128 +1,109 @@
 #!/usr/bin/env bash
-# deploy.sh — Docker-based bootstrapper for Coral TPU Detection Skill
+# deploy.sh — Native local bootstrapper for Coral TPU Detection Skill
 #
-# Builds the Docker image locally and verifies Edge TPU connectivity.
+# Builds a local Python virtual environment and verifies Edge TPU connectivity.
 # Called by Aegis skill-runtime-manager during installation.
 #
 # Exit codes:
 #   0 = success
-#   1 = fatal error (Docker not found)
+#   1 = fatal error (Python/pip not found)
 #   2 = partial success (no TPU detected, will use CPU fallback)
 
 set -euo pipefail
 
 SKILL_DIR="$(cd "$(dirname "$0")" && pwd)"
-IMAGE_NAME="aegis-coral-tpu"
-IMAGE_TAG="latest"
 LOG_PREFIX="[coral-tpu-deploy]"
 
 log()  { echo "$LOG_PREFIX $*" >&2; }
 emit() { echo "$1"; }  # JSON to stdout for Aegis to parse
 
-# ─── Step 1: Check Docker ────────────────────────────────────────────────────
-
-find_docker() {
-    for cmd in docker podman; do
-        if command -v "$cmd" &>/dev/null; then
-            echo "$cmd"
-            return 0
-        fi
-    done
-    return 1
-}
-
-DOCKER_CMD=$(find_docker) || {
-    log "ERROR: Docker (or Podman) not found. Install Docker Desktop 4.35+ and retry."
-    emit '{"event": "error", "stage": "docker", "message": "Docker not found. Install Docker Desktop 4.35+"}'
-    exit 1
-}
+# ─── Step 1: Detect Platform ────────────────────────────────────────────────
+
+PLATFORM="$(uname -s)"
+ARCH="$(uname -m)"
+log "Platform: $PLATFORM ($ARCH)"
+emit "{\"event\": \"progress\", \"stage\": \"platform\", \"message\": \"Platform: $PLATFORM/$ARCH\"}"
 
-# Verify Docker is running
-if ! "$DOCKER_CMD" info &>/dev/null; then
-    log "ERROR: Docker daemon is not running. Start Docker Desktop and retry."
-    emit '{"event": "error", "stage": "docker", "message": "Docker daemon not running"}'
+if [ "$PLATFORM" = "Linux" ]; then
+    log "Linux: ensuring system packages are installed..."
+    emit '{"event": "progress", "stage": "platform", "message": "Ensuring Linux dependencies..."}'
+    sudo apt-get update >/dev/null 2>&1 || true
+    sudo apt-get install -y --no-install-recommends \
+        python3 python3-pip python3-venv libusb-1.0-0 >/dev/null 2>&1 || true
+fi
+
+# ─── Step 2: Ensure Python 3 ────────────────────────────────────────────────
+
+if ! command -v python3 &>/dev/null; then
+    log "ERROR: Python 3 not found."
+    emit '{"event": "error", "stage": "python", "message": "Python 3 not found"}'
     exit 1
 fi
 
-DOCKER_VER=$("$DOCKER_CMD" version --format '{{.Server.Version}}' 2>/dev/null || echo "unknown")
-log "Using $DOCKER_CMD (version: $DOCKER_VER)"
-emit "{\"event\": \"progress\", \"stage\": \"docker\", \"message\": \"Docker ready ($DOCKER_VER)\"}"
+PYTHON_CMD="python3"
+log "Using Python: $($PYTHON_CMD --version)"
+emit '{"event": "progress", "stage": "python", "message": "Python verified"}'
 
-# ─── Step 2: Detect platform for USB access hints ───────────────────────────
+# ─── Step 3: Create Virtual Environment ─────────────────────────────────────
 
-PLATFORM="$(uname -s)"
-ARCH="$(uname -m)"
-USB_FLAG=""
-
-case "$PLATFORM" in
-    Linux)
-        USB_FLAG="--device /dev/bus/usb"
-        log "Platform: Linux — will use --device /dev/bus/usb"
-        ;;
-    Darwin)
-        log "Platform: macOS ($ARCH) — Docker Desktop 4.35+ USB/IP required"
-        log "Ensure Docker Desktop Settings → Features → USB devices is enabled"
-        # macOS Docker Desktop 4.35+ handles USB/IP transparently
-        # No --device flag needed, but privileged may be required
-        USB_FLAG="--privileged"
-        ;;
-    MINGW*|MSYS*|CYGWIN*)
-        log "Platform: Windows — Docker Desktop 4.35+ USB/IP or WSL2 backend"
-        USB_FLAG="--privileged"
-        ;;
-    *)
-        log "Platform: Unknown ($PLATFORM) — attempting with --privileged"
-        USB_FLAG="--privileged"
-        ;;
-esac
+VENV_DIR="$SKILL_DIR/venv"
+log "Setting up virtual environment in $VENV_DIR..."
+emit '{"event": "progress", "stage": "build", "message": "Creating Python virtual environment..."}'
 
-emit "{\"event\": \"progress\", \"stage\": \"platform\", \"message\": \"Platform: $PLATFORM/$ARCH\"}"
+"$PYTHON_CMD" -m venv "$VENV_DIR"
 
-# ─── Step 3: Build Docker image ─────────────────────────────────────────────
+# Ensure the venv works
+if [ ! -f "$VENV_DIR/bin/python" ]; then
+    log "ERROR: Failed to create virtual environment."
+    emit '{"event": "error", "stage": "build", "message": "Failed to create venv"}'
+    exit 1
+fi
 
-log "Building Docker image: $IMAGE_NAME:$IMAGE_TAG ..."
-emit '{"event": "progress", "stage": "build", "message": "Building Docker image (this may take a few minutes)..."}'
+# ─── Step 4: Install Dependencies ───────────────────────────────────────────
 
-if "$DOCKER_CMD" build -t "$IMAGE_NAME:$IMAGE_TAG" "$SKILL_DIR" 2>&1 | while read -r line; do
-    log "$line"
-done; then
-    log "Docker image built successfully"
-    emit '{"event": "progress", "stage": "build", "message": "Docker image ready"}'
-else
-    log "ERROR: Docker build failed"
-    emit '{"event": "error", "stage": "build", "message": "Docker image build failed"}'
+log "Installing Python dependencies (this may take a minute)..."
+emit '{"event": "progress", "stage": "build", "message": "Installing ai-edge-litert and dependencies..."}'
+
+# Upgrade pip securely
+"$VENV_DIR/bin/python" -m pip install --upgrade pip >/dev/null 2>&1 || true
+
+# Install requirements
+if ! "$VENV_DIR/bin/python" -m pip install -r "$SKILL_DIR/requirements.txt"; then
+    log "ERROR: Failed to install Python dependencies."
+    emit '{"event": "error", "stage": "build", "message": "pip install failed"}'
     exit 1
 fi
 
-# ─── Step 4: Probe for Edge TPU devices ──────────────────────────────────────
+log "Dependencies installed successfully."
+emit '{"event": "progress", "stage": "build", "message": "Python environment ready"}'
 
-log "Probing for Edge TPU devices..."
-emit '{"event": "progress", "stage": "probe", "message": "Checking for Edge TPU devices..."}'
+# ─── Step 5: Probe for Edge TPU devices ──────────────────────────────────────
+
+log "Probing for Edge TPU devices natively..."
+emit '{"event": "progress", "stage": "probe", "message": "Checking for physical Edge TPU..."}'
 
 TPU_FOUND=false
-PROBE_OUTPUT=$("$DOCKER_CMD" run --rm $USB_FLAG \
-    "$IMAGE_NAME:$IMAGE_TAG" python3 scripts/tpu_probe.py 2>/dev/null) || true
+# Run probe inside the venv
+PROBE_OUTPUT=$("$VENV_DIR/bin/python" "$SKILL_DIR/scripts/tpu_probe.py" 2>/dev/null) || true
 
 if echo "$PROBE_OUTPUT" | grep -q '"available": true'; then
-    TPU_COUNT=$(echo "$PROBE_OUTPUT" | python3 -c "import sys,json; print(json.load(sys.stdin)['count'])" 2>/dev/null || echo "?")
+    TPU_COUNT=$(echo "$PROBE_OUTPUT" | "$VENV_DIR/bin/python" -c "import sys,json; print(json.load(sys.stdin)['count'])" 2>/dev/null || echo "?")
     TPU_FOUND=true
     log "Edge TPU detected: $TPU_COUNT device(s)"
-    emit "{\"event\": \"progress\", \"stage\": \"probe\", \"message\": \"Found $TPU_COUNT Edge TPU device(s)\"}"
+    emit "{\"event\": \"progress\", \"stage\": \"probe\", \"message\": \"Found $TPU_COUNT Edge TPU device(s) natively\"}"
 else
     log "WARNING: No Edge TPU detected — skill will run in CPU fallback mode"
     emit '{"event": "progress", "stage": "probe", "message": "No Edge TPU detected — CPU fallback available"}'
 fi
 
-# ─── Step 5: Complete ────────────────────────────────────────────────────────
-
 # ─── Step 6: Complete ────────────────────────────────────────────────────────
 
 if [ "$TPU_FOUND" = true ]; then
-    emit "{\"event\": \"complete\", \"status\": \"success\", \"tpu_found\": true, \"message\": \"Coral TPU skill installed — Edge TPU ready\"}"
+    emit "{\"event\": \"complete\", \"status\": \"success\", \"tpu_found\": true, \"message\": \"Native Coral TPU skill installed — Edge TPU ready\"}"
     log "Done! Edge TPU ready."
     exit 0
 else
-    emit "{\"event\": \"complete\", \"status\": \"partial\", \"tpu_found\": false, \"message\": \"Coral TPU skill installed — no TPU detected (CPU fallback)\"}"
+    emit "{\"event\": \"complete\", \"status\": \"partial\", \"tpu_found\": false, \"message\": \"Native Coral TPU skill installed — no TPU detected (CPU fallback)\"}"
     log "Done with warning: no TPU detected. Connect Coral USB and restart."
     exit 2
 fi

skills/detection/yolo-detection-2026-coral-tpu/deploy.sh

@@ -1,72 +1,45 @@
 /**
- * Coral TPU Monitor
- * Host-side wrapper to launch the Coral TPU Docker container.
- * Matches the CameraClaw architecture by acting as the skill entrypoint.
+ * Coral TPU Monitor (Native)
+ * Host-side wrapper to launch the Python detection script directly
+ * using the natively built virtual environment.
  */
 
 const { spawn } = require('node:child_process');
+const path = require('node:path');
 const os = require('node:os');
-const fs = require('node:fs');
 
 function main() {
-  const imageName = 'aegis-coral-tpu';
-  const imageTag = 'latest';
-
-  const cmd = 'docker';
-  const args = ['run', '-i', '--rm'];
-
-  // Extra PATH augmentation to ensure docker is found when launched via Electron on macOS
-  const extraPaths = ['/opt/homebrew/bin', '/usr/local/bin', '/usr/bin'];
-  const currentPath = process.env.PATH || '';
-  const missing = extraPaths.filter(p => !currentPath.split(':').includes(p));
-  if (missing.length > 0) {
-    process.env.PATH = [...missing, currentPath].join(':');
-  }
-
-  // Handle USB Passthrough (Coral Edge TPU)
-  // macOS/Windows handle USB dynamically via Docker Desktop 4.35+
-  // Only Linux requires explicit device mounting
-  if (os.platform() === 'linux' && fs.existsSync('/dev/bus/usb')) {
-    args.push('--device', '/dev/bus/usb:/dev/bus/usb');
-  }
-
-  // Shared memory volume for video frames
-  const path = require('node:path');
-  const sharedMemoryHost = path.join(os.tmpdir(), 'aegis-detection-frames');
-  if (!fs.existsSync(sharedMemoryHost)) {
-    fs.mkdirSync(sharedMemoryHost, { recursive: true });
+  const skillRoot = path.join(__dirname, '..');
+  
+  // Determine Python executable inside the venv
+  const isWindows = os.platform() === 'win32';
+  const pythonCmd = isWindows 
+    ? path.join(skillRoot, 'venv', 'Scripts', 'python.exe')
+    : path.join(skillRoot, 'venv', 'bin', 'python3');
+
+  const args = [path.join(skillRoot, 'scripts', 'detect.py')];
+
+  // We no longer need volume mapping, the python script accesses
+  // the host's raw /tmp/aegis-detection-frames directories directly!
+
+  const env = { ...process.env };
+  if (!env.PYTHONUNBUFFERED) {
+    env.PYTHONUNBUFFERED = '1';
   }
-  // Map the host path to the EXACT same absolute path inside the container
-  // This allows the raw JSON `frame_path` from Aegis to work without translation.
-  args.push('-v', `${sharedMemoryHost}:${sharedMemoryHost}`);
-
-  // Pass through Aegis parameters and ID dynamically
-  for (const [key, val] of Object.entries(process.env)) {
-    if (key.startsWith('AEGIS_') || key === 'PYTHONUNBUFFERED') {
-      args.push('--env', `${key}=${val}`);
-    }
-  }
-
-  if (!process.env.PYTHONUNBUFFERED) {
-    args.push('--env', 'PYTHONUNBUFFERED=1');
-  }
-
-  args.push(`${imageName}:${imageTag}`);
 
-  const child = spawn(cmd, args, {
-    stdio: 'inherit'
+  const child = spawn(pythonCmd, args, {
+    stdio: 'inherit',
+    cwd: skillRoot,
+    env
   });
 
   child.on('error', (err) => {
-    console.log(JSON.stringify({
-      event: 'error',
-      message: `Docker is not installed or not in PATH: ${err.message}`,
-      retriable: false
-    }));
+    console.error(`[coral-monitor] Failed to start native python process: ${err.message}`);
     process.exit(1);
   });
 
-  child.on('exit', (code) => {
+  child.on('exit', (code, signal) => {
+    console.log(`[coral-monitor] Python process exited with code ${code} (signal ${signal})`);
     process.exit(code || 0);
   });
 }