https://github.com/dortanes/gemini-desktop
Desktop application for Gemini AI. Based on Electron
https://github.com/dortanes/gemini-desktop
ai desktop-app electron gemini gemini-ai
Last synced: 11 months ago
JSON representation
Desktop application for Gemini AI. Based on Electron
- Host: GitHub
- URL: https://github.com/dortanes/gemini-desktop
- Owner: dortanes
- License: mit
- Created: 2025-07-19T17:16:28.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-20T03:38:00.000Z (11 months ago)
- Last Synced: 2025-07-20T05:43:31.692Z (11 months ago)
- Topics: ai, desktop-app, electron, gemini, gemini-ai
- Language: JavaScript
- Homepage: https://github.com/dortanes/gemini-desktop/releases/latest
- Size: 95.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 Gemini AI Desktop
**Desktop application for Google's Gemini AI**
[](https://opensource.org/licenses/MIT) [](https://github.com/dortanes/gemini-desktop/releases) [](https://github.com/dortanes/gemini-desktop/releases)
---
*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](https://github.com/dortanes/gemini-desktop/releases/latest) | 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](#-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
- **Node.js** 20+ ([Download](https://nodejs.org/))
- **yarn**
- **Git**
### 🔧 Setup
```bash
# 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
```bash
# 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
```bash
# 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](LICENSE) file for details.
---
**Made with ❤️ by [dortanes](https://github.com/dortanes)**
⭐ **Star this repo if you find it useful!** ⭐