mistralai 1.5.0__tar.gz → 1.5.2rc1__tar.gz

{mistralai-1.5.0 → mistralai-1.5.2rc1}/PKG-INFO

@@ -1,11 +1,10 @@
 Metadata-Version: 2.3
 Name: mistralai
-Version: 1.5.0
+Version: 1.5.2rc1
 Summary: Python Client SDK for the Mistral AI API.
 Author: Mistral
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -14,12 +13,11 @@ Classifier: Programming Language :: Python :: 3.13
 Provides-Extra: gcp
 Requires-Dist: eval-type-backport (>=0.2.0)
 Requires-Dist: google-auth (>=2.27.0) ; extra == "gcp"
-Requires-Dist: httpx (>=0.27.0)
-Requires-Dist: jsonpath-python (>=1.0.6)
-Requires-Dist: pydantic (>=2.9.0)
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: pydantic (>=2.10.3)
 Requires-Dist: python-dateutil (>=2.8.2)
 Requires-Dist: requests (>=2.32.3) ; extra == "gcp"
-Requires-Dist: typing-inspect (>=0.9.0)
+Requires-Dist: typing-inspection (>=0.4.0)
 Project-URL: Repository, https://github.com/mistralai/client-python.git
 Description-Content-Type: text/markdown
 
@@ -100,6 +98,37 @@ pip install mistralai
 ```bash
 poetry add mistralai
 ```
+
+### Shell and script usage with `uv`
+
+You can use this SDK in a Python shell with [uv](https://docs.astral.sh/uv/) and the `uvx` command that comes with it like so:
+
+```shell
+uvx --from mistralai python
+```
+
+It's also possible to write a standalone Python script without needing to set up a whole project like so:
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.9"
+# dependencies = [
+#     "mistralai",
+# ]
+# ///
+
+from mistralai import Mistral
+
+sdk = Mistral(
+  # SDK arguments
+)
+
+# Rest of script here...
+```
+
+Once that is saved to a file, you can run it with `uv run script.py` where
+`script.py` can be replaced with the actual file name.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start SDK Example Usage [usage] -->
@@ -114,6 +143,7 @@ This example shows how to create chat completions.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -123,7 +153,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], stream=False)
+    ])
 
     # Handle response
     print(res)
@@ -139,6 +169,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -148,7 +179,7 @@ async def main():
                 "content": "Who is the best French painter? Answer in one short sentence.",
                 "role": "user",
             },
-        ], stream=False)
+        ])
 
         # Handle response
         print(res)
@@ -165,6 +196,7 @@ This example shows how to upload a file.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -188,6 +220,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -212,6 +245,7 @@ This example shows how to create agents completions.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -221,7 +255,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], agent_id="<id>", stream=False)
+    ], agent_id="<id>")
 
     # Handle response
     print(res)
@@ -237,6 +271,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -246,7 +281,7 @@ async def main():
                 "content": "Who is the best French painter? Answer in one short sentence.",
                 "role": "user",
             },
-        ], agent_id="<id>", stream=False)
+        ], agent_id="<id>")
 
         # Handle response
         print(res)
@@ -263,14 +298,15 @@ This example shows how to create embedding request.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
 
-    res = mistral.embeddings.create(inputs=[
+    res = mistral.embeddings.create(model="mistral-embed", inputs=[
         "Embed this sentence.",
         "As well as this one.",
-    ], model="mistral-embed")
+    ])
 
     # Handle response
     print(res)
@@ -286,14 +322,15 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
 
-        res = await mistral.embeddings.create_async(inputs=[
+        res = await mistral.embeddings.create_async(model="mistral-embed", inputs=[
             "Embed this sentence.",
             "As well as this one.",
-        ], model="mistral-embed")
+        ])
 
         # Handle response
         print(res)
@@ -467,6 +504,10 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [archive](https://github.com/mistralai/client-python/blob/master/docs/sdks/models/README.md#archive) - Archive Fine Tuned Model
 * [unarchive](https://github.com/mistralai/client-python/blob/master/docs/sdks/models/README.md#unarchive) - Unarchive Fine Tuned Model
 
+### [ocr](https://github.com/mistralai/client-python/blob/master/docs/sdks/ocr/README.md)
+
+* [process](https://github.com/mistralai/client-python/blob/master/docs/sdks/ocr/README.md#process) - OCR
+
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
@@ -486,6 +527,7 @@ underlying connection when the context is exited.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -495,7 +537,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], stream=True)
+    ])
 
     with res as event_stream:
         for event in event_stream:
@@ -523,6 +565,7 @@ Certain SDK methods accept file objects as part of a request body or multi-part
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -549,6 +592,7 @@ from mistralai import Mistral
 from mistralai.utils import BackoffStrategy, RetryConfig
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -567,6 +611,7 @@ from mistralai import Mistral
 from mistralai.utils import BackoffStrategy, RetryConfig
 import os
 
+
 with Mistral(
     retry_config=RetryConfig("backoff", BackoffStrategy(1, 50, 1.1, 100), False),
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -607,6 +652,7 @@ When custom error responses are specified for an operation, the SDK may also rai
 from mistralai import Mistral, models
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -634,9 +680,9 @@ with Mistral(
 
 You can override the default server globally by passing a server name to the `server: str` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the names associated with the available servers:
 
-| Name | Server                   |
-| ---- | ------------------------ |
-| `eu` | `https://api.mistral.ai` |
+| Name | Server                   | Description          |
+| ---- | ------------------------ | -------------------- |
+| `eu` | `https://api.mistral.ai` | EU Production server |
 
 #### Example
 
@@ -644,6 +690,7 @@ You can override the default server globally by passing a server name to the `se
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     server="eu",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -663,6 +710,7 @@ The default server can also be overridden globally by passing a URL to the `serv
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     server_url="https://api.mistral.ai",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -773,6 +821,7 @@ To authenticate with the API the `api_key` parameter must be set when initializi
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -796,6 +845,7 @@ The `Mistral` class implements the context manager protocol and registers a fina
 from mistralai import Mistral
 import os
 def main():
+
     with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -804,6 +854,7 @@ def main():
 
 # Or when using async:
 async def amain():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:

{mistralai-1.5.0 → mistralai-1.5.2rc1}/README-PYPI.md

@@ -75,6 +75,37 @@ pip install mistralai
 ```bash
 poetry add mistralai
 ```
+
+### Shell and script usage with `uv`
+
+You can use this SDK in a Python shell with [uv](https://docs.astral.sh/uv/) and the `uvx` command that comes with it like so:
+
+```shell
+uvx --from mistralai python
+```
+
+It's also possible to write a standalone Python script without needing to set up a whole project like so:
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.9"
+# dependencies = [
+#     "mistralai",
+# ]
+# ///
+
+from mistralai import Mistral
+
+sdk = Mistral(
+  # SDK arguments
+)
+
+# Rest of script here...
+```
+
+Once that is saved to a file, you can run it with `uv run script.py` where
+`script.py` can be replaced with the actual file name.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start SDK Example Usage [usage] -->
@@ -89,6 +120,7 @@ This example shows how to create chat completions.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -98,7 +130,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], stream=False)
+    ])
 
     # Handle response
     print(res)
@@ -114,6 +146,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -123,7 +156,7 @@ async def main():
                 "content": "Who is the best French painter? Answer in one short sentence.",
                 "role": "user",
             },
-        ], stream=False)
+        ])
 
         # Handle response
         print(res)
@@ -140,6 +173,7 @@ This example shows how to upload a file.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -163,6 +197,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -187,6 +222,7 @@ This example shows how to create agents completions.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -196,7 +232,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], agent_id="<id>", stream=False)
+    ], agent_id="<id>")
 
     # Handle response
     print(res)
@@ -212,6 +248,7 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -221,7 +258,7 @@ async def main():
                 "content": "Who is the best French painter? Answer in one short sentence.",
                 "role": "user",
             },
-        ], agent_id="<id>", stream=False)
+        ], agent_id="<id>")
 
         # Handle response
         print(res)
@@ -238,14 +275,15 @@ This example shows how to create embedding request.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
 
-    res = mistral.embeddings.create(inputs=[
+    res = mistral.embeddings.create(model="mistral-embed", inputs=[
         "Embed this sentence.",
         "As well as this one.",
-    ], model="mistral-embed")
+    ])
 
     # Handle response
     print(res)
@@ -261,14 +299,15 @@ from mistralai import Mistral
 import os
 
 async def main():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
 
-        res = await mistral.embeddings.create_async(inputs=[
+        res = await mistral.embeddings.create_async(model="mistral-embed", inputs=[
             "Embed this sentence.",
             "As well as this one.",
-        ], model="mistral-embed")
+        ])
 
         # Handle response
         print(res)
@@ -442,6 +481,10 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [archive](https://github.com/mistralai/client-python/blob/master/docs/sdks/models/README.md#archive) - Archive Fine Tuned Model
 * [unarchive](https://github.com/mistralai/client-python/blob/master/docs/sdks/models/README.md#unarchive) - Unarchive Fine Tuned Model
 
+### [ocr](https://github.com/mistralai/client-python/blob/master/docs/sdks/ocr/README.md)
+
+* [process](https://github.com/mistralai/client-python/blob/master/docs/sdks/ocr/README.md#process) - OCR
+
 </details>
 <!-- End Available Resources and Operations [operations] -->
 
@@ -461,6 +504,7 @@ underlying connection when the context is exited.
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -470,7 +514,7 @@ with Mistral(
             "content": "Who is the best French painter? Answer in one short sentence.",
             "role": "user",
         },
-    ], stream=True)
+    ])
 
     with res as event_stream:
         for event in event_stream:
@@ -498,6 +542,7 @@ Certain SDK methods accept file objects as part of a request body or multi-part
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -524,6 +569,7 @@ from mistralai import Mistral
 from mistralai.utils import BackoffStrategy, RetryConfig
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -542,6 +588,7 @@ from mistralai import Mistral
 from mistralai.utils import BackoffStrategy, RetryConfig
 import os
 
+
 with Mistral(
     retry_config=RetryConfig("backoff", BackoffStrategy(1, 50, 1.1, 100), False),
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -582,6 +629,7 @@ When custom error responses are specified for an operation, the SDK may also rai
 from mistralai import Mistral, models
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -609,9 +657,9 @@ with Mistral(
 
 You can override the default server globally by passing a server name to the `server: str` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the names associated with the available servers:
 
-| Name | Server                   |
-| ---- | ------------------------ |
-| `eu` | `https://api.mistral.ai` |
+| Name | Server                   | Description          |
+| ---- | ------------------------ | -------------------- |
+| `eu` | `https://api.mistral.ai` | EU Production server |
 
 #### Example
 
@@ -619,6 +667,7 @@ You can override the default server globally by passing a server name to the `se
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     server="eu",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -638,6 +687,7 @@ The default server can also be overridden globally by passing a URL to the `serv
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     server_url="https://api.mistral.ai",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
@@ -748,6 +798,7 @@ To authenticate with the API the `api_key` parameter must be set when initializi
 from mistralai import Mistral
 import os
 
+
 with Mistral(
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 ) as mistral:
@@ -771,6 +822,7 @@ The `Mistral` class implements the context manager protocol and registers a fina
 from mistralai import Mistral
 import os
 def main():
+
     with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:
@@ -779,6 +831,7 @@ def main():
 
 # Or when using async:
 async def amain():
+
     async with Mistral(
         api_key=os.getenv("MISTRAL_API_KEY", ""),
     ) as mistral:

{mistralai-1.5.0 → mistralai-1.5.2rc1}/packages/mistralai_azure/src/mistralai_azure/_hooks/types.py

@@ -7,16 +7,19 @@ from typing import Any, Callable, List, Optional, Tuple, Union
 
 
 class HookContext:
+    base_url: str
     operation_id: str
     oauth2_scopes: Optional[List[str]] = None
     security_source: Optional[Union[Any, Callable[[], Any]]] = None
 
     def __init__(
         self,
+        base_url: str,
         operation_id: str,
         oauth2_scopes: Optional[List[str]],
         security_source: Optional[Union[Any, Callable[[], Any]]],
     ):
+        self.base_url = base_url
         self.operation_id = operation_id
         self.oauth2_scopes = oauth2_scopes
         self.security_source = security_source
@@ -25,21 +28,30 @@ class HookContext:
 class BeforeRequestContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 
 class AfterSuccessContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 
 class AfterErrorContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 

{mistralai-1.5.0 → mistralai-1.5.2rc1}/packages/mistralai_azure/src/mistralai_azure/_version.py

@@ -4,6 +4,9 @@ import importlib.metadata
 
 __title__: str = "mistralai_azure"
 __version__: str = "1.2.6"
+__openapi_doc_version__: str = "0.0.2"
+__gen_version__: str = "2.548.6"
+__user_agent__: str = "speakeasy-sdk/python 1.2.6 2.548.6 0.0.2 mistralai_azure"
 
 try:
     if __package__ is not None:

{mistralai-1.5.0 → mistralai-1.5.2rc1}/packages/mistralai_azure/src/mistralai_azure/basesdk.py

@@ -231,6 +231,10 @@ class BaseSDK:
                     req.headers,
                     get_body_content(req),
                 )
+
+                if client is None:
+                    raise ValueError("client is required")
+
                 http_res = client.send(req, stream=stream)
             except Exception as e:
                 _, e = self.sdk_configuration.get_hooks().after_error(
@@ -303,6 +307,10 @@ class BaseSDK:
                     req.headers,
                     get_body_content(req),
                 )
+
+                if client is None:
+                    raise ValueError("client is required")
+
                 http_res = await client.send(req, stream=stream)
             except Exception as e:
                 _, e = self.sdk_configuration.get_hooks().after_error(