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
This commit is contained in:
somew1nd committed
1 parent
78e478f502
commit
9a5aaf99b7
249 files changed
+37226
-9339
No files matched your search
Executable
+285
@@ -0,0 +1,285 @@
|
||||
#!/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
|
||||
|
||||
# Visual styling
|
||||
BOLD='\033[1m'
|
||||
GREEN='\033[0;32m'
|
||||
BLUE='\033[0;34m'
|
||||
YELLOW='\033[1;33m'
|
||||
RED='\033[0;31m'
|
||||
CYAN='\033[0;36m'
|
||||
DIM='\033[2m'
|
||||
NC='\033[0m'
|
||||
|
||||
AUTO_LAUNCH=false
|
||||
for arg in "$@"; do
|
||||
case "${arg}" in
|
||||
--launch|-l|--open)
|
||||
AUTO_LAUNCH=true
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
echo -e "${BOLD}${CYAN}======================================================${NC}"
|
||||
echo -e "${BOLD}${CYAN} π Artemis - Smart Multi-Platform Installer ${NC}"
|
||||
echo -e "${BOLD}${CYAN}======================================================${NC}"
|
||||
echo ""
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
|
||||
cd "${ROOT_DIR}"
|
||||
|
||||
# Normalize PATH with standard platform binary 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
|
||||
|
||||
OS_TYPE="$(uname -s)"
|
||||
ARCH_TYPE="$(uname -m)"
|
||||
|
||||
# Helper to check command availability
|
||||
has_cmd() {
|
||||
command -v "$1" >/dev/null 2>&1
|
||||
}
|
||||
|
||||
echo -e "${BOLD}1. Detecting Operating System & Environment...${NC}"
|
||||
echo -e " Platform: ${BLUE}${OS_TYPE}${NC} (${ARCH_TYPE})"
|
||||
echo -e " Root Dir: ${DIM}${ROOT_DIR}${NC}"
|
||||
|
||||
# Function to install system toolchains (ADB, FFmpeg, scrcpy)
|
||||
install_system_packages() {
|
||||
echo -e "\n${BOLD}2. Checking System Toolchains (ADB, FFmpeg, scrcpy)...${NC}"
|
||||
|
||||
local need_adb=false
|
||||
local need_ffmpeg=false
|
||||
local need_scrcpy=false
|
||||
|
||||
if ! has_cmd adb; then need_adb=true; fi
|
||||
if ! has_cmd ffmpeg; then need_ffmpeg=true; fi
|
||||
if ! has_cmd scrcpy; then need_scrcpy=true; fi
|
||||
|
||||
if [ "${need_adb}" = false ] && [ "${need_ffmpeg}" = false ] && [ "${need_scrcpy}" = false ]; then
|
||||
echo -e " ${GREEN}β All core system tools are already installed.${NC}"
|
||||
return 0
|
||||
fi
|
||||
|
||||
echo -e " ${YELLOW}! Missing toolchains detected:${NC}"
|
||||
[ "${need_adb}" = true ] && echo -e " β’ [ADB] Android Debug Bridge"
|
||||
[ "${need_ffmpeg}" = true ] && echo -e " β’ [FFmpeg] Video encoding/trimming framework"
|
||||
[ "${need_scrcpy}" = true ] && echo -e " β’ [scrcpy] Real-time Android screen mirroring"
|
||||
|
||||
echo -e " Attempting automated installation..."
|
||||
|
||||
if [ "${OS_TYPE}" = "Darwin" ]; then
|
||||
# Ensure Homebrew environment variables to prevent hanging
|
||||
export HOMEBREW_NO_AUTO_UPDATE=1
|
||||
export HOMEBREW_NO_INSTALL_CLEANUP=1
|
||||
export HOMEBREW_NO_ENV_HINTS=1
|
||||
|
||||
if ! has_cmd brew; 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 has_cmd brew; then
|
||||
echo -e " ${CYAN}Detected Homebrew ($(brew --version | head -n1)). Installing missing components...${NC}"
|
||||
if [ "${need_adb}" = true ]; then
|
||||
echo -e " π¦ Installing ${BOLD}android-platform-tools${NC}..."
|
||||
brew install --cask android-platform-tools || brew install android-platform-tools || true
|
||||
fi
|
||||
if [ "${need_ffmpeg}" = true ]; then
|
||||
echo -e " π¦ Installing ${BOLD}ffmpeg${NC}..."
|
||||
brew install ffmpeg || true
|
||||
fi
|
||||
if [ "${need_scrcpy}" = true ]; then
|
||||
echo -e " π¦ Installing ${BOLD}scrcpy${NC}..."
|
||||
brew install scrcpy || true
|
||||
fi
|
||||
else
|
||||
echo -e " ${YELLOW}β Homebrew not found. Please install Homebrew or install tools manually:${NC}"
|
||||
echo -e " /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
|
||||
echo -e " brew install --cask android-platform-tools && brew install ffmpeg scrcpy"
|
||||
fi
|
||||
|
||||
elif [ "${OS_TYPE}" = "Linux" ]; then
|
||||
SUDO_CMD=""
|
||||
if [ "$(id -u)" -ne 0 ]; then
|
||||
if has_cmd sudo; then
|
||||
SUDO_CMD="sudo"
|
||||
else
|
||||
echo -e " ${YELLOW}β Root/sudo privileges not detected. Please install system tools with your package manager.${NC}"
|
||||
fi
|
||||
fi
|
||||
|
||||
if has_cmd apt-get; then
|
||||
echo -e " ${CYAN}Detected Debian/Ubuntu (apt-get). Synchronizing and installing...${NC}"
|
||||
PKGS=()
|
||||
[ "${need_adb}" = true ] && PKGS+=("adb")
|
||||
[ "${need_ffmpeg}" = true ] && PKGS+=("ffmpeg")
|
||||
[ "${need_scrcpy}" = true ] && PKGS+=("scrcpy")
|
||||
PKGS+=("curl" "git")
|
||||
|
||||
if [ -n "${SUDO_CMD}" ] || [ "$(id -u)" -eq 0 ]; then
|
||||
${SUDO_CMD} apt-get update -qq || true
|
||||
${SUDO_CMD} apt-get install -y "${PKGS[@]}" || true
|
||||
fi
|
||||
elif has_cmd dnf; then
|
||||
echo -e " ${CYAN}Detected Fedora/RHEL (dnf). Installing packages...${NC}"
|
||||
PKGS=()
|
||||
[ "${need_adb}" = true ] && PKGS+=("android-tools")
|
||||
[ "${need_ffmpeg}" = true ] && PKGS+=("ffmpeg")
|
||||
[ "${need_scrcpy}" = true ] && PKGS+=("scrcpy")
|
||||
PKGS+=("curl" "git")
|
||||
|
||||
if [ -n "${SUDO_CMD}" ] || [ "$(id -u)" -eq 0 ]; then
|
||||
${SUDO_CMD} dnf install -y "${PKGS[@]}" || true
|
||||
fi
|
||||
elif has_cmd pacman; then
|
||||
echo -e " ${CYAN}Detected Arch Linux (pacman). Installing packages...${NC}"
|
||||
PKGS=()
|
||||
[ "${need_adb}" = true ] && PKGS+=("android-tools")
|
||||
[ "${need_ffmpeg}" = true ] && PKGS+=("ffmpeg")
|
||||
[ "${need_scrcpy}" = true ] && PKGS+=("scrcpy")
|
||||
PKGS+=("curl" "git")
|
||||
|
||||
if [ -n "${SUDO_CMD}" ] || [ "$(id -u)" -eq 0 ]; then
|
||||
${SUDO_CMD} pacman -S --noconfirm "${PKGS[@]}" || true
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
# Function to ensure uv is installed and ready
|
||||
ensure_uv() {
|
||||
echo -e "\n${BOLD}3. Checking Python Package Manager (uv)...${NC}"
|
||||
if ! has_cmd uv; then
|
||||
echo -e " ${YELLOW}uv not found. Installing Astral uv (ultra-fast Python package manager)...${NC}"
|
||||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||||
export PATH="${HOME}/.local/bin:${HOME}/.cargo/bin:${PATH}"
|
||||
fi
|
||||
|
||||
# Explicitly persist PATH to shell configuration files if not present
|
||||
local export_line='export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"'
|
||||
for rc in "${HOME}/.bashrc" "${HOME}/.zshrc" "${HOME}/.profile"; do
|
||||
if [ -f "${rc}" ]; then
|
||||
if ! grep -qs 'HOME/\.local/bin' "${rc}"; then
|
||||
echo -e "\n# Added by Artemis installer\n${export_line}" >> "${rc}"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
# If /usr/local/bin is writable or sudo is available, try to create a symlink to make it available immediately
|
||||
local uv_bin=""
|
||||
if [ -x "${HOME}/.local/bin/uv" ]; then
|
||||
uv_bin="${HOME}/.local/bin/uv"
|
||||
elif command -v uv >/dev/null 2>&1; then
|
||||
uv_bin="$(command -v uv)"
|
||||
fi
|
||||
|
||||
if [ -n "${uv_bin}" ]; then
|
||||
if [ -w "/usr/local/bin" ]; then
|
||||
ln -sf "${uv_bin}" /usr/local/bin/uv 2>/dev/null || true
|
||||
[ -x "${HOME}/.local/bin/uvx" ] && ln -sf "${HOME}/.local/bin/uvx" /usr/local/bin/uvx 2>/dev/null || true
|
||||
elif has_cmd sudo; then
|
||||
sudo -n ln -sf "${uv_bin}" /usr/local/bin/uv 2>/dev/null || true
|
||||
[ -x "${HOME}/.local/bin/uvx" ] && sudo -n ln -sf "${HOME}/.local/bin/uvx" /usr/local/bin/uvx 2>/dev/null || true
|
||||
fi
|
||||
fi
|
||||
|
||||
if has_cmd uv; then
|
||||
echo -e " ${GREEN}β uv is ready ($(uv --version))${NC}"
|
||||
else
|
||||
echo -e " ${RED}β Failed to find uv in PATH. Please add ~/.local/bin to your PATH.${NC}"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Function to setup Python runtime and sync dependencies
|
||||
setup_python_env() {
|
||||
echo -e "\n${BOLD}4. Configuring Python Runtime & Syncing Dependencies...${NC}"
|
||||
echo -e " ${BLUE}π¦ Running uv sync (auto-provisioning Python >=3.12 & dependencies)...${NC}"
|
||||
uv sync
|
||||
echo -e " ${GREEN}β Python runtime and dependencies synced successfully.${NC}"
|
||||
}
|
||||
|
||||
# Function to initialize .env configuration
|
||||
setup_env_file() {
|
||||
echo -e "\n${BOLD}5. Checking Environment Configuration (.env)...${NC}"
|
||||
if [ ! -f ".env" ]; then
|
||||
if [ -f ".env.example" ]; then
|
||||
cp .env.example .env
|
||||
echo -e " ${GREEN}β Created .env template from .env.example.${NC}"
|
||||
else
|
||||
touch .env
|
||||
echo -e " ${GREEN}β Created empty .env file.${NC}"
|
||||
fi
|
||||
else
|
||||
echo -e " ${GREEN}β .env configuration file exists.${NC}"
|
||||
fi
|
||||
}
|
||||
|
||||
# Function to display system readiness report
|
||||
verify_readiness() {
|
||||
echo -e "\n${BOLD}6. Toolchain Readiness Summary:${NC}"
|
||||
|
||||
local tools=("adb" "ffmpeg" "scrcpy" "uv" "python3")
|
||||
for t in "${tools[@]}"; do
|
||||
if has_cmd "$t"; then
|
||||
local loc
|
||||
loc="$(command -v "$t")"
|
||||
echo -e " ${GREEN}β ${t}${NC} -> ${DIM}${loc}${NC}"
|
||||
else
|
||||
echo -e " ${YELLOW}β ${t}${NC} -> ${YELLOW}Not found in PATH (Fallbacks active)${NC}"
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
||||
# Run setup workflow
|
||||
install_system_packages
|
||||
ensure_uv
|
||||
setup_python_env
|
||||
setup_env_file
|
||||
verify_readiness
|
||||
|
||||
echo -e "\n${BOLD}${CYAN}======================================================${NC}"
|
||||
echo -e "${BOLD}${GREEN} β¨ Artemis Environment Ready! ${NC}"
|
||||
echo -e "${BOLD}${CYAN}======================================================${NC}"
|
||||
|
||||
if [ "${AUTO_LAUNCH}" = true ]; then
|
||||
echo -e "\n${GREEN}π Auto-launching Showcase UI...${NC}"
|
||||
exec uv run artemis ui --open
|
||||
else
|
||||
echo -e "To launch the unified UI & live device onboarding:"
|
||||
echo -e " π ${BOLD}${CYAN}./start.sh${NC} (Recommended - automatically sets up environment)"
|
||||
echo -e " π ${BOLD}source ~/.bashrc && uv run artemis ui${NC} (or open a new terminal tab)"
|
||||
echo ""
|
||||
fi
|
||||
Reference in new issue
Block a user