feat: introduce MCP server, cross-platform runtime, and Showcase UI reorganization

- Showcase UI Reorganization: * Move web UI dashboard from root directory into apps/showcase_ui/ for cleaner project structure * Add 'artemis ui' CLI command (artemis/interfaces/cli/commands/ui.py) and launcher scripts for the interactive showcase console - Standalone MCP Server & Notifiers (mcp_server/): * Implement dedicated MCP server package with mobile automation tools (device_state, inspect_trace, task_manager, task_runner) * Add multi-channel notifiers (AgentAPI, Desktop notifications, Webhooks, File output, and Composite routing) * Introduce background task runner and trace store for autonomous mobile execution monitoring - Cross-Platform Runtime & Toolchain Support: * Add artemis/platform/ with OS-specific implementations for Linux, macOS (Darwin), and Windows * Add artemis/runtime/supervisor.py for resilient process and agent runtime supervision * Add artemis/toolchain/ with dependency resolution and SDK descriptors * Add cross-platform launcher scripts (start.sh, start.bat) and installer scripts (scripts/install_deps.*) - Core Enhancements & Diagnostics: * Enhance coordinate normalization, OCR API fallback, and perception pipeline * Add credential validation (credentials_validator.py) and system diagnostics * Update bilingual documentation (README.md, README_CN.md) and architecture diagrams - Test Suite Expansion: * Add integration tests for cloud gateway, remote ADB, and Artemis login * Add unit tests covering core diagnostics, platform detection, toolchain, credentials validator, optional OCR, and MCP tools
2026-08-18 13:59:27 -07:00
1 parent 78e478f502
commit 9a5aaf99b7
@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -euo pipefail
+
+BOLD='\033[1m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "${SCRIPT_DIR}"
+
+echo -e "${BOLD}${CYAN}======================================================${NC}"
+echo -e "${BOLD}${CYAN}      ✨ Artemis Autonomous Mobile Agent UI          ${NC}"
+echo -e "${BOLD}${CYAN}======================================================${NC}"
+echo ""
+
+# 1. Normalize PATH with standard toolchain and package manager paths
+STANDARD_PATHS=(
+    "/opt/homebrew/bin"
+    "/opt/homebrew/sbin"
+    "/usr/local/bin"
+    "/usr/local/sbin"
+    "${HOME}/.local/bin"
+    "${HOME}/.cargo/bin"
+    "${HOME}/Library/Android/sdk/platform-tools"
+    "${HOME}/Android/Sdk/platform-tools"
+)
+for p in "${STANDARD_PATHS[@]}"; do
+    if [ -d "${p}" ] && [[ ":${PATH}:" != *":${p}:"* ]]; then
+        export PATH="${p}:${PATH}"
+    fi
+done
+
+# 2. Check or install uv (Fast Python package manager)
+if ! command -v uv >/dev/null 2>&1; then
+    echo -e "${YELLOW}⚡ uv not found. Installing Astral uv...${NC}"
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    export PATH="${HOME}/.local/bin:${HOME}/.cargo/bin:${PATH}"
+fi
+
+# 3. Check and auto-install missing system toolchains (ADB, FFmpeg, scrcpy)
+MISSING_CORE=()
+if ! command -v adb >/dev/null 2>&1; then MISSING_CORE+=("adb"); fi
+if ! command -v ffmpeg >/dev/null 2>&1; then MISSING_CORE+=("ffmpeg"); fi
+if ! command -v scrcpy >/dev/null 2>&1; then MISSING_CORE+=("scrcpy"); fi
+
+if [ ${#MISSING_CORE[@]} -gt 0 ]; then
+    OS_NAME="$(uname -s)"
+    if [ "${OS_NAME}" = "Darwin" ]; then
+        export HOMEBREW_NO_AUTO_UPDATE=1
+        export HOMEBREW_NO_INSTALL_CLEANUP=1
+        export HOMEBREW_NO_ENV_HINTS=1
+
+        if ! command -v brew >/dev/null 2>&1; then
+            if [ -x "/opt/homebrew/bin/brew" ]; then
+                eval "$(/opt/homebrew/bin/brew shellenv)"
+            elif [ -x "/usr/local/bin/brew" ]; then
+                eval "$(/usr/local/bin/brew shellenv)"
+            fi
+        fi
+
+        if command -v brew >/dev/null 2>&1; then
+            echo -e "   ${YELLOW}⚡ Auto-installing missing components (${MISSING_CORE[*]})...${NC}"
+            if ! command -v adb >/dev/null 2>&1; then
+                brew install --cask android-platform-tools >/dev/null 2>&1 || brew install android-platform-tools >/dev/null 2>&1 || true
+            fi
+            if ! command -v ffmpeg >/dev/null 2>&1; then
+                brew install ffmpeg >/dev/null 2>&1 || true
+            fi
+            if ! command -v scrcpy >/dev/null 2>&1; then
+                brew install scrcpy >/dev/null 2>&1 || true
+            fi
+        fi
+    elif [ "${OS_NAME}" = "Linux" ]; then
+        if command -v apt-get >/dev/null 2>&1; then
+            if [ "$(id -u)" -eq 0 ]; then
+                apt-get update -qq && apt-get install -y -qq "${MISSING_CORE[@]}" >/dev/null 2>&1 || true
+            elif command -v sudo >/dev/null 2>&1; then
+                sudo -n apt-get update -qq && sudo -n apt-get install -y -qq "${MISSING_CORE[@]}" >/dev/null 2>&1 || true
+            fi
+        fi
+    fi
+fi
+
+# 4. Check or initialize .env configuration file
+if [ ! -f ".env" ]; then
+    if [ -f ".env.example" ]; then
+        cp .env.example .env
+        echo -e "   ${GREEN}✓ Initialized .env configuration file.${NC}"
+    else
+        touch .env
+    fi
+fi
+
+# 5. Synchronize Python runtime & dependencies
+echo -e "   ${BLUE}📦 Synchronizing Python runtime and project dependencies...${NC}"
+uv sync --quiet
+
+# 6. Launch unified Showcase UI & auto-open browser
+echo -e "   ${GREEN}🚀 Launching Artemis Showcase UI & Admin Console...${NC}"
+exec uv run artemis ui --open "$@"