ossrules.md

google_meet

Join a Google Meet call, transcribe live captions, optionally speak in realtime, and do the followup work afterwards. Use when the user asks the agent to sit in on a meeting, take notes, summarize, respond in-call, or action items from it.

  • meetings
  • google-meet
  • transcription
  • realtime-voice

Declared platforms: linux · macos

Install
npx skills add 'https://github.com/NousResearch/hermes-agent/tree/main/plugins/google_meet'
Download bundle ↓
main · 24fd22b ↗Scanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

cli.py

cli.pyBrowse 18 files
View on GitHub
3,063 tokens

12,599 bytes
Token encoding: o200k_base
Snapshot 24fd22b

← Back to SKILL.md
"""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 argparseimport contextlibimport importlib.utilimport jsonimport platformimport shutilimport subprocessimport sysfrom pathlib import Pathfrom typing import Optional from hermes_constants import get_hermes_home from plugins.google_meet import process_manager as pmfrom plugins.google_meet.meet_bot import _is_safe_meet_urlfrom plugins.google_meet.node.cli import node_command, register_cli as _register_node_clifrom 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 (pip deps, 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: pip install playwright"))    chromium_ok, chromium_msg = False, "unknown"    if pw_ok:        try:            from playwright.sync_api import sync_playwright            with sync_playwright() as p:                exe = p.chromium.executable_path            chromium_ok = bool(exe and Path(exe).exists())            chromium_msg = f"ok ({exe})" if chromium_ok else "not installed — run: python -m playwright install chromium"        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:    """pip deps + Chromium; ``--realtime`` adds the platform audio bridge deps.    Prompts before every package-manager invocation unless ``--yes``. Linux/macOS only."""    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)}")        # noqa: subprocess-stdin — sudo/brew may prompt on the tty; user explicitly confirmed above        if subprocess.run(cmd, check=False).returncode != 0:            print(fail_msg)     print("google_meet install\n-------------------")    pip_pkgs = ["playwright", "websockets"]    print(f"\n[1/3] pip install: {' '.join(pip_pkgs)}")    try:        from hermes_cli.tools_config import _pip_install        if _pip_install(["--upgrade", *pip_pkgs], capture_output=False).returncode != 0:            print("  pip install failed")            return 1    except Exception as e:        print(f"  pip install failed: {e}")        return 1    print("\n[2/3] python -m playwright install chromium")    try:        if subprocess.run([sys.executable, "-m", "playwright", "install", "chromium"], check=False,                          stdin=subprocess.DEVNULL).returncode != 0:            print("  playwright install failed (may already be installed)")    except Exception as e:        print(f"  playwright install failed: {e}")        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:\n"              "  pip install playwright && python -m playwright install chromium")        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(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()))
← All Hermes Agent skillsProject instructions →