Groq Desktop

Groq Desktop features MCP server support for all function calling capable models hosted on Groq. Now available for Windows, macOS, and Linux!

Note for macOS Users: After installing on macOS, you may need to run this command to open the app:

xattr -c /Applications/Groq\ Desktop.app

Unofficial Homebrew Installation (macOS)

You can install the latest release using Homebrew via an unofficial tap:

brew tap ricklamers/groq-desktop-unofficial
brew install --cask groq-desktop
# Allow the app to run
xattr -c /Applications/Groq\ Desktop.app

Features

• Chat interface with image support
• Local MCP servers
• Persistent conversations with export
• Conversation import
• Search within messages
• Voice input and text-to-speech
• Message editing, branching and regeneration

Prerequisites

• Node.js (v18+)
• pnpm package manager

Setup

1. Clone this repository
2. Install dependencies:

   pnpm install
   

3. Start the development server:

   pnpm dev
   

Building for Production

To build the application for production:

pnpm dist

This will create installable packages in the release directory for your current platform.

Building for Specific Platforms

# Build for all supported platforms
pnpm dist

# Build for macOS only
pnpm dist:mac

# Build for Windows only
pnpm dist:win

# Build for Linux only
pnpm dist:linux

Testing Cross-Platform Support

This app now supports Windows, macOS, and Linux. Here's how to test cross-platform functionality:

Running Cross-Platform Tests

We've added several test scripts to verify platform support:

# Run all platform tests (including Docker test for Linux)
pnpm test:platforms

# Run basic path handling test only
pnpm test:paths

# If on Windows, run the PowerShell test script
.\test-windows.ps1

The testing scripts will check:

• Platform detection
• Script file resolution
• Environment variable handling
• Path separators
• Command resolution

Configuration

In the settings page, add your Groq API key:

{
  "GROQ_API_KEY": "your-api-key-here"
}

You can obtain a Groq API key by signing up at https://console.groq.com.