Relay01Gemini CLI install + sign-in
Install Gemini CLI, run `gemini`, and complete OAuth sign-in before doing anything else.
Voice Agent for Google Workspace
A voice agent for Google Workspace
Relay is an Electron desktop app for voice-driven Google Workspace workflows and local desktop actions. Gemini Live powers the conversation, Vertex AI handles reasoning, and Gemini CLI grounds execution on your machine.
Choose Your Build
Pick the installer for the machine where Relay will run.
Platform detection is only used to recommend a build. Both installers stay available so you can choose explicitly.
02Workspace ext. + consent
Install the Workspace extension, then complete its separate Google Workspace OAuth consent.
03Download Relay
With both prerequisites done, download Relay, open the macOS DMG or unzip the Windows package, and launch.
Judge Access
Judge setup in 3 steps
- 1
Gemini CLI — install, run
gemini, complete OAuth sign-in - 2
Workspace ext. — install and complete the separate Google Workspace OAuth consent
- 3
Download Relay — open the macOS disk image or unzip the Windows package, then launch and enter the passcode from the Devpost appendix
Choose the installer that matches the computer where you will run Relay.
Passcode in the Devpost appendix · Need early access? Email me
Quick Start Commands
Run these first
Install Gemini CLI, sign in, and install the Workspace extension before you download Relay.
npm install -g @google/gemini-cligeminigemini extensions install https://github.com/gemini-cli-extensions/workspaceAfter the extension installs, open Gemini CLI once and finish the Google Workspace OAuth consent when the extension prompts for access.
Watch Relay
See the hosted session before you install anything
This walkthrough opens at the live product segment so visitors can verify the end-to-end voice workflow, task handling, and grounded local execution handoff before setup.
Downloads
Choose your platform
Live GitHub Release assets for the current public build. If prerequisites are done, you are ready to launch.
Choose the installer that matches the computer where you will run Relay.
macOS
Apple Silicon + Intel
Universal DMG for Apple Silicon and Intel Macs. Open the disk image, then launch Relay from the mounted app.
Download for macOSOpen the downloaded package first. macOS ships as a DMG and Windows ships as a ZIP installer bundle. A standard OS security warning can still appear on first launch.
Windows
x64 installer
ZIP containing the Windows x64 installer. Unzip, then run the setup executable inside.
Download for WindowsOpen the downloaded package first. macOS ships as a DMG and Windows ships as a ZIP installer bundle. A standard OS security warning can still appear on first launch.
How It Works
The system boundary is clean.
The desktop app is the user-facing surface for Google Workspace and local desktop workflows. The hosted core owns live conversation and task state, while Gemini CLI on the device handles grounded local execution.
Phase 01
Desktop surface
An Electron + React desktop app for voice-driven Google Workspace workflows, playback, live transcript, and task visibility.
Phase 02
Hosted agent core
Cloud Run owns the Gemini Live session, orchestration, and canonical task state — not hidden inside the desktop shell.
Phase 03
Grounded local execution
Local desktop actions run through Gemini CLI on device, so execution stays grounded in real machine state instead of hallucinated output.
Phase 04
Persistent continuity
Gemini Live handles conversation, Vertex AI handles reasoning, and Cloud SQL keeps sessions, tasks, and artifacts durable.