Groq Desktop
- desktop-chat
Local Groq Desktop chat app with MCP support
About
What is Groq Desktop?
Groq Desktop is a desktop client that features MCP (Model Context Protocol) server support for all function calling capable models hosted on Groq. It is available for Windows, macOS, and Linux and includes a chat interface with image support.
How to use Groq Desktop?
After installing the application (via official releases or unofficial Homebrew tap on macOS), add your Groq API key in the settings page. If building from source, ensure Node.js v18+ and pnpm are installed, then clone the repository, run pnpm install, and start the development server with pnpm dev. For production builds, use pnpm dist to create platform-specific installable packages.
Key features of Groq Desktop
- Chat interface with image support
- Local MCP server support
- MCP server compatibility for all function calling Groq models
- Cross‑platform availability (Windows, macOS, Linux)
Use cases of Groq Desktop
- Conducting chat‑based interactions with Groq’s function calling models
- Extending model capabilities by connecting local MCP servers
- Developing and testing MCP servers alongside Groq models
FAQ from Groq Desktop
How do I get a Groq API key?
Sign up at https://console.groq.com to obtain your API key. Then add it to the settings page as "GROQ_API_KEY": "your-api-key-here".
What platforms are supported?
Groq Desktop supports Windows, macOS, and Linux.
Do I need Node.js to use Groq Desktop?
If you are installing a prebuilt release, Node.js is not required. To build from source, you need Node.js v18+ and the pnpm package manager.
Does Groq Desktop support MCP servers?
Yes. Groq Desktop features MCP server support for all function calling capable models hosted on Groq, and also supports local MCP servers.
How do I install Groq Desktop on macOS?
You can install via an unofficial Homebrew tap by running brew tap ricklamers/groq-desktop-unofficial then brew install --cask groq-desktop, or download the .dmg from the latest release. After installation, run xattr -c /Applications/Groq\ Desktop.app to allow the app to open.
Details
- Author
- groq
- GitHub stars
- 268
- Category
- desktop-chat
- Repository
- groq/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
> <img width="450" alt="Screenshot 2025-04-14 at 11 53 18 PM" src="https://github.com/user-attachments/assets/300abf8c-8b7f-4ef8-a5f9-174f93e39506" /><img width="450" alt="Screenshot 2025-04-14 at 11 53 35 PM" src="https://github.com/user-attachments/assets/61641680-5b3d-4ca9-8da4-8e84779f97bb" />
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
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.
