Connect Google Gemini (UI)

This guide walks you through connecting Google Gemini to your Genie server using the dashboard UI. You can optionally supply your own Google Cloud Project ID to avoid free-tier rate limits.

---

Prerequisites

• A Genie account with a running server

• A Google account (personal or Google Workspace)

• (Recommended) A Google Cloud Platform project — required for Google Workspace or organization accounts

---

Step 1: Open LLM Integrations

Go to your Genie dashboard → Settings → Server. Scroll down to LLM Integrations and select the Gemini tab.

You will see the Gemini CLI setup with an optional Google Cloud Project ID field.

Server settings showing Gemini tab with Project ID field

---

Step 2: Get a Google Cloud Project ID

Supplying your own GCP Project avoids free-tier rate limits. This step is required for Google Workspace or organization accounts.

1. Go to console.cloud.google.com

2. Select an existing project or create a new one

3. Enable the Gemini for Google Cloud API:

   • Navigate to APIs & Services → Library

   • Search for "Gemini for Google Cloud"

   • Click Enable

4. Copy the Project ID from the dashboard

Google Cloud Console showing Project ID

---

Step 3: Enter Project ID

Back in Genie settings, paste your Project ID into the input field. Click Continue to sign in.

If you don't have a GCP Project ID, leave the field blank and click Skip & sign in instead.

Project ID entered in Genie settings

---

Step 4: Sign In with Google

A new tab opens to a Google sign-in dialog. Review the safety notice, confirm your account, and click Sign in to authorize access.

Google sign-in dialog for Gemini

---

Step 5: Copy the Callback URL

Your browser redirects to a localhost URL. This will show a connection error — this is expected on remote servers.

Copy the full URL from your browser's address bar.

Browser showing localhost connection error — copy the full URL

---

Step 6: Paste the URL in Genie

Go back to the Genie settings tab. Paste the callback URL into the input field and click Connect. If you entered a Project ID earlier, you will see a green confirmation showing it is set.

Paste callback URL and click Connect

---

Step 7: Connected

All steps show green checkmarks. You will see the message: "Gemini CLI connected — your server is ready!"

Successful Gemini connection with all green checkmarks

Your server is now using Google Gemini for AI interactions.

---

Tips

• Supplying a GCP Project ID avoids free-tier rate limits — highly recommended for serious use

• Google Workspace or organization accounts require a GCP Project ID

• The localhost connection error in Step 5 is expected — just copy the URL from the address bar

• To verify the connection, go to Chat and send a message to Genie

• You can switch between LLM providers (Claude, Codex, Gemini) from the same LLM Integrations panel