Groq Desktop

Groq Desktop

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

macOS 用户须知：在 macOS 上安装后，你可能需要运行此命令才能打开应用：

xattr -c /Applications/Groq\ Desktop.app

非官方 Homebrew 安装（macOS）

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

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

功能

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

前置条件

• Node.js（v18+）
• pnpm 包管理器

设置

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

   pnpm install
   

3. 启动开发服务器：

   pnpm dev
   

故障排除

Electron 安装问题

如果运行 pnpm dev 时遇到类似“Electron failed to install correctly”的错误，可能是因为 pnpm 出于安全原因阻止了构建脚本。请按以下步骤修复：

1. 移除损坏的安装：

   rm -rf node_modules
   

2. 重新安装依赖：

   pnpm install
   

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

   pnpm approve-builds
   

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

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

   pnpm dev
   

构建生产版本

要构建应用的生产版本：

pnpm dist

这将在 release 目录中为你当前的平台生成可安装的软件包。

为特定平台构建

# 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

测试跨平台支持

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

运行跨平台测试

我们添加了多个测试脚本，用于验证平台支持：

# 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

测试脚本将检查：

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

配置

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

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

你可以在 https://console.groq.com 注册并获取 Groq API 密钥。