somew1nd
206a9ce921
ARTEMIS is an autonomous multimodal Android agent and mobile UI automation platform engineered for physical devices and emulators. It combines state-of-the-art multimodal Vision-Language Models (VLMs) with hierarchical closed-loop planning, resilient self-healing, and deep Android subsystem integration. Key Features & Architectural Highlights: - Dual-Engine Orchestration: * Pro Engine: Multi-agent closed-loop (Planner -> Operator -> Validator/Failure Analyzer -> Summarizer) powered by LangGraph. * Flash Engine: Ultra-fast reactive loop for deterministic, low-latency UI execution (<35 steps). - Multimodal Perception & Grounding: * Hybrid visual screenshot grounding, real-time OCR extraction, and XML accessibility hierarchy parsing. * Dynamic-First, Coordinate-Fallback locating strategy for maximum resilience against UI drift. - Autonomous Self-Healing & Diagnostics: * Failure analyzer and safety net for popup dismissal, crash recovery, and auto-retry. * Diagnostic sub-agents for log analysis, video recording inspection, and object detection. - Unified CLI & Python SDK: * Rich CLI with commands: init, doctor, run, trace, batch, bench, server, and mcp. * Fluent Python SDK with Pydantic structured output models and package locking. - Multi-Provider LLM Architecture: * Support for Google Gemini, OpenAI, Anthropic Claude, Vertex AI, OpenRouter, xAI Grok, and local endpoints (Ollama/vLLM). * Centralized configuration in config/artemis.jsonc. - Native MCP & Observability: * Model Context Protocol (MCP) server endpoints for AI IDEs. * Full trace recording with before/after screenshots, action overlays, and execution replays. Change-Id: I430b93ee2b76b54cc5a3c6eeccd15d2cf29830a1
π± Artemis Applications Ecosystem (apps/)
This directory houses the two primary applications and user interfaces of the Artemis ecosystem.
π Subsystems Overview
apps/
βββ π οΈ admin_console/ # [Interface 1] Full-fidelity Trace Inspector & Task Control Console (FastAPI + Web)
βββ β¨ showcase_ui/ # [Interface 2] Aesthetic User Presentation & Interaction Workspace (Angular 19)
π Detailed Comparison of the Two UIs
| Dimension | π οΈ Admin & Trace Console (admin_console) |
β¨ Showcase & Workspace UI (showcase_ui) |
|---|---|---|
| Primary Audience | Developers, Test Engineers, System Admins | End Users, Customers, Product Demo Audiences |
| UI Paradigm | High-density, full-fidelity tree logs, step-by-step inspector | Dynamic Aurora Glow, Glassmorphism, dual-pane stream |
| Core Capabilities | β’ Full hierarchical Call Tree & LLM thinking inspection β’ Pre/post action screenshots & visual overlay verification β’ Video playback & step replay engine ( /api/replay)β’ Queue tasks & live state toggle |
β’ Real-time Agent thought & action progress streaming β’ Interactive natural language chat sidebar β’ Aesthetic visual representation of mobile autonomy |
| Tech Stack | Python (FastAPI) + Vanilla Responsive Web | TypeScript, Angular 19, SCSS |
| Start Command | uv run uvicorn apps.admin_console.server:app --port 8000 --reload |
cd apps/showcase_ui && npm start (Port 4200) |