{"id":29618755,"url":"https://github.com/dortanes/gemini-desktop","last_synced_at":"2025-07-21T03:01:35.774Z","repository":{"id":305434852,"uuid":"1022719395","full_name":"dortanes/gemini-desktop","owner":"dortanes","description":"Desktop application for Gemini AI. Based on Electron","archived":false,"fork":false,"pushed_at":"2025-07-20T03:38:00.000Z","size":98,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-20T05:43:31.692Z","etag":null,"topics":["ai","desktop-app","electron","gemini","gemini-ai"],"latest_commit_sha":null,"homepage":"https://github.com/dortanes/gemini-desktop/releases/latest","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dortanes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-19T17:16:28.000Z","updated_at":"2025-07-20T03:38:05.000Z","dependencies_parsed_at":"2025-07-20T05:53:45.088Z","dependency_job_id":null,"html_url":"https://github.com/dortanes/gemini-desktop","commit_stats":null,"previous_names":["dortanes/gemini-desktop"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/dortanes/gemini-desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dortanes%2Fgemini-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dortanes%2Fgemini-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dortanes%2Fgemini-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dortanes%2Fgemini-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dortanes","download_url":"https://codeload.github.com/dortanes/gemini-desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dortanes%2Fgemini-desktop/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266231759,"owners_count":23896471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","desktop-app","electron","gemini","gemini-ai"],"created_at":"2025-07-21T03:00:23.358Z","updated_at":"2025-07-21T03:01:35.752Z","avatar_url":"https://github.com/dortanes.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🤖 Gemini AI Desktop\n\n**Desktop application for Google's Gemini AI**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![GitHub release](https://img.shields.io/github/release/dortanes/gemini-desktop.svg)](https://github.com/dortanes/gemini-desktop/releases) [![Downloads](https://img.shields.io/github/downloads/dortanes/gemini-desktop/total.svg)](https://github.com/dortanes/gemini-desktop/releases)\n\n---\n\n*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.*\n\n\u003c/div\u003e\n\n## ⚠️ Disclaimer\n\n**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. \n\n- **Gemini AI** is a trademark of Google LLC\n- This application simply loads the official Gemini website (gemini.google.com) in a desktop wrapper\n- All AI functionality is provided by Google's servers\n- No data is collected or stored by this application\n- Users must comply with Google's Terms of Service when using Gemini AI\n\n## ✨ Features\n\n- **🖥️ Native Desktop Experience** - Full-featured Electron app with native OS integration\n- **🔄 Dual Window Modes** - Switch between full window and drawer\n- **⌨️ Global Hotkeys** - Customizable keyboard shortcuts for instant access\n- **🎨 System Tray Integration** - Quick access from your system tray\n- **🎤 Voice Mode** - Hands-free voice interaction with automatic speech-to-text and text-to-speech\n\n## 📥 Installation\n\n### 📦 Pre-built Releases (Recommended)\n\nDownload the latest release for your platform:\n\n| Platform | Download | Notes |\n|----------|----------|-------|\n| 🪟 **Windows** | [Download .exe](https://github.com/dortanes/gemini-desktop/releases/latest) | NSIS installer with auto-updater |\n| 🍎 **macOS** | 🚧 Coming Soon | Universal binary (Intel + Apple Silicon) |\n| 🐧 **Linux** | 🚧 Coming Soon | AppImage, .deb, and .rpm packages |\n\n\u003e **Note:** Currently, only Windows builds are available. macOS and Linux builds are coming soon! 🚀\n\n### 🔧 Installation Instructions\n\n#### Windows\n1. Download the installer\n2. Run the installer\n3. Follow the setup wizard\n4. Launch from Start Menu or Desktop shortcut\n\n#### macOS \u0026 Linux\nThese 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!\n\n## 🚀 Quick Start\n\n1. **Launch the Application**\n   - Use your desktop shortcut or application menu\n   - Or use the system tray icon for quick access\n\n2. **Set Up Hotkeys** (Optional)\n   - Open Settings from the tray menu\n   - Configure global hotkeys for drawer and main window\n   - Customize voice mode hotkey (default: `Ctrl+Shift+V`)\n   - Save your preferences\n\n3. **Start Using Gemini AI**\n   - The app loads Google's Gemini official website (gemini.google.com)\n   - Use drawer for quick queries\n   - Switch to full mode for extended conversations\n   - You can also open it in full screen mode (click F11)\n\n4. **Voice Mode** 🎤\n   - Press your voice mode hotkey (default: `Ctrl+Shift+V`) to activate hands-free mode\n   - Speak your question - the app will automatically detect when you're done\n   - Your speech will be converted to text and sent to Gemini\n   - The response will be read aloud using text-to-speech\n   - Perfect for hands-free interaction while working on other tasks\n\n## 🎤 Voice Mode\n\nThe Voice Mode feature provides a completely hands-free way to interact with Gemini AI using speech-to-text and text-to-speech capabilities.\n\n\u003e **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!\n\n### How It Works\n\n1. **Activation**: Press the voice mode hotkey (default: `Ctrl+Shift+V`)\n2. **Voice Recording**: The app automatically starts recording your voice\n3. **Smart Detection**: Automatically detects when you've finished speaking (2-second pause)\n4. **Auto-Send**: Converts your speech to text and sends it to Gemini\n5. **Audio Response**: Gemini's response is automatically read aloud using text-to-speech\n\n## 🛠️ Development\n\n### 📋 Prerequisites\n\n- **Node.js** 20+ ([Download](https://nodejs.org/))\n- **yarn**\n- **Git**\n\n### 🔧 Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/dortanes/gemini-desktop.git\ncd gemini-desktop\n\n# Install dependencies\nyarn install\n\n# Start development server\nyarn start\n```\n\n### 🏗️ Building\n\n```bash\n# Build for Windows specifically\nyarn build-win\n\n# Build for development testing\nyarn dist\n```\n\n\u003e **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.\n\n### 🧪 Testing\n\n```bash\n# Run in development mode\nyarn start\n\n# Build and test locally\nyarn dist\n```\n\n## ⚙️ Configuration\n\n### 🎛️ Application Settings\n\nThe app stores settings in your system's user data directory:\n- **Windows**: `%APPDATA%/gemini-desktop/`\n- **macOS**: `~/Library/Application Support/gemini-desktop/`\n- **Linux**: `~/.config/gemini-desktop/`\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [dortanes](https://github.com/dortanes)**\n\n⭐ **Star this repo if you find it useful!** ⭐\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdortanes%2Fgemini-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdortanes%2Fgemini-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdortanes%2Fgemini-desktop/lists"}