groq-hello-world
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".
When & Why to Use This Skill
This Claude skill streamlines the initial integration process for the Groq API by providing a minimal, ready-to-use 'Hello World' boilerplate. It helps developers quickly verify their environment setup, handle authentication, and understand the basic syntax for Groq's TypeScript and Python SDKs, significantly reducing the time from installation to the first successful API call.
Use Cases
- Initial Integration: Rapidly generate starter code when beginning a new project that requires Groq's high-speed AI inference.
- Environment Testing: Use as a diagnostic tool to verify that API keys and environment variables are correctly configured and that the network can reach Groq's endpoints.
- Onboarding & Learning: Provide a clear, executable reference for developers to learn the fundamental patterns of Groq client initialization and request handling.
- Debugging: Serve as a 'minimal reproducible example' to isolate whether issues reside in complex application logic or the underlying API connection.
| name | groq-hello-world |
|---|---|
| description | | |
| 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-authsetup - 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
import { GroqClient } from '@groq/sdk';
const client = new GroqClient({
apiKey: process.env.GROQ_API_KEY,
});
Step 3: Make Your First API Call
async 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:
Success! Your Groq connection is working.
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Import Error | SDK not installed | Verify with npm list or pip show |
| Auth Error | Invalid credentials | Check environment variable is set |
| Timeout | Network issues | Increase timeout or check connectivity |
| Rate Limit | Too many requests | Wait and retry with exponential backoff |
Examples
TypeScript Example
import { 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
from groq import GroqClient
client = GroqClient()
# Your first API call here
Resources
Next Steps
Proceed to groq-local-dev-loop for development workflow setup.