gemini-webapi 1.17.2__tar.gz → 1.18.0__tar.gz

{gemini_webapi-1.17.2 → gemini_webapi-1.18.0}/.github/workflows/pypi-publish.yml

@@ -36,7 +36,7 @@ jobs:
       - name: Build package
         run: python -m build
       - name: Archive production artifacts
-        uses: actions/upload-artifact@v5.0.0
+        uses: actions/upload-artifact@v6.0.0
         with:
           name: dist
           path: dist
@@ -52,7 +52,7 @@ jobs:
       id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
     steps:
       - name: Retrieve built artifacts
-        uses: actions/download-artifact@v6.0.0
+        uses: actions/download-artifact@v7.0.0
         with:
           name: dist
           path: dist

{gemini_webapi-1.17.2 → gemini_webapi-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-webapi
-Version: 1.17.2
+Version: 1.18.0
 Summary: ✨ An elegant async Python wrapper for Google Gemini web app
 Author: UZQueen
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE
@@ -678,8 +678,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx[http2]~=0.28.1
 Requires-Dist: loguru~=0.7.3
-Requires-Dist: orjson~=3.11.1
-Requires-Dist: pydantic~=2.12.2
+Requires-Dist: orjson~=3.11.7
+Requires-Dist: pydantic~=2.12.5
 Dynamic: license-file
 
 <p align="center">
@@ -717,6 +717,7 @@ A reverse-engineered asynchronous python wrapper for [Google Gemini](https://gem
 - **System Prompt** - Supports customizing model's system prompt with [Gemini Gems](https://gemini.google.com/gems/view).
 - **Extension Support** - Supports generating contents with [Gemini extensions](https://gemini.google.com/extensions) on, like YouTube and Gmail.
 - **Classified Outputs** - Categorizes texts, thoughts, web images and AI generated images in the response.
+- **Streaming Mode** - Supports stream generation, yielding partial outputs as they are generated.
 - **Official Flavor** - Provides a simple and elegant interface inspired by [Google Generative AI](https://ai.google.dev/tutorials/python_quickstart)'s official API.
 - **Asynchronous** - Utilizes `asyncio` to run generating tasks and return outputs efficiently.
 
@@ -732,6 +733,7 @@ A reverse-engineered asynchronous python wrapper for [Google Gemini](https://gem
   - [Generate contents with files](#generate-contents-with-files)
   - [Conversations across multiple turns](#conversations-across-multiple-turns)
   - [Continue previous conversations](#continue-previous-conversations)
+  - [Streaming mode](#streaming-mode)
   - [Select language model](#select-language-model)
   - [Apply system prompt with Gemini Gems](#apply-system-prompt-with-gemini-gems)
   - [Manage Custom Gems](#manage-custom-gems)
@@ -901,6 +903,28 @@ async def main():
 asyncio.run(main())
 ```
 
+### Streaming mode
+
+For longer responses, you can use streaming mode to receive partial outputs as they are generated. This provides a more responsive user experience, especially for real-time applications like chatbots.
+
+The `generate_content_stream` method yields `ModelOutput` objects where the `text_delta` attribute contains only the **new characters** received since the last yield, making it easy to display incremental updates.
+
+```python
+async def main():
+    async for chunk in client.generate_content_stream(
+        "What's the difference between 'await' and 'async for'?"
+    ):
+        print(chunk.text_delta, end="", flush=True)
+
+    print()
+
+asyncio.run(main())
+```
+
+> [!TIP]
+>
+> You can also use streaming mode in multi-turn conversations with `ChatSession.send_message_stream`.
+
 ### Select language model
 
 You can specify which language model to use by passing `model` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. The default value is `unspecified`.
@@ -909,8 +933,8 @@ Currently available models (as of November 20, 2025):
 
 - `unspecified` - Default model
 - `gemini-3.0-pro` - Gemini 3.0 Pro
-- `gemini-2.5-pro` - Gemini 2.5 Pro
-- `gemini-2.5-flash` - Gemini 2.5 Flash
+- `gemini-3.0-flash` - Gemini 3.0 Flash
+- `gemini-3.0-flash-thinking` - Gemini 3.0 Flash Thinking
 
 ```python
 from gemini_webapi.constants import Model
@@ -918,9 +942,9 @@ from gemini_webapi.constants import Model
 async def main():
     response1 = await client.generate_content(
         "What's you language model version? Reply version number only.",
-        model=Model.G_2_5_FLASH,
+        model=Model.G_3_0_FLASH,
     )
-    print(f"Model version ({Model.G_2_5_FLASH.model_name}): {response1.text}")
+    print(f"Model version ({Model.G_3_0_FLASH.model_name}): {response1.text}")
 
     chat = client.start_chat(model="gemini-2.5-pro")
     response2 = await chat.send_message("What's you language model version? Reply version number only.")
@@ -968,7 +992,7 @@ async def main():
 
     response1 = await client.generate_content(
         "what's your system prompt?",
-        model=Model.G_2_5_FLASH,
+        model=Model.G_3_0_FLASH,
         gem=coding_partner,
     )
     print(response1.text)

{gemini_webapi-1.17.2 → gemini_webapi-1.18.0}/README.md

@@ -33,6 +33,7 @@ A reverse-engineered asynchronous python wrapper for [Google Gemini](https://gem
 - **System Prompt** - Supports customizing model's system prompt with [Gemini Gems](https://gemini.google.com/gems/view).
 - **Extension Support** - Supports generating contents with [Gemini extensions](https://gemini.google.com/extensions) on, like YouTube and Gmail.
 - **Classified Outputs** - Categorizes texts, thoughts, web images and AI generated images in the response.
+- **Streaming Mode** - Supports stream generation, yielding partial outputs as they are generated.
 - **Official Flavor** - Provides a simple and elegant interface inspired by [Google Generative AI](https://ai.google.dev/tutorials/python_quickstart)'s official API.
 - **Asynchronous** - Utilizes `asyncio` to run generating tasks and return outputs efficiently.
 
@@ -48,6 +49,7 @@ A reverse-engineered asynchronous python wrapper for [Google Gemini](https://gem
   - [Generate contents with files](#generate-contents-with-files)
   - [Conversations across multiple turns](#conversations-across-multiple-turns)
   - [Continue previous conversations](#continue-previous-conversations)
+  - [Streaming mode](#streaming-mode)
   - [Select language model](#select-language-model)
   - [Apply system prompt with Gemini Gems](#apply-system-prompt-with-gemini-gems)
   - [Manage Custom Gems](#manage-custom-gems)
@@ -217,6 +219,28 @@ async def main():
 asyncio.run(main())
 ```
 
+### Streaming mode
+
+For longer responses, you can use streaming mode to receive partial outputs as they are generated. This provides a more responsive user experience, especially for real-time applications like chatbots.
+
+The `generate_content_stream` method yields `ModelOutput` objects where the `text_delta` attribute contains only the **new characters** received since the last yield, making it easy to display incremental updates.
+
+```python
+async def main():
+    async for chunk in client.generate_content_stream(
+        "What's the difference between 'await' and 'async for'?"
+    ):
+        print(chunk.text_delta, end="", flush=True)
+
+    print()
+
+asyncio.run(main())
+```
+
+> [!TIP]
+>
+> You can also use streaming mode in multi-turn conversations with `ChatSession.send_message_stream`.
+
 ### Select language model
 
 You can specify which language model to use by passing `model` argument to `GeminiClient.generate_content` or `GeminiClient.start_chat`. The default value is `unspecified`.
@@ -225,8 +249,8 @@ Currently available models (as of November 20, 2025):
 
 - `unspecified` - Default model
 - `gemini-3.0-pro` - Gemini 3.0 Pro
-- `gemini-2.5-pro` - Gemini 2.5 Pro
-- `gemini-2.5-flash` - Gemini 2.5 Flash
+- `gemini-3.0-flash` - Gemini 3.0 Flash
+- `gemini-3.0-flash-thinking` - Gemini 3.0 Flash Thinking
 
 ```python
 from gemini_webapi.constants import Model
@@ -234,9 +258,9 @@ from gemini_webapi.constants import Model
 async def main():
     response1 = await client.generate_content(
         "What's you language model version? Reply version number only.",
-        model=Model.G_2_5_FLASH,
+        model=Model.G_3_0_FLASH,
     )
-    print(f"Model version ({Model.G_2_5_FLASH.model_name}): {response1.text}")
+    print(f"Model version ({Model.G_3_0_FLASH.model_name}): {response1.text}")
 
     chat = client.start_chat(model="gemini-2.5-pro")
     response2 = await chat.send_message("What's you language model version? Reply version number only.")
@@ -284,7 +308,7 @@ async def main():
 
     response1 = await client.generate_content(
         "what's your system prompt?",
-        model=Model.G_2_5_FLASH,
+        model=Model.G_3_0_FLASH,
         gem=coding_partner,
     )
     print(response1.text)

{gemini_webapi-1.17.2 → gemini_webapi-1.18.0}/pyproject.toml

@@ -22,8 +22,8 @@ requires-python = ">=3.10"
 dependencies = [
     "httpx[http2]~=0.28.1",
     "loguru~=0.7.3",
-    "orjson~=3.11.1",
-    "pydantic~=2.12.2",
+    "orjson~=3.11.7",
+    "pydantic~=2.12.5",
 ]
 dynamic = ["version"]