Skip to content

Conversation

@blastoiseclawd-hash
Copy link

Summary

Adds Groq as a new LLM provider. Groq provides ultra-fast inference using custom LPU hardware with an OpenAI-compatible API.

Changes

Type Definitions

  • src/types/llm-providers/groq/ - Full type definitions (api, messages, tools)

Backend Integration

  • Added Groq to proxiedModelCreators, preferredSourcePrefixes, providerEnvVars, displayNames, pricesByProvider, rulesByProvider, providerParsers, providerMappers, envApiKeyFallbacks, modelFetchers
  • Created fetchGroqModels function

Shared Constants

  • Added groq to SupportedProviders enum and discriminators

E2E Tests

Added Groq configs to all LLM proxy test files:

  • tool-invocation, tool-persistence, token-cost-limits, model-optimization, tool-result-compression

Documentation

  • Added Groq section to platform-supported-llm-providers.md

API Key

Get free API key at console.groq.com/keys

Environment Variables

Variable Required Default
ARCHESTRA_GROQ_BASE_URL No https://api.groq.com/openai/v1
ARCHESTRA_CHAT_GROQ_API_KEY No Per-request

Testing

  • TypeScript compiles (pnpm type-check)
  • Code follows Cerebras pattern exactly
  • E2E test configs added
  • Demo video - Available on request

Notes

Groq uses OpenAI-compatible API, so error handling reuses existing OpenAI parsers/mappers. All integration points follow established patterns.

Closes #1856

- Add Groq provider types (api.ts, messages.ts, tools.ts, index.ts)
- Add Groq to SupportedProviders schema
- Add Groq to model-constants with fastest/best model patterns
- Add Groq client integration with @ai-sdk/groq
- Add Groq config (API key and base URL)

Groq is OpenAI-compatible and uses LPU inference for fast responses.
Base URL: https://api.groq.com/openai/v1

Relates to archestra-ai#1856
- Add groq to proxied model creators
- Add groq to model fetchers with fetchGroqModels function
- Add groq to seed data (env vars, display names)
- Add groq to optimization rules (prices, rules)
- Add groq to error handlers (using OpenAI-compatible parsing)
- Add groq to API key fallbacks

All TypeScript type checks pass.

Relates to archestra-ai#1856
Work in progress - adding Groq provider configs to e2e test suite.
- tool-invocation.spec.ts
- tool-persistence.spec.ts
- token-cost-limits.spec.ts
- model-optimization.spec.ts
- tool-result-compression.spec.ts

Groq uses OpenAI-compatible API with LPU inference.
Includes:
- OpenAI-compatible API details
- Base URL and authentication format
- Environment variables
- Popular models
- Getting an API key link
@CLAassistant
Copy link

CLAassistant commented Feb 3, 2026

CLA assistant check
All committers have signed the CLA.

@London-Cat
Copy link
Collaborator

London-Cat commented Feb 3, 2026

📊 Reputation Summary

User Rep Pull Requests Activity Assigned Core Reactions
blastoiseclawd-hash ⚡ 3 0✅ 1🔄 0❌ 0 issues, 1 comments 0
CLAassistant ⚡ 0 0✅ 0🔄 0❌ 0 issues, 50 comments 0

How is the score calculated? Read about it in the Reputation Bot repository 🤖

@blastoiseclawd-hash
Copy link
Author

@CLAassistant check

1 similar comment
@blastoiseclawd-hash
Copy link
Author

@CLAassistant check

@blastoiseclawd-hash
Copy link
Author

recheck

Copy link
Contributor

@joeyorlando joeyorlando left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi there 👋

Thanks for your contribution. I'm going to close out this PR. It is missing a short demo-video, and the e2e tests will not pass (as there are no wiremock .json response files added for groq).

Please see our Contribution Guidelines, in particular the "Contribute Responsibly" section.

@joeyorlando joeyorlando closed this Feb 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Provider] Add Groq support

5 participants