---

name: groq-hello-world description: | Create a minimal working Groq example. Use when starting a new Groq integration, testing your setup, or learning basic Groq API patterns. Trigger with phrases like "groq hello world", "groq example", "groq quick start", "simple groq code". allowed-tools: Read, Write, Edit version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io

Groq Hello World

Overview

Minimal working example demonstrating core Groq functionality.

Prerequisites

• Completed groq-install-auth setup
• Valid API credentials configured
• Development environment ready

Instructions

Step 1: Create Entry File

Create a new file for your hello world example.

Step 2: Import and Initialize Client

Copyimport { GroqClient } from '@groq/sdk';

const client = new GroqClient({
  apiKey: process.env.GROQ_API_KEY,
});

Step 3: Make Your First API Call

Copyasync function main() {
  // Your first API call here
}

main().catch(console.error);

Output

• Working code file with Groq client initialization
• Successful API response confirming connection
• Console output showing:

CopySuccess! Your Groq connection is working.

Error Handling

Examples

TypeScript Example

Copyimport { GroqClient } from '@groq/sdk';

const client = new GroqClient({
  apiKey: process.env.GROQ_API_KEY,
});

async function main() {
  // Your first API call here
}

main().catch(console.error);

Python Example

Copyfrom groq import GroqClient

client = GroqClient()

# Your first API call here

Resources

• Groq Getting Started
• Groq API Reference
• Groq Examples

Next Steps

Proceed to groq-local-dev-loop for development workflow setup.