| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281 |
- """CLI commands for the google_meet plugin (``hermes meet <subcommand>``).
- setup / install — preflight and install prerequisites
- auth — open a browser to sign into Google, save storage state
- join <url> — join a Meet URL (locally or on a remote node)
- status / transcript / say / stop — drive the active bot
- node — remote node host management (see node/cli.py)
- """
- from __future__ import annotations
- import argparse
- import contextlib
- import importlib.util
- import json
- import platform
- import shutil
- import subprocess
- import sys
- from pathlib import Path
- from typing import Optional
- from hermes_cli.browser_runtime import chromium_executable
- from hermes_constants import get_hermes_home
- from plugins.google_meet import process_manager as pm
- from plugins.google_meet.meet_bot import _is_safe_meet_url
- from plugins.google_meet.node.cli import node_command, register_cli as _register_node_cli
- from plugins.google_meet.tools import resolve_node
- def _auth_state_path() -> Path:
- return Path(get_hermes_home()) / "workspace" / "meetings" / "auth.json"
- # ``hermes meet <sub>`` in help order.
- _SUBCOMMAND_HELP = (
- ("setup", "Preflight: playwright, chromium, auth"),
- ("install", "Install prerequisites (Python dependencies, Chromium, platform audio tools)"),
- ("auth", "Sign in to Google and save session state"),
- ("join", "Join a Meet URL"),
- ("status", "Print current Meet bot state"),
- ("transcript", "Print the scraped transcript"),
- ("say", "Speak text in an active realtime meeting"),
- ("stop", "Leave the current meeting"),
- ("node", "Manage remote meet node hosts (run/list/approve/remove/status/ping)"))
- def register_cli(subparser: argparse.ArgumentParser) -> None:
- """Build the ``hermes meet`` argparse tree (called at plugin load time)."""
- subs = subparser.add_subparsers(dest="meet_command")
- p = {name: subs.add_parser(name, help=help_) for name, help_ in _SUBCOMMAND_HELP}
- p["install"].add_argument("--realtime", action="store_true",
- help="Also install realtime audio tools (pulseaudio-utils on Linux, BlackHole+ffmpeg on macOS). Uses sudo/brew, prompts before invoking either.")
- p["install"].add_argument("--yes", "-y", action="store_true",
- help="Answer yes to all prompts (use with care; will run sudo apt-get or brew without asking).")
- p["join"].add_argument("url", help="https://meet.google.com/...")
- p["join"].add_argument("--guest-name", default="Hermes Agent")
- p["join"].add_argument("--duration", default=None, help="e.g. 30m, 2h, 90s")
- p["join"].add_argument("--headed", action="store_true", help="show browser")
- p["join"].add_argument("--mode", choices=("transcribe", "realtime"), default="transcribe",
- help="transcribe (default, listen-only) or realtime (speak via OpenAI Realtime)")
- p["join"].add_argument("--node", default=None,
- help="remote node name, or 'auto' to use the sole registered node")
- p["transcript"].add_argument("--last", type=int, default=None)
- p["say"].add_argument("text", help="what to say")
- p["say"].add_argument("--node", default=None)
- _register_node_cli(p["node"])
- subparser.set_defaults(func=meet_command)
- _DISPATCH = {
- "setup": lambda a: _cmd_setup(),
- "install": lambda a: _cmd_install(realtime=bool(a.realtime), assume_yes=bool(a.yes)),
- "auth": lambda a: _cmd_auth(),
- "join": lambda a: _cmd_join(url=a.url, guest_name=a.guest_name, duration=a.duration, headed=a.headed,
- mode=a.mode, node=a.node),
- "status": lambda a: _print_result(pm.status()),
- "transcript": lambda a: _cmd_transcript(last=a.last),
- "say": lambda a: _cmd_say(text=a.text, node=a.node),
- "stop": lambda a: _print_result(pm.stop(reason="hermes meet stop")),
- "node": node_command} # node subparsers are required=True, so a sub-command is always present
- def meet_command(args: argparse.Namespace) -> int:
- sub = args.meet_command
- if not sub:
- print("usage: hermes meet {setup,auth,join,status,transcript,say,stop,node}")
- return 2
- handler = _DISPATCH.get(sub)
- if handler is None:
- print(f"unknown subcommand: {sub}")
- return 2
- return handler(args)
- def _cmd_setup() -> int:
- print("google_meet preflight\n---------------------")
- system = platform.system()
- system_ok = system in {"Linux", "Darwin"}
- print(f" platform : {system} [{'ok' if system_ok else 'unsupported'}]")
- pw_ok = importlib.util.find_spec("playwright") is not None
- print(" playwright : " + ("installed" if pw_ok else "NOT installed — run: hermes meet install"))
- chromium_ok, chromium_msg = False, "unknown"
- if pw_ok:
- try:
- from playwright.sync_api import sync_playwright
- with sync_playwright() as p:
- exe = chromium_executable() or p.chromium.executable_path
- chromium_ok = bool(exe and Path(exe).exists())
- chromium_msg = f"ok ({exe})" if chromium_ok else "not installed — run: hermes meet install"
- except Exception as e:
- chromium_msg = f"probe failed: {e}"
- print(f" chromium : {chromium_msg}")
- auth_path = _auth_state_path()
- print(" google auth : " + (f"ok ({auth_path})" if auth_path.is_file() else "not saved — run: hermes meet auth"))
- print()
- all_ok = system_ok and pw_ok and chromium_ok
- print("ready. Join a meeting: hermes meet join https://meet.google.com/abc-defg-hij" if all_ok
- else "not ready yet — fix the items above.")
- return 0 if all_ok else 1
- def _cmd_install(*, realtime: bool, assume_yes: bool) -> int:
- """PM dependencies + Chromium; ``--realtime`` adds platform audio tools.
- Prompts before system package-manager invocations unless ``--yes``."""
- system = platform.system()
- if system not in {"Linux", "Darwin"}:
- print(f"google_meet install: {system} is not supported (linux/macos only)")
- return 1
- def _install_pkgs(prompt: str, cmd: list[str], fail_msg: str) -> None:
- """Confirm (unless --yes) then run a package-manager command, reporting failure."""
- try:
- ok = assume_yes or input(f"{prompt} [y/N] ").strip().lower() in {"y", "yes"}
- except EOFError:
- ok = False
- if not ok:
- print(" skipped (you can run it manually later)")
- return
- print(f" $ {' '.join(cmd)}")
- # sudo/brew may prompt on the tty; the user explicitly confirmed above.
- if subprocess.run(cmd, check=False, stdin=None).returncode != 0:
- print(fail_msg)
- print("google_meet install\n-------------------")
- print("\n[1/3] Python dependencies (google-meet extra)")
- try:
- import pm as package_manager
- package_manager.sync_venv(["google-meet"], explicit=True)
- except Exception as exc:
- print(f" dependency install failed: {exc}")
- return 1
- print("\n[2/3] PM-managed Chromium")
- try:
- package_manager.ensure("chromium", explicit=True)
- except Exception as exc:
- print(f" Chromium install failed: {exc}")
- return 1
- if not realtime:
- print("\n[3/3] skipped (pass --realtime to install audio tooling too)")
- else:
- print("\n[3/3] realtime audio deps")
- if system == "Linux":
- if shutil.which("paplay") and shutil.which("pactl"):
- print(" pulseaudio-utils already installed.")
- else:
- _install_pkgs(" install pulseaudio-utils? this runs `sudo apt-get install -y pulseaudio-utils`",
- ["sudo", "apt-get", "install", "-y", "pulseaudio-utils"],
- " apt install failed — install pulseaudio-utils manually")
- elif system == "Darwin":
- try:
- have_bh = "BlackHole" in subprocess.check_output(
- ["system_profiler", "SPAudioDataType"], text=True, encoding='utf-8', errors='replace',
- stdin=subprocess.DEVNULL)
- except Exception:
- have_bh = False
- needs = [pkg for pkg, have in (("blackhole-2ch", have_bh), ("ffmpeg", shutil.which("ffmpeg"))) if not have]
- if not needs:
- print(" BlackHole and ffmpeg already installed.")
- elif not shutil.which("brew"):
- print(" missing: " + ", ".join(needs) + "\n"
- " install Homebrew first (https://brew.sh) or install the packages manually.")
- else:
- _install_pkgs(f" install via brew: {' '.join(needs)}?", ["brew", "install", *needs],
- " brew install failed — install them manually")
- print("\n NOTE: macOS does not auto-route audio. Open\n System Settings → Sound → "
- "Input\n and select 'BlackHole 2ch' before starting a realtime meeting.\n "
- "hermes will not switch your default input for you.")
- print("\ndone. verify with: hermes meet setup")
- return 0
- def _cmd_auth() -> int:
- """Open a headed Chromium, let the user sign in, save storage_state."""
- try:
- from playwright.sync_api import sync_playwright
- except ImportError:
- print("playwright is not installed. Run: hermes meet install")
- return 1
- path = _auth_state_path()
- path.parent.mkdir(parents=True, exist_ok=True)
- print("opening Chromium — sign in to Google, then return here and press Enter.\n"
- f"saving storage state to: {path}")
- try:
- with sync_playwright() as pw:
- browser = pw.chromium.launch(
- channel="chromium", executable_path=chromium_executable(), headless=False,
- )
- context = browser.new_context()
- context.new_page().goto("https://accounts.google.com/", wait_until="domcontentloaded")
- with contextlib.suppress(EOFError):
- input("press Enter after you've signed in ... ")
- context.storage_state(path=str(path))
- browser.close()
- except Exception as e:
- print(f"auth failed: {e}")
- return 1
- print("saved. you can now run: hermes meet join <url>")
- return 0
- def _print_result(res: dict) -> int:
- print(json.dumps(res, indent=2))
- return 0 if res.get("ok") else 1
- def _remote(node: str, op: str, call) -> int:
- """Run *call(client)* against the registered node *node* and print the result."""
- try:
- client, name = resolve_node(node)
- except ImportError as e:
- print(f"node module unavailable: {e}")
- return 1
- if client is None:
- print(f"no registered node matches {node!r}")
- return 1
- try:
- res = call(client)
- except Exception as e:
- print(f"remote {op} failed: {e}")
- return 1
- return _print_result({"node": name, **res})
- def _cmd_join(url: str, *, guest_name: str, duration: Optional[str], headed: bool,
- mode: str = "transcribe", node: Optional[str] = None) -> int:
- if not _is_safe_meet_url(url):
- print(f"refusing: not a meet.google.com URL: {url}")
- return 2
- if node:
- return _remote(node, "start_bot", lambda c: c.start_bot(
- url=url, guest_name=guest_name, duration=duration, headed=headed, mode=mode))
- auth = _auth_state_path()
- return _print_result(pm.start(url=url, headed=headed, guest_name=guest_name, duration=duration,
- auth_state=str(auth) if auth.is_file() else None, mode=mode))
- def _cmd_say(text: str, node: Optional[str] = None) -> int:
- if not (text or "").strip():
- print("refusing: empty text")
- return 2
- if node:
- return _remote(node, "say", lambda c: c.say(text))
- return _print_result(pm.enqueue_say(text))
- def _cmd_transcript(last: Optional[int]) -> int:
- res = pm.transcript(last=last)
- if not res.get("ok"):
- return _print_result(res)
- for ln in res.get("lines", []):
- print(ln)
- return 0
- if __name__ == "__main__": # pragma: no cover
- parser = argparse.ArgumentParser(prog="hermes meet")
- register_cli(parser)
- sys.exit(meet_command(parser.parse_args()))
|