What is Gemini Desktop

Gemini-desktop is a cross-platform desktop application that provides a seamless chat interface for Google’s Gemini AI models, utilizing a Multi-server Chat Protocol (MCP) framework for extensibility.

Use cases

Use cases include providing real-time weather updates, performing calculations, and facilitating interactive conversations with users in different applications.

How to use

To use Gemini-desktop, install the Python backend and the Electron application. Set up your environment by installing necessary dependencies and configuring your Google API key as an environment variable.

Key features

Key features include a user-friendly chat interface, integration with various tools like weather and calculator, and extensibility through the MCP framework.

Where to use

Gemini-desktop can be used in various fields such as customer support, personal assistance, and educational tools, where AI-driven chat interactions are beneficial.

GemCP Chat

The GemCP app is a cross-platform desktop application that creates a seamless chat interface for Google's Gemini AI models with extensible capabilities through a Model Context Protocol (MCP) framework.

✨ Features

• 🤖 Gemini Integration: Seamless chat interface with Google’s Gemini models (configurable via Settings).
• 🔧 Extensible Tools (MCP): Connect external tools and data sources via the Model Context Protocol.
  • Supports Python-based MCP servers (added via file path).
  • Supports command-based MCP servers (e.g., Node.js) defined in a JSON configuration file.
• 🖥️ Cross-Platform: Runs on macOS and Windows (Electron build).
• 📊 Tool Status UI: Provides visual feedback when Gemini is calling an MCP tool and whether it succeeded or failed.
• ⚙️ Model Selection: Choose different Gemini models (e.g., 1.5 Flash, 1.5 Pro, 2.5 Pro Exp) through the Settings dialog.
• 📝 Markdown & LaTeX Rendering: Displays AI responses with formatting.

Screenshots

Example of the weather tool in action

Main chat interface with Gemini

Using the calculator tool with Gemini

Overview

This repository contains both a Python backend and an Electron-based desktop application for interacting with Gemini.

Project Structure

• mcp-gemini-desktop/: Frontend Electron application
• python_backend/: Python backend server

Running the Python Backend

Prerequisites

• Python 3.13+ (as specified in pyproject.toml)
• uv (Modern Python package installer and resolver)

Setup

1. Navigate to the Python backend directory:

   cd python_backend
   

2. Install uv if you don’t have it already:

   pip install uv
   

3. Install the required dependencies using uv:

   uv pip install .
   

4. Set your Google API key as an environment variable:

   # For Linux/macOS
   export GOOGLE_API_KEY=your_api_key_here
   
   # For Windows
   set GOOGLE_API_KEY=your_api_key_here
   

5. Start the Python backend server:

   python main.py
   

   The server should start running on http://localhost:5000

Running the Frontend Electron App

Prerequisites

• Node.js (v16+)
• npm (Node package manager)

Setup

1. Navigate to the Electron app directory:

   cd mcp-gemini-desktop
   

2. Install the required dependencies:

   npm install
   

3. Start the Electron app in development mode:

   npm start
   

Building the App

To build the Electron app for your platform:

cd mcp-gemini-desktop
npm run build

This will create platform-specific binaries in the dist folder.

Using Pre-built Binaries

If you prefer to use pre-built binaries directly:

1. Navigate to the mcp-gemini-desktop/dist directory
2. For macOS: Install the .dmg file
3. For Windows: Run the .exe installer

Available Binaries

• macOS (Apple Silicon): GemCP Chat-0.1.0-arm64.dmg
• Windows: Check the dist folder for .exe files

Example Servers

The repository includes example server implementations in mcp-gemini-desktop/mcp_example_servers/:

• mcp_server_calc.py: Calculator server example
• mcp_server_weather.py: Weather information server example

Troubleshooting

• Ensure the Python backend is running before starting the Electron app
• Check that your Google API key is correctly set
• Verify that the required ports are not blocked by a firewall

License

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

Contributing

Please raise PR for any contributions. Any PR raised will be reviewed and merged with the main branch.