Skip to content

feat(providers): add Groq as optional provider#94

Merged
bdcdo merged 2 commits into
mainfrom
feature/groq-provider-optional
Apr 19, 2026
Merged

feat(providers): add Groq as optional provider#94
bdcdo merged 2 commits into
mainfrom
feature/groq-provider-optional

Conversation

@bdcdo
Copy link
Copy Markdown
Owner

@bdcdo bdcdo commented Apr 19, 2026

Summary

  • Adiciona groq como extra opcional em pyproject.toml (pip install dataframeit[groq]) e inclui langchain-groq>=0.2.0 no extra all.
  • Documenta o provider em docs/guides/providers.md e docs/en/guides/providers.md com os modelos atualmente disponíveis no Groq (produção: llama-3.3-70b-versatile, llama-3.1-8b-instant, openai/gpt-oss-120b, openai/gpt-oss-20b, groq/compound; preview: meta-llama/llama-4-scout-17b-16e-instruct, qwen/qwen3-32b).
  • Registra a adição no CHANGELOG.md sob [Unreleased].

Não altera o default (provider='google_genai' / model='gemini-3-flash-preview'); langchain-groq continua fora das dependências obrigatórias.

Substitui #86 (fechado), que tentava tornar Groq o default e embarcava langchain-groq como dependência obrigatória.

Test plan

  • uv sync --extra groq instala langchain-groq e groq.
  • uv run pytest passa (247 passed, 5 skipped).
  • from langchain_groq import ChatGroq + validate_provider_dependencies("groq") funcionam.
  • Smoke test manual com provider='groq' e GROQ_API_KEY válida.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features
    • Added Groq as a supported LLM provider. Install with pip install dataframeit[groq], configure the GROQ_API_KEY environment variable, and specify provider='groq' in calls. Documentation includes setup instructions, usage examples, and recommended model listings for both production and preview tiers.

Install via `pip install dataframeit[groq]`. Works with `provider='groq'`
and Groq's production Llama/GPT-OSS models plus agentic `groq/compound`.
Default provider/model is unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 19, 2026

Warning

Rate limit exceeded

@bdcdo has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 48 minutes and 11 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 48 minutes and 11 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: fbd6577e-b37c-4fdf-ad69-0f0481cfac02

📥 Commits

Reviewing files that changed from the base of the PR and between b13572e and 911107b.

📒 Files selected for processing (3)
  • CHANGELOG.md
  • docs/en/guides/providers.md
  • docs/guides/providers.md
📝 Walkthrough

Walkthrough

This pull request adds optional Groq LLM provider support to the project. Changes include documentation for both English and Portuguese versions, updated dependency configuration for langchain-groq, and a changelog entry documenting the new feature.

Changes

Cohort / File(s) Summary
Groq Provider Documentation
docs/en/guides/providers.md, docs/guides/providers.md
Added comprehensive Groq provider documentation including installation instructions, API key setup, usage examples with provider='groq', supported model variants, and recommended production/preview models. Duplicated across English and Portuguese versions.
Dependencies Configuration
pyproject.toml
Added langchain-groq>=0.2.0 as a new optional dependency group and included it in the all aggregate dependencies list.
Changelog Entry
CHANGELOG.md
Documented new optional Groq support in the Unreleased section, including installation via pip install dataframeit[groq], provider usage syntax, and GROQ_API_KEY environment variable requirement.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hops of joy, with whiskers twitching bright,
Groq joins our warren—a llama in flight!
With API keys tucked and models so sleek,
Our docs now bilingual, the features peak! 🚀

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The pull request title accurately and concisely describes the main change: adding Groq as an optional provider to the dataframeit package.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/groq-provider-optional

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
docs/guides/providers.md (1)

12-12: Nit: tabela-resumo não lista groq/compound.

A seção "Modelos Recomendados" (Linha 162) inclui groq/compound como modelo de produção, mas a tabela-resumo em Linha 12 não o menciona. Para consistência, considere adicioná-lo (ou uma nota de "...e outros").

📝 Proposed change
-| Groq | `groq` | llama-3.3-70b-versatile, llama-3.1-8b-instant, openai/gpt-oss-120b, openai/gpt-oss-20b |
+| Groq | `groq` | llama-3.3-70b-versatile, llama-3.1-8b-instant, openai/gpt-oss-120b, openai/gpt-oss-20b, groq/compound |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/guides/providers.md` at line 12, The summary table row for "Groq |
`groq`" is missing the `groq/compound` entry referenced later in the "Modelos
Recomendados" section; update that table cell to include `groq/compound` (or
append a trailing note like "…e outros") so the table and the "Modelos
Recomendados" list stay consistent—locate the table row containing the text
"Groq | `groq`" and add `groq/compound` to the comma-separated model list.
CHANGELOG.md (1)

10-12: Add PR reference to the Groq entry.

Other entries in this changelog (e.g., #77, #64) cite the associated issue/PR, and the coding guidelines require including issue/PR references. Please append (#94) to this entry.

📝 Proposed change
-- **Suporte opcional a Groq**: novo provider disponível via `pip install dataframeit[groq]`. Use com `provider='groq'` e modelos como `llama-3.3-70b-versatile` ou `llama-3.1-8b-instant`. Requer `GROQ_API_KEY`.
+- **Suporte opcional a Groq** (`#94`): novo provider disponível via `pip install dataframeit[groq]`. Use com `provider='groq'` e modelos como `llama-3.3-70b-versatile` ou `llama-3.1-8b-instant`. Requer `GROQ_API_KEY`.

As per coding guidelines: "Always update CHANGELOG.md ... include issue/PR references".

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CHANGELOG.md` around lines 10 - 12, Update the "Suporte opcional a Groq"
changelog bullet by appending the PR reference "(`#94`)" to the end of that entry;
locate the bullet containing the text "**Suporte opcional a Groq**" and modify
its line so the sentence ends with "Requer `GROQ_API_KEY`. (`#94`)".
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@CHANGELOG.md`:
- Around line 10-12: Update the "Suporte opcional a Groq" changelog bullet by
appending the PR reference "(`#94`)" to the end of that entry; locate the bullet
containing the text "**Suporte opcional a Groq**" and modify its line so the
sentence ends with "Requer `GROQ_API_KEY`. (`#94`)".

In `@docs/guides/providers.md`:
- Line 12: The summary table row for "Groq | `groq`" is missing the
`groq/compound` entry referenced later in the "Modelos Recomendados" section;
update that table cell to include `groq/compound` (or append a trailing note
like "…e outros") so the table and the "Modelos Recomendados" list stay
consistent—locate the table row containing the text "Groq | `groq`" and add
`groq/compound` to the comma-separated model list.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d43abd51-b31e-47de-a026-883764ad3193

📥 Commits

Reviewing files that changed from the base of the PR and between 3ce4d76 and b13572e.

📒 Files selected for processing (4)
  • CHANGELOG.md
  • docs/en/guides/providers.md
  • docs/guides/providers.md
  • pyproject.toml

Addresses CodeRabbit nits on #94: list groq/compound alongside the other
production models in the provider summary tables (PT/EN) and cite (#94)
in the CHANGELOG entry per project convention.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@bdcdo bdcdo merged commit 107ab23 into main Apr 19, 2026
1 check passed
@bdcdo bdcdo deleted the feature/groq-provider-optional branch April 19, 2026 01:37
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.

1 participant