Skip to content
This repository was archived by the owner on Feb 8, 2026. It is now read-only.

dortanes/gemini-desktop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– Gemini AI Desktop

Desktop application for Google's Gemini AI

License: MIT GitHub release Downloads


Transform your Gemini AI experience with a desktop application that brings Google's powerful AI assistant directly to your desktop with enhanced features and seamless integration.

⚠️ Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Google LLC or the Gemini AI team. This is an independent, open-source desktop application that provides a wrapper interface for accessing Google's Gemini AI service through their official website.

  • Gemini AI is a trademark of Google LLC
  • This application simply loads the official Gemini website (gemini.google.com) in a desktop wrapper
  • All AI functionality is provided by Google's servers
  • No data is collected or stored by this application
  • Users must comply with Google's Terms of Service when using Gemini AI

✨ Features

  • πŸ–₯️ Native Desktop Experience - Full-featured Electron app with native OS integration
  • πŸ”„ Dual Window Modes - Switch between full window and drawer
  • ⌨️ Global Hotkeys - Customizable keyboard shortcuts for instant access
  • 🎨 System Tray Integration - Quick access from your system tray
  • 🎀 Voice Mode - Hands-free voice interaction with automatic speech-to-text and text-to-speech

πŸ“₯ Installation

πŸ“¦ Pre-built Releases (Recommended)

Download the latest release for your platform:

Platform Download Notes
πŸͺŸ Windows Download .exe NSIS installer with auto-updater
🍎 macOS 🚧 Coming Soon Universal binary (Intel + Apple Silicon)
🐧 Linux 🚧 Coming Soon AppImage, .deb, and .rpm packages

Note: Currently, only Windows builds are available. macOS and Linux builds are coming soon! πŸš€

πŸ”§ Installation Instructions

Windows

  1. Download the installer
  2. Run the installer
  3. Follow the setup wizard
  4. Launch from Start Menu or Desktop shortcut

macOS & Linux

These platforms are currently under development. You can still run the app from source code (see Development section below) or wait for the official releases coming soon!

πŸš€ Quick Start

  1. Launch the Application

    • Use your desktop shortcut or application menu
    • Or use the system tray icon for quick access
  2. Set Up Hotkeys (Optional)

    • Open Settings from the tray menu
    • Configure global hotkeys for drawer and main window
    • Customize voice mode hotkey (default: Ctrl+Shift+V)
    • Save your preferences
  3. Start Using Gemini AI

    • The app loads Google's Gemini official website (gemini.google.com)
    • Use drawer for quick queries
    • Switch to full mode for extended conversations
    • You can also open it in full screen mode (click F11)
  4. Voice Mode 🎀

    • Press your voice mode hotkey (default: Ctrl+Shift+V) to activate hands-free mode
    • Speak your question - the app will automatically detect when you're done
    • Your speech will be converted to text and sent to Gemini
    • The response will be read aloud using text-to-speech
    • Perfect for hands-free interaction while working on other tasks

🎀 Voice Mode

The Voice Mode feature provides a completely hands-free way to interact with Gemini AI using speech-to-text and text-to-speech capabilities.

FYI: This feature uses Gemini's original built-in speech-to-text (STT) and text-to-speech (TTS) functionality - no additional services or APIs required!

How It Works

  1. Activation: Press the voice mode hotkey (default: Ctrl+Shift+V)
  2. Voice Recording: The app automatically starts recording your voice
  3. Smart Detection: Automatically detects when you've finished speaking (2-second pause)
  4. Auto-Send: Converts your speech to text and sends it to Gemini
  5. Audio Response: Gemini's response is automatically read aloud using text-to-speech

πŸ› οΈ Development

πŸ“‹ Prerequisites

πŸ”§ Setup

# Clone the repository
git clone https://github.com/dortanes/gemini-desktop.git
cd gemini-desktop

# Install dependencies
yarn install

# Start development server
yarn start

πŸ—οΈ Building

# Build for Windows specifically
yarn build-win

# Build for development testing
yarn dist

Note: macOS and Linux build scripts are temporarily disabled but will be re-enabled soon. For now, focus is on Windows builds for better testing and stability.

πŸ§ͺ Testing

# Run in development mode
yarn start

# Build and test locally
yarn dist

βš™οΈ Configuration

πŸŽ›οΈ Application Settings

The app stores settings in your system's user data directory:

  • Windows: %APPDATA%/gemini-desktop/
  • macOS: ~/Library/Application Support/gemini-desktop/
  • Linux: ~/.config/gemini-desktop/

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❀️ by dortanes

⭐ Star this repo if you find it useful! ⭐