Skip to content

Native desktop client for Google Gemini on Windows, macOS, and Linux. Features global hotkeys, Spotlight-style Quick Chat, and zero data collection.

License

Notifications You must be signed in to change notification settings

bwendell/gemini-desktop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

213 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Gemini Desktop β€” Native, Private AI Experience

GitHub release GitHub last commit Platform OpenSSF Scorecard CodeQL

Gemini, but better. The privacy-first, native desktop client for Google Gemini. Experience the best free AI desktop app for Windows, macOS, and Linux. Features global hotkeys, Spotlight-style Quick Chat, and zero data collection.

Installation β€’ Quick Chat β€’ Shortcuts β€’ Privacy β€’ Contributing


✨ Why This App?

πŸ›‘οΈ Safety Guarantee

Start here: Read our Transparency Report which includes a direct comparison to the "GeminiDesk" malware and explains exactly how we protect your data. We verify every release with checksums and strictly limit network traffic to google.com.

Users have been asking for a desktop Gemini client with these featuresβ€”we deliver on all of them:

What Users Want Status
πŸ–₯️ Native desktop app (not just a browser tab) βœ… Native & Fast
⌨️ Global keyboard shortcuts βœ… Fully Customizable
πŸš€ Spotlight-style Quick Chat βœ… Instant Access
πŸ“Œ Always-on-top window βœ… Easy Access to Gemini
πŸ•΅οΈ Quick Privacy / Hiding βœ… Stealth Mode
πŸ’» Cross-platform (Windows, macOS, Linux) βœ… All three
πŸ” Stable login & persistent sessions βœ… OAuth done right
πŸ”’ No data collection βœ… Zero telemetry
πŸ–¨οΈ Print to PDF βœ… Export Chats
πŸ”” Desktop Notifications βœ… Notify on Reply

πŸš€ Quick Chat - Spotlight for Gemini

Like macOS Spotlight, but for AI. Press Ctrl+Shift+Space (or Cmd+Shift+Space on Mac) from anywhereβ€”writing code, browsing, reading docsβ€”and a floating command center appears instantly.

Gemini Desktop Quick Chat Interface

What makes it powerful:

  • 🌟 Spotlight-Style Access β€” Global hotkey summons Gemini over any app, just like Cmd+Space on Mac
  • πŸ’¬ Floating Window β€” Centered, always-on-top dialog that doesn't disrupt your workflow
  • ⚑ Zero Friction β€” Auto-focuses on input, submit your query, then it vanishesβ€”results appear in your main Gemini chat
  • ⌨️ Keyboard-First β€” Type, submit with Enter, dismiss with Escape. No context switching required
  • 🎯 Smart Positioning β€” Appears on your active screen, keeps you in the flow

πŸ•΅οΈ Stealth Mode

Need to vanish? Press Ctrl+Alt+H (or Cmd+Alt+H) to instantly minimize the app to the system tray. Out of sight, out of mind, until you need it again.

πŸ“Œ Always On Top

Keep Gemini visible while you work. Toggle "Always On Top" mode with Ctrl+Shift+T (or Cmd+Shift+T) so you can reference chats without switching windows.


πŸ“₯ Installation

Windows

Download the latest .exe installer from Releases.

Gemini Desktop-x.x.x-x64-installer.exe

macOS

Download the .dmg for your architecture from Releases:

  • Apple Silicon (M1/M2/M3): Gemini Desktop-x.x.x-arm64.dmg
  • Intel: Gemini Desktop-x.x.x-x64.dmg

Linux

Download the .AppImage or .deb from Releases.

# AppImage
chmod +x "Gemini Desktop-x.x.x-x64.AppImage"
./"Gemini Desktop-x.x.x-x64.AppImage"

# Debian/Ubuntu
sudo dpkg -i "Gemini Desktop-x.x.x-x64.deb"

πŸ”’ Privacy & Security Practices

πŸ“’ Detailed Breakdown: See our full Transparency Report for network logs, data storage details, and author identity.

We take your security seriously.

For full details, please read our Privacy Policy and Security Policy.

Category Practice Details
πŸ” Data No collection Zero analytics, telemetry, or tracking
Direct connection Only connects to google.com domains
No password storage Auth handled entirely by Google
πŸ›‘οΈ Security Automated Scans CodeQL and Dependency Audits run on every commit
Context Isolation Renderer cannot access Node.js
Sandboxed Renderer Process isolation enforced
Minimal Permissions Restricted system access
πŸ’Ύ Storage Encrypted cookies Standard Chromium session storage
Local cache only Standard browser caching
No cloud sync All data stays on your machine
πŸ” Transparency Open source Full code available for audit
No paywall bypass Respects Google's terms

⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl+Shift+Space Toggle Quick Chat
Ctrl+Alt+H Stealth Mode (Minimize to tray)
Ctrl+P Print to PDF
Ctrl+= / Ctrl+- Zoom In / Out
Ctrl+, Open Settings
Escape Close Quick Chat

πŸ’‘ Hotkeys can be modified in Settings if they conflict with other apps.


🎯 Features

  • πŸš€ Native Experience β€” Run Gemini as a standalone desktop app
  • 🎨 Custom Title Bar β€” Native-feeling window controls
  • πŸ•΅οΈ Stealth Mode β€” Instantly hide the app with one keystroke
  • πŸ“Œ Always On Top β€” Pin the window above others
  • πŸ”„ System Tray β€” Minimize to tray, quick access
  • πŸŒ™ Theme Sync β€” Follows your system light/dark preference
  • ⚑ Quick Chat β€” Spotlight-style prompt from anywhere
  • πŸ”” Smart Notifications β€” Get notified when long background responses finish
  • πŸ–¨οΈ Print to PDF β€” Save your chats or code snippets as PDF
  • πŸ” Zoom Controls β€” Adjust text size for comfortable reading

Gemini Desktop Main Window Interface


🀝 Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Reporting Issues

Found a bug? Open an issue with:

  • Your OS and version
  • Steps to reproduce
  • Expected vs actual behavior

πŸ› οΈ Development

Built with Electron + React + TypeScript + Vite.

Prerequisites

  • Node.js 18+
  • npm 9+

Quick Start

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

# Install dependencies
npm install

# Start development
npm run electron:dev

# Build for production
npm run electron:build

# Run tests
npm run test:all

Project Structure

gemini-desktop/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ main/      # Electron main process
β”‚   β”œβ”€β”€ renderer/  # React frontend
β”‚   └── shared/    # Shared types & constants
β”œβ”€β”€ tests/         # E2E and unit tests
└── build/         # Build assets (icons, etc.)

πŸ§ͺ Automated Testing

We take stability seriously. Gemini Desktop is backed by a comprehensive automated testing suite ensuring that core features work reliably and regressions are caught early.

Our Strategy

  • Unit Tests: Verify individual components and logic in isolation.
  • Integration Tests: Ensure different parts of the system (Electron main process, renderer, localized APIs) work together smoothly.
  • End-to-End (E2E) Tests: Simulate real user interactionsβ€”clicking, typing, and navigatingβ€”to validate full application flows.

Running Tests

If you're contributing or just curious, you can run the full suite yourself:

# Run all tests (Unit, Integration, E2E)
npm run test:all

# Run only E2E tests
npm run test:e2e

We believe that a robust test suite is key to maintaining a high-quality experience.

πŸ§ͺ Wayland Support & Testing (Linux)

Gemini Desktop supports native global hotkeys on KDE Wayland via XDG Desktop Portals.

  • Manual Testing: See Wayland Manual Testing Checklist.
  • Automated Testing: Most Wayland tests are skipped in CI due to environment constraints. For local runs, follow the Wayland Testing Runbook.
  • Debug Mode: Run with DEBUG_DBUS=1 to enable D-Bus signal tracking (see docs/TEST_ONLY_SIGNAL_TRACKING.md).

⭐ Star History

If you find this project useful, please consider giving it a star! ⭐


πŸ’¬ Community


πŸ™ Acknowledgments


βš–οΈ Legal & Compliance

Important

This is an unofficial, open-source project. It is NOT affiliated with, endorsed by, or associated with Google LLC.

Trademark Notice

  • Gemini and Google are registered trademarks of Google LLC.
  • This software is a third-party client and is not a Google product.

What This App Does

This application is a specialized web browser that loads the official https://gemini.google.com website. It does not modify the Gemini service, intercept encrypted data, or bypass any authentication.

User Responsibility

By using this software, you agree to comply with:

Warranty Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. See LICENSE for full terms.


πŸ“„ License

MIT Β© Ben Wendell


Made with ❀️ by the community

About

Native desktop client for Google Gemini on Windows, macOS, and Linux. Features global hotkeys, Spotlight-style Quick Chat, and zero data collection.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks