Groq Desktop

Groq Desktop 支持在 Groq 上托管的所有具备函数调用能力的模型的 MCP 服务器。现已支持 Windows、macOS 和 Linux！

macOS 用户注意：在 macOS 上安装后，您可能需要运行以下命令来打开应用程序：

xattr -c /Applications/Groq\ Desktop.app

<img width="500" alt="2025-10-30 下午4:26:14截图" src="https://gips3.baidu.com/it/u=1758827289,2330274640&fm=3081&app=3081&f=PNG?w=2952&h=2168" />

非官方 Homebrew 安装 (macOS)

您可以使用 Homebrew 通过非官方 tap 安装最新版本：

brew tap ricklamers/groq-desktop-unofficial
brew install --cask groq-desktop
# 允许应用程序运行
xattr -c /Applications/Groq\ Desktop.app

功能

• 带有图像支持的聊天界面
• 本地 MCP 服务器

先决条件

• Node.js (v18+)
• pnpm 包管理器

设置

1. 克隆此仓库
2. 安装依赖项：

   pnpm install
   

3. 启动开发服务器：

   pnpm dev
   

故障排除

Electron 安装问题

如果您在运行 pnpm dev 时遇到类似“Electron 安装不正确”的错误，这可能是由于 pnpm 因安全原因阻止了构建脚本。要解决这个问题：

1. 删除损坏的安装：

   rm -rf node_modules
   

2. 重新安装依赖项：

   pnpm install
   

3. 当提示时批准构建脚本（或手动运行）：

   pnpm approve-builds
   

   当提示时选择 electron 和 esbuild，允许它们的安装后脚本运行。

4. 再次尝试运行开发服务器：

   pnpm dev
   

生产构建

要为生产构建应用程序：

pnpm dist

这将在 release 目录中为您当前的平台创建可安装的包。

为特定平台构建

# 为所有支持的平台构建
pnpm dist

# 仅构建 macOS
pnpm dist:mac

# 仅构建 Windows
pnpm dist:win

# 仅构建 Linux
pnpm dist:linux

测试跨平台支持

此应用现在支持 Windows、macOS 和 Linux。以下是测试跨平台功能的方法：

运行跨平台测试

我们添加了一些测试脚本来验证平台支持：

# 运行所有平台测试（包括 Linux 的 Docker 测试）
pnpm test:platforms

# 仅运行基本路径处理测试
pnpm test:paths

# 如果在 Windows 上，请运行 PowerShell 测试脚本
.\test-windows.ps1

测试脚本将检查：

• 平台检测
• 脚本文件解析
• 环境变量处理
• 路径分隔符
• 命令解析

配置

在设置页面中，添加您的 Groq API 密钥：

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

您可以通过在 https://console.groq.com 注册来获取 Groq API 密钥。