README blurb (put at the top of your repo) AV-Wizard — AV AI Ops Orchestration Pilot (Open Source)
Unify events, rooms, and support into one workflow. AV-Wizard is a static HTML/JS app that lets AV teams orchestrate Zoom, ServiceNow, Slack, GitHub, and Google Drive with MCP agents—no installs, no build, and no secrets in the browser. Run in mock mode for instant demos, or connect local MCP tool servers for real actions. The app proves how Intake → Plan → Act → Verify plus recipes and guardrails turns point tools into repeatable outcomes.
Why this matters
Orchestration > point tools: coordinate multiple systems with agents instead of 6 admin consoles.
Outcomes you can show: readiness ↑, MTTR ↓, failed starts ↓, auto-resolves ↑, and a simple Value Realized estimate.
Cost-efficient AI: a large-model orchestrator plans/validates while small connector agents do the work—faster and cheaper.
What’s inside
Wizard: guide setup, pick mock vs real, enable agents, set optimization focus.
Agents (hover for roles): Events, Support-Requests, Incidents, Projects, Recipe-Library, Baseline-Dashboards, Incident→Outcome Mapper, KB-Recipe Scout (web-search vendor docs → ServiceNow KB + Recipe → Slack notify).
Dashboard: agent health (p95/error), Event Readiness %, MTTR trend, Failed Starts/100, Auto-Resolves/week, top rooms by incidents, upcoming preflight checks, Architecture & Workflow swimlane, and logs.
Recipes & Guardrails: YAML recipes validated by schema with promotion/rollback rules.
Security by design: secrets only live in your local MCP servers; the browser uses http://localhost APIs with CORS.
Quickstart
Download or clone the repo.
Open apps/av-wizard/index.html in your browser (double-click).
In mock mode, explore agents and the Dashboard with simulated telemetry.
Optionally run your local MCP tool servers (Zoom/Slack/ServiceNow/GDrive/GitHub) and switch to real mode in the Wizard.
Keep tokens/keys in .env files for those servers; never in the browser.
What you’ll learn
How to standardize AV flows into Intake → Plan → Act → Verify.
How agents triage, self-heal, provision, and document—with audit trails.
How to turn “tribal fixes” into recipes you can promote safely.
How to measure and communicate operational outcomes (not just tickets).
Zip file Location By default, the script will create the files in the directory the script is in. You can change the destination by setting an env var:
Windows (PowerShell): setx AV_AI_OPS_OUTDIR "C:\work\av-ai-ops-out" (then restart your shell), or $env:AV_AI_OPS_OUTDIR = "C:\work\av-ai-ops-out"; python merge_av_ai_ops_repo.py
macOS/Linux: AV_AI_OPS_OUTDIR=/tmp/av-ai-ops-out python merge_av_ai_ops_repo.py