groq-local-dev-loop

# Groq Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Groq. Groq's sub-second response times make it uniquely suited for tight dev loops -- you get LLM responses fast enough to iterate without context-switching. ## Prerequisites - `groq-sdk` installed - `GROQ_API_KEY` set (free tier is fine for development) - Node.js 18+ with tsx for TypeScript execution - vitest for testing ## Instructions ### Step 1: Project Structure ``` my-groq-project/ ├── src/ │ ├── groq/ │ │ ├── client.ts # Singleton Groq client │ │ ├── models.ts # Model constants and selection │ │ └── completions.ts # Completion wrappers │ └── index.ts ├── tests/ │ ├── groq.test.ts # Unit tests with mocks │ └── groq.integration.ts # Live API tests (CI-only) ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team └── package.json ``` ### Step 2: Package Setup ```json { "scripts": { "dev": "tsx watch src/index.ts", "test": "vitest", "test:watch": "vitest --watch", "test:integration": "GROQ_INTEGRATION=1 vitest tests/groq.integration.ts" }, "dependencies": { "groq-sdk": "^0.12.0" }, "devDependencies": { "tsx": "^4.0.0", "vitest": "^2.0.0" } } ``` ### Step 3: Singleton Client ```typescript // src/groq/client.ts import Groq from "groq-sdk"; let _client: Groq | null = null; export function getGroqClient(): Groq { if (!_client) { if (!proce...