For Judges

Install Gemini CLI and finish its OAuth sign-in, install the Workspace extension, then complete the separate Google Workspace OAuth consent for the extension when it first asks for Docs, Drive, or Gmail access. Only after both authenticated prerequisites are ready should you open Relay and enter the judge passcode from the Devpost appendix to access the hosted session.

Public Access

Relay is currently opened for judges first. If you want early access before the wider release, contact main220704@gmail.com.

Voice Agent for the Google Ecosystem

Install tools, download Relay, and start talking.

Relay is an Electron desktop app backed by a hosted Cloud Run core. Gemini Live powers the conversation, Vertex AI handles reasoning, and Gemini CLI grounds local execution on your machine.

01Gemini CLI install + sign-in

Install Gemini CLI, launch `gemini`, and complete the Gemini CLI OAuth sign-in first. Relay cannot use grounded local execution if the CLI is installed but not authenticated.

02Workspace ext. install + consent

Install the Workspace extension, then complete its separate Google Workspace OAuth consent when Gemini CLI first prompts for Docs, Drive, or Gmail access. Relay needs the extension to be both installed and authorized.

03Download Relay

After Gemini CLI sign-in and Workspace extension consent are both complete, download the ZIP for your OS, unzip it, and launch Relay.

Quick Start

Ready your setup

This is the shortest path to a working Relay setup. Install Gemini CLI and complete its sign-in, install the Workspace extension, then finish the extension Google Workspace OAuth consent before you download Relay.

Required Core

Gemini CLIWorkspace Ext.

Gemini CLI sign-in and Workspace extension consent are separate checks. Package installation alone is not enough.

1. Install Gemini CLI
npm install -g @google/gemini-cli
2. Start and sign in
gemini
3. Install extension
gemini extensions install https://github.com/gemini-cli-extensions/workspace

Before launching Relay, open Gemini CLI once after the extension install and finish the separate Google Workspace OAuth consent flow when the extension asks for access.

Authentication required

Gemini CLI sign-in and Workspace extension Google Workspace consent must both be completed before Relay can use grounded local execution.

What you download

Platform links point to Release ZIPs. Unzip first, then open it.

Downloads

Choose your platform

These are the live GitHub Release assets for the current public build. If you have already configured the prerequisites, you are ready.

💻

macOS ZIP

ZIP download for Apple Silicon and Intel Macs. Unzip it, then open the packaged macOS build inside.

Download for macOSUnzip first. Unsigned builds may still trigger a standard OS warning before the first launch.
💻

Windows ZIP

ZIP download containing the Windows x64 installer. Unzip it, then run the setup executable inside.

Download for WindowsUnzip first. Unsigned builds may still trigger a standard OS warning before the first launch.

How It Works

The system boundary is clean.

The desktop app is the user-facing surface. The hosted core owns live conversation and task truth. Gemini CLI on the device handles grounded local execution.

Phase 01

Desktop surface

Relay is an Electron and React desktop app built for realtime voice input, playback, transcript, and task visibility.

Phase 02

Hosted agent core

Cloud Run owns the Gemini Live session, orchestration, and canonical task state instead of hiding product logic inside the desktop shell.

Phase 03

Grounded local execution

When work must happen on your machine, Relay delegates it through Gemini CLI on device so the result is grounded in real local state.

Phase 04

Persistent continuity

Gemini Live handles the conversation, Vertex AI handles reasoning, and Cloud SQL keeps sessions, tasks, and artifacts durable.