release: 0.31.1 (#249)

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Cole McCracken <colemccracken@gmail.com>
Co-authored-by: Graden Rea <grea@groq.com>

Author: 3 people

.github/workflows/ci.yml

@@ -36,13 +36,13 @@ jobs:
         run: ./scripts/lint
 
   build:
-    if: github.repository == 'stainless-sdks/groqcloud-python' && (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     timeout-minutes: 10
     name: build
     permissions:
       contents: read
       id-token: write
-    runs-on: depot-ubuntu-24.04
+    runs-on: ${{ github.repository == 'stainless-sdks/groqcloud-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -61,12 +61,14 @@ jobs:
         run: rye build
 
       - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/groqcloud-python'
         id: github-oidc
         uses: actions/github-script@v6
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
+        if: github.repository == 'stainless-sdks/groqcloud-python'
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.31.0"
+  ".": "0.31.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-4543b558a0a546fc45d3300535b9b535f9cf251f4284bc255d3bc337727e5a50.yml
-openapi_spec_hash: 09235cb11f84f84a07819c2b3f0a6d6a
-config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-7b46be9995c02d5d7f1e18b2f29704c54a25664c6c9b36330d133883d1ad3fce.yml
+openapi_spec_hash: 210b0cc34ee0750530d872c12e39cc31
+config_hash: 961b4995e909aef11a454befa56ad3d2

CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.31.1 (2025-09-04)
+
+Full Changelog: [v0.31.0...v0.31.1](https://github.com/groq/groq-python/compare/v0.31.0...v0.31.1)
+
+### Features
+
+* **api:** api update ([0a8a5c0](https://github.com/groq/groq-python/commit/0a8a5c0be7709857fdff72d03a34dce723f13b71))
+* **api:** api update ([7896dbd](https://github.com/groq/groq-python/commit/7896dbd7b60828795d2e9780cdf326b001fc839c))
+* **api:** api update ([f9b5dca](https://github.com/groq/groq-python/commit/f9b5dca378b9916ca2ab592922b9ffba7247a1ae))
+* **api:** api update ([e34ec28](https://github.com/groq/groq-python/commit/e34ec28c9705485684293cfb97eec63b16257bd7))
+* **api:** api update ([cd14d0a](https://github.com/groq/groq-python/commit/cd14d0ab7eb0b161ffeef69a7b89cce062aeb078))
+* **api:** api update ([7d02cd3](https://github.com/groq/groq-python/commit/7d02cd32852d47016cf3b6cc7ca0f898dd0c99c5))
+* **api:** api update ([437f5fb](https://github.com/groq/groq-python/commit/437f5fb2040d345614ffe9ff15c525feb2ab19de))
+* improve future compat with pydantic v3 ([42a6cb9](https://github.com/groq/groq-python/commit/42a6cb96e631ad48c371a1ab58b6adea07897685))
+* **types:** replace List[str] with SequenceNotStr in params ([d1ee744](https://github.com/groq/groq-python/commit/d1ee74483e6d2e2353985d760837e72af3143be8))
+
+
+### Bug Fixes
+
+* avoid newer type syntax ([21f93a7](https://github.com/groq/groq-python/commit/21f93a72c50f49187e09310df41e5dbb984298c3))
+* compeltions streaming overloads ([201e137](https://github.com/groq/groq-python/commit/201e137d9b336b4fef847713e6e743ac47e733be))
+* update example model from decommissioned models to gpt-oss-20b ([1570583](https://github.com/groq/groq-python/commit/1570583818c7355c1ea6cc4460075f60d3cd29bb))
+* update example model from decommissioned models to gpt-oss-20b ([#250](https://github.com/groq/groq-python/issues/250)) ([edb9132](https://github.com/groq/groq-python/commit/edb91324ebff8d10f993492dd68ed05ac030bc9f))
+
+
+### Chores
+
+* **internal:** add Sequence related utils ([01104d8](https://github.com/groq/groq-python/commit/01104d8c4a179a2ad347d0e12f935d6547f61b31))
+* **internal:** change ci workflow machines ([e796cb9](https://github.com/groq/groq-python/commit/e796cb9599db99fa9e29f97e54ffe519bd23bf1b))
+* **internal:** fix ruff target version ([b58149d](https://github.com/groq/groq-python/commit/b58149d9584a5c9b0afc935af6aef2a2c64c1187))
+* **internal:** update comment in script ([bd20c49](https://github.com/groq/groq-python/commit/bd20c49c957e990aeb8c3bb8bb9c3dc9bcc31b86))
+* **internal:** update pyright exclude list ([124e838](https://github.com/groq/groq-python/commit/124e8387b8ba18853f93dede16ffba8c49c441a0))
+* update @stainless-api/prism-cli to v5.15.0 ([b2f49cc](https://github.com/groq/groq-python/commit/b2f49cc1301696827eb00d5db91895d71c3da965))
+* update github action ([c7662e0](https://github.com/groq/groq-python/commit/c7662e01641af2daa758eb23bb19c9b65d0d5d20))
+
 ## 0.31.0 (2025-08-05)
 
 Full Changelog: [v0.30.0...v0.31.0](https://github.com/groq/groq-python/compare/v0.30.0...v0.31.0)

README.md

@@ -39,7 +39,7 @@ chat_completion = client.chat.completions.create(
             "content": "Explain the importance of low latency LLMs",
         }
     ],
-    model="llama3-8b-8192",
+    model="openai/gpt-oss-20b",
 )
 print(chat_completion.choices[0].message.content)
 ```
@@ -71,7 +71,7 @@ async def main() -> None:
                 "content": "Explain the importance of low latency LLMs",
             }
         ],
-        model="llama3-8b-8192",
+        model="openai/gpt-oss-20b",
     )
     print(chat_completion.choices[0].message.content)
 
@@ -112,7 +112,7 @@ async def main() -> None:
                     "content": "Explain the importance of low latency LLMs",
                 }
             ],
-            model="llama3-8b-8192",
+            model="openai/gpt-oss-20b",
         )
         print(chat_completion.id)
 
@@ -146,9 +146,9 @@ chat_completion = client.chat.completions.create(
         }
     ],
     model="meta-llama/llama-4-scout-17b-16e-instruct",
-    search_settings={},
+    compound_custom={},
 )
-print(chat_completion.search_settings)
+print(chat_completion.compound_custom)
 ```
 
 ## File uploads
@@ -196,7 +196,7 @@ try:
                 "content": "Explain the importance of low latency LLMs",
             },
         ],
-        model="llama3-8b-8192",
+        model="openai/gpt-oss-20b",
     )
 except groq.APIConnectionError as e:
     print("The server could not be reached")
@@ -251,7 +251,7 @@ client.with_options(max_retries=5).chat.completions.create(
             "content": "Explain the importance of low latency LLMs",
         },
     ],
-    model="llama3-8b-8192",
+    model="openai/gpt-oss-20b",
 )
 ```
 
@@ -286,7 +286,7 @@ client.with_options(timeout=5.0).chat.completions.create(
             "content": "Explain the importance of low latency LLMs",
         },
     ],
-    model="llama3-8b-8192",
+    model="openai/gpt-oss-20b",
 )
 ```
 
@@ -336,7 +336,7 @@ response = client.chat.completions.with_raw_response.create(
         "role": "user",
         "content": "Explain the importance of low latency LLMs",
     }],
-    model="llama3-8b-8192",
+    model="openai/gpt-oss-20b",
 )
 print(response.headers.get('X-My-Header'))
 
@@ -366,7 +366,7 @@ with client.chat.completions.with_streaming_response.create(
             "content": "Explain the importance of low latency LLMs",
         },
     ],
-    model="llama3-8b-8192",
+    model="openai/gpt-oss-20b",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "groq"
-version = "0.31.0"
+version = "0.31.1"
 description = "The official Python library for the groq API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -148,6 +148,7 @@ exclude = [
     "_dev",
     ".venv",
     ".nox",
+    ".git",
 ]
 
 reportImplicitOverride = true
@@ -159,7 +160,7 @@ reportPrivateUsage = false
 [tool.ruff]
 line-length = 120
 output-format = "grouped"
-target-version = "py37"
+target-version = "py38"
 
 [tool.ruff.format]
 docstring-code-format = true

scripts/mock

@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
   # Wait for server to come online
   echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL"
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
 fi

scripts/test

@@ -43,7 +43,7 @@ elif ! prism_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the prism command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stoplight/prism-cli@~5.3.2 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
   echo
 
   exit 1

src/groq/_base_client.py

@@ -59,7 +59,7 @@
     ModelBuilderProtocol,
 )
 from ._utils import is_dict, is_list, asyncify, is_given, lru_cache, is_mapping
-from ._compat import PYDANTIC_V2, model_copy, model_dump
+from ._compat import PYDANTIC_V1, model_copy, model_dump
 from ._models import GenericModel, FinalRequestOptions, validate_type, construct_type
 from ._response import (
     APIResponse,
@@ -232,7 +232,7 @@ def _set_private_attributes(
         model: Type[_T],
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -320,7 +320,7 @@ def _set_private_attributes(
         client: AsyncAPIClient,
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model