maestro-automation 1.0.0

Maestro — Automotive Test Automation Framework (web dashboard + adapters)

🏁 Maestro — Automotive Test Automation Framework

Maestro consolidates SSH, ADB, bench power control, ETFW, DLT logging, serial consoles and Windows camera capture into a single browser-based dashboard. Non-technical users design test cases with drag-and-drop; engineers extend it through a hot-reloadable plugin system.

🚀 Quick start

# Requirements: Python 3.10+ (3.11.9 recommended), Node.js 18+

cd maestro
pip install -r requirements.txt      # or: pip install poetry && poetry install
python app.py

app.py installs anything missing, builds the React frontend on first run, starts the FastAPI backend on http://localhost:8000 and opens your browser. That's it.

URL	What
http://localhost:8000	Maestro dashboard
http://localhost:8000/api/docs	Interactive API documentation (Swagger)
http://localhost:8000/metrics	Prometheus metrics

✨ Highlights

• 4-column drag-and-drop test designer with pre-built step templates for SSH, ADB, power, ignition, ETFW, DLT, camera and serial console
• Execution engine: serial / parallel / step-by-step modes, retry with exponential backoff, IF/THEN conditional jumps, loops, parallel groups, per-device resource locking, sandboxed user scripts
• Live monitoring over WebSocket: step status, logs, pause/resume/stop
• Allure-style HTML reports with timelines, artifacts and report diffing
• Scheduling via cron expressions (APScheduler)
• Enterprise security: AES-256-GCM credential vault, 5-role RBAC, full audit logging
• Observability: structured JSON logs, Prometheus metrics, adapter health
• Plugin system: manifest-based adapters, enable/disable, hot reload, custom plugins in data/plugins/

🧪 Development

# Backend tests
python -m pytest tests/

# Frontend dev server (proxies API to :8000)
cd frontend && npm install && npm run dev

# Frontend tests & build
npm run test && npm run build

🐳 Docker

docker compose -f docker/docker-compose.yml up --build

📚 Documentation

• USER_GUIDE.md — using the dashboard
• DEVELOPER_GUIDE.md — extending Maestro
• API_REFERENCE.md — REST/WebSocket API
• MAESTRO_COMPLETE_ARCHITECTURE.md — full architecture spec

📄 License

MIT — see LICENSE.