groq-desktop-beta

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

Prerequisites

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

Setup

1. Clone this repository
2. Install dependencies:

   pnpm install
   

3. Start the development server:

   pnpm dev
   

Troubleshooting

Electron Installation Issues

If you encounter an error like "Electron failed to install correctly" when running pnpm dev, this is likely because pnpm blocked the build scripts for security reasons. To fix this:

1. Remove the corrupted installation:

   rm -rf node_modules
   

2. Reinstall dependencies:

   pnpm install
   

3. Approve the build scripts when prompted (or run manually):

   pnpm approve-builds
   

   Select electron and esbuild when prompted to allow their post-install scripts to run.

4. Try running the dev server again:

   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"
}

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