How should groq-desktop-app be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

groq-desktop-app answer-first brief

A simple Electron app with Groq API integration Groq Desktop $1 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: Table of Contents - $1 - $1 - $1 - $1 - $1 - $1 - $1 - $1 - $1 <img width="450" alt="Screenshot 2025-08-05 at 11 32 04 AM" src="https://github.com/user-attachm Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

groq-desktop-app is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 100/100

groq-desktop-app

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal1 GitHub stars

Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

1 GitHub starsSchema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Quanticsoul4772

Artifacts

Benchmarks

Last release

1.0.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/quanticsoul4772/groq-desktop-beta.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Quanticsoul4772

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Adoption (1)

Adoption signal

1 GitHub stars

profilemedium

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

> xattr -c /Applications/Groq\ Desktop.app
>

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

text

pnpm install

text

pnpm dev

bash

rm -rf node_modules

bash

pnpm install

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

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)
Features
Prerequisites
Setup
Troubleshooting
Building for Production
Configuration
Testing
Contributing <img width="450" alt="Screenshot 2025-08-05 at 11 32 04 AM" src="https://github.com/user-attachments/assets/d4fd9224-8186-4117-bdeb-b477f8a42d49" /> <br> <br> <img width="450" alt="Screenshot 2025-08-05 at 11 28 49 AM" src="https://github.com/user-attachments/assets/ced9c517-74f0-46b0-8e91-40ebc88adc3a" />

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
Dark mode toggle with persistent theme preference

Prerequisites

Node.js (v18+)
pnpm package manager

Setup

Clone this repository
Install dependencies:
```
pnpm install
```
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:

Remove the corrupted installation:
```
rm -rf node_modules
```
Reinstall dependencies:
```
pnpm install
```
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.
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

Development

Testing

This project maintains comprehensive test coverage with a minimum requirement of 90% across all metrics (lines, branches, functions, and statements).

Test Scripts

# Run all tests
pnpm test

# Run tests with coverage report
pnpm test:coverage

# Run only unit tests
pnpm test:unit

# Run only integration tests
pnpm test:integration

# Run tests in watch mode for development
pnpm test:watch

# Run tests for CI/CD (enforces coverage thresholds)
pnpm test:ci

Test Structure

Unit Tests: Located in __tests__/unit/
- React components (__tests__/unit/components/)
- Electron main process (__tests__/unit/electron/)
- Utility functions (__tests__/unit/renderer/)
Integration Tests: Located in __tests__/integration/
- API resilience and retry logic
- Cache behavior and performance
- Electron-renderer communication
Test Setup: Automated mocking for Electron, React, and external APIs

Coverage Requirements

All new code must maintain:

Lines: ≥90%
Branches: ≥90%
Functions: ≥90%
Statements: ≥90%

The build will fail if coverage drops below these thresholds.

Running Tests Locally

# Install dependencies
pnpm install

# Run tests with coverage
pnpm test:coverage

# View coverage report
open coverage/lcov-report/index.html

Testing Cross-Platform Support

This app supports Windows, macOS, and Linux. Legacy platform tests:

# 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 platform testing scripts 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.

Dark Mode

The app now includes a dark mode toggle in the Settings page. Toggle between light and dark themes, and your preference will persist across app restarts. The theme is applied immediately when changed and stored in your user settings.

Testing

This project maintains a minimum test coverage of 90% across all metrics (lines, branches, functions, and statements). We use Jest as our testing framework with separate configurations for React components, Electron main process, and integration tests.

Running Tests

# Run all tests
pnpm test

# Run tests with coverage report
pnpm test:coverage

# Run only unit tests
pnpm test:unit

# Run only integration tests
pnpm test:integration

# Run tests in watch mode (for development)
pnpm test:watch

# Run tests in CI mode (with coverage enforcement)
pnpm test:ci

Test Structure

__tests__/unit/ - Unit tests for utilities and helpers
__tests__/integration/ - Integration tests for API and system interactions
src/renderer/components/__tests__/ - React component tests
electron/__tests__/ - Electron main process module tests

Coverage Requirements

All code must maintain at least 90% test coverage. The build will fail if coverage falls below:

Lines: 90%
Branches: 90%
Functions: 90%
Statements: 90%

View the coverage report after running tests:

pnpm test:coverage
open coverage/index.html

Writing Tests

When contributing new features or fixes:

Write tests for all new code
Ensure existing tests still pass
Update tests when modifying existing functionality
Follow the existing test patterns in the codebase

Continuous Integration

Tests are automatically run on all pull requests and pushes to main. The CI pipeline:

Runs tests across multiple OS (Ubuntu, macOS, Windows)
Checks coverage thresholds
Reports coverage metrics on PRs
Uploads coverage reports to Codecov

Contributing

We welcome contributions! Please see our Contributing Guide for detailed setup instructions, development workflows, and coding conventions.

Quick start for contributors:

Clone the repository
Install dependencies: pnpm install
Set up your environment: cp env.example .env (add your Groq API key)
Start development: pnpm dev

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/quanticsoul4772/groq-desktop-beta#input",
  "outputSchemaRef": "https://github.com/quanticsoul4772/groq-desktop-beta#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:13.255Z",
  "sourceUpdatedAt": "2026-02-24T19:46:13.255Z",
  "freshnessSeconds": 4421911
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T00:04:45.164Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "electron",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "groq",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "desktop",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "chat",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:electron|supported|profile capability:groq|supported|profile capability:desktop|supported|profile capability:chat|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.255Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.255Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/quanticsoul4772/groq-desktop-beta#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.255Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Quanticsoul4772",
    "href": "https://github.com/quanticsoul4772/groq-desktop-beta",
    "sourceUrl": "https://github.com/quanticsoul4772/groq-desktop-beta",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "1 GitHub stars",
    "href": "https://github.com/quanticsoul4772/groq-desktop-beta",
    "sourceUrl": "https://github.com/quanticsoul4772/groq-desktop-beta",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-quanticsoul4772-groq-desktop-beta/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]