Bump mistralai to > 1.0.0 in preparation for latest models such as Pixtral

docs/WELCOME.md

@@ -88,7 +88,7 @@ Make your first call to an LLM to extract the title and author of a book from th
         {% if provider == "Anthropic" %}
         ```python hl_lines="19-38 43"
         {% elif provider == "Mistral" %}
-        ```python hl_lines="19-40 45"
+        ```python hl_lines="21-46 51"
         {% elif provider == "Gemini" %}
         ```python hl_lines="19-57 62"
         {% elif provider == "Cohere" %}

docs/WHY.md

@@ -94,7 +94,7 @@ Let's compare structured outputs using Mirascope vs. the official SDKs:
         {% if provider == "Anthropic" %}
         ```python hl_lines="19-38 43"
         {% elif provider == "Mistral" %}
-        ```python hl_lines="19-40 45"
+        ```python hl_lines="21-46 51"
         {% elif provider == "Gemini" %}
         ```python hl_lines="19-57 62"
         {% elif provider == "Cohere" %}

docs/learn/calls.md

@@ -58,6 +58,8 @@ Let's take a look at a basic example using Mirascope vs. official provider SDKs:
         ```python hl_lines="5-9"
         {% elif provider == "Azure AI" %}
         ```python hl_lines="11-18"
+        {% elif provider == "Mistral" %}
+        ```python hl_lines="10-15"
         {% else %}
         ```python hl_lines="7-11"
         {% endif %}

docs/learn/response_models.md

@@ -42,7 +42,7 @@ Let's take a look at a basic example using Mirascope vs. official provider SDKs:
         {% if provider == "Anthropic" %}
         ```python hl_lines="19-38 43"
         {% elif provider == "Mistral" %}
-        ```python hl_lines="19-40 45"
+        ```python hl_lines="21-46 51"
         {% elif provider == "Gemini" %}
         ```python hl_lines="19-57 62"
         {% elif provider == "Cohere" %}

docs/learn/tools.md

@@ -95,6 +95,8 @@ Let's take a look at a basic example of each using Mirascope vs. official provid
         ```python hl_lines="16-22 31-43 45-47"
         {% elif provider == "Vertex AI" %}
         ```python hl_lines="6-12 18-34 36-43"
+        {% elif provider == "Mistral" %}
+        ```python hl_lines="10-16 23-36 38-44"
         {% else %}
         ```python hl_lines="8-14 21-34 36-38"
         {% endif %}

examples/learn/async/custom_client/decorator/mistral/base_message_param.py

@@ -1,7 +1,11 @@
+import os
+
 from mirascope.core import BaseMessageParam, mistral
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralAsyncClient())
+@mistral.call(
+    "mistral-large-latest", client=Mistral(api_key=os.environ["MISTRAL_API_KEY"])
+)
 async def recommend_book_async(genre: str) -> list[BaseMessageParam]:
     return [BaseMessageParam(role="user", content=f"Recommend a {genre} book")]

examples/learn/async/custom_client/decorator/mistral/messages.py

@@ -1,7 +1,11 @@
+import os
+
 from mirascope.core import Messages, mistral
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralAsyncClient())
+@mistral.call(
+    "mistral-large-latest", client=Mistral(api_key=os.environ["MISTRAL_API_KEY"])
+)
 async def recommend_book_async(genre: str) -> Messages.Type:
     return Messages.User(f"Recommend a {genre} book")

examples/learn/async/custom_client/decorator/mistral/shorthand.py

@@ -1,7 +1,11 @@
+import os
+
 from mirascope.core import mistral
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralAsyncClient())
+@mistral.call(
+    "mistral-large-latest", client=Mistral(api_key=os.environ["MISTRAL_API_KEY"])
+)
 async def recommend_book_async(genre: str) -> str:
     return f"Recommend a {genre} book"

examples/learn/async/custom_client/decorator/mistral/string_template.py

@@ -1,7 +1,11 @@
+import os
+
 from mirascope.core import mistral, prompt_template
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralAsyncClient())
+@mistral.call(
+    "mistral-large-latest", client=Mistral(api_key=os.environ["MISTRAL_API_KEY"])
+)
 @prompt_template("Recommend a {genre} book")
 async def recommend_book_async(genre: str): ...

examples/learn/async/custom_client/dynamic_configuration/mistral/base_message_param.py

@@ -1,12 +1,14 @@
+import os
+
 from mirascope.core import BaseMessageParam, mistral
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
-async def recommend_book(genre: str) -> mistral.AsyncMistralDynamicConfig:
+async def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
         "messages": [
             BaseMessageParam(role="user", content=f"Recommend a {genre} book")
         ],
-        "client": MistralAsyncClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/async/custom_client/dynamic_configuration/mistral/messages.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import Messages, mistral
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
-async def recommend_book(genre: str) -> mistral.AsyncMistralDynamicConfig:
+async def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
         "messages": [Messages.User(f"Recommend a {genre} book")],
-        "client": MistralAsyncClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/async/custom_client/dynamic_configuration/mistral/shorthand.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import mistral, Messages
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
-async def recommend_book(genre: str) -> mistral.AsyncMistralDynamicConfig:
+async def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
         "messages": [Messages.User(f"Recommend a {genre} book")],
-        "client": MistralAsyncClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/async/custom_client/dynamic_configuration/mistral/string_template.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import mistral, prompt_template
-from mistralai.async_client import MistralAsyncClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
 @prompt_template("Recommend a {genre} book")
-async def recommend_book(genre: str) -> mistral.AsyncMistralDynamicConfig:
+async def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
-        "client": MistralAsyncClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/calls/basic_usage/mistral/official_sdk_call.py

@@ -1,14 +1,18 @@
-from mistralai.client import MistralClient
+import os
+from typing import cast
 
-client = MistralClient()
+from mistralai import Mistral
 
+client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
 
-def recommend_book(genre: str) -> str:
-    completion = client.chat(
+
+def recommend_book(genre: str) -> str | None:
+    completion = client.chat.complete(
         model="mistral-large-latest",
         messages=[{"role": "user", "content": f"Recommend a {genre} book"}],
     )
-    return completion.choices[0].message.content
+    if completion and (choices := completion.choices):
+        return cast(str, choices[0].message.content)
 
 
 output = recommend_book("fantasy")

examples/learn/calls/custom_client/decorator/mistral/base_message_param.py

@@ -1,7 +1,20 @@
+import os
+
 from mirascope.core import BaseMessageParam, mistral
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralClient())
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
 def recommend_book(genre: str) -> list[BaseMessageParam]:
     return [BaseMessageParam(role="user", content=f"Recommend a {genre} book")]
+
+
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
+async def recommend_book_async(genre: str) -> list[BaseMessageParam]:
+    return [BaseMessageParam(role="user", content=f"Recommend a {genre} book")]

examples/learn/calls/custom_client/decorator/mistral/messages.py

@@ -1,7 +1,20 @@
+import os
+
 from mirascope.core import Messages, mistral
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralClient())
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
 def recommend_book(genre: str) -> Messages.Type:
     return Messages.User(f"Recommend a {genre} book")
+
+
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
+async def recommend_book_async(genre: str) -> Messages.Type:
+    return Messages.User(f"Recommend a {genre} book")

examples/learn/calls/custom_client/decorator/mistral/shorthand.py

@@ -1,7 +1,20 @@
+import os
+
 from mirascope.core import mistral
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralClient())
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
 def recommend_book(genre: str) -> str:
     return f"Recommend a {genre} book"
+
+
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
+async def recommend_book_async(genre: str) -> str:
+    return f"Recommend a {genre} book"

examples/learn/calls/custom_client/decorator/mistral/string_template.py

@@ -1,7 +1,20 @@
+import os
+
 from mirascope.core import mistral, prompt_template
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
-@mistral.call("mistral-large-latest", client=MistralClient())
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
 @prompt_template("Recommend a {genre} book")
 def recommend_book(genre: str): ...
+
+
+@mistral.call(
+    "mistral-large-latest",
+    client=Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
+)
+@prompt_template("Recommend a {genre} book")
+async def recommend_book_async(genre: str): ...

examples/learn/calls/custom_client/dynamic_configuration/mistral/base_message_param.py

@@ -1,5 +1,7 @@
+import os
+
 from mirascope.core import BaseMessageParam, mistral
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
@@ -8,5 +10,5 @@ def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
         "messages": [
             BaseMessageParam(role="user", content=f"Recommend a {genre} book")
         ],
-        "client": MistralClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/calls/custom_client/dynamic_configuration/mistral/messages.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import Messages, mistral
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
 def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
         "messages": [Messages.User(f"Recommend a {genre} book")],
-        "client": MistralClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/calls/custom_client/dynamic_configuration/mistral/shorthand.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import mistral, Messages
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
 def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
         "messages": [Messages.User(f"Recommend a {genre} book")],
-        "client": MistralClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/calls/custom_client/dynamic_configuration/mistral/string_template.py

@@ -1,10 +1,12 @@
+import os
+
 from mirascope.core import mistral, prompt_template
-from mistralai.client import MistralClient
+from mistralai import Mistral
 
 
 @mistral.call("mistral-large-latest")
 @prompt_template("Recommend a {genre} book")
 def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
     return {
-        "client": MistralClient(),
+        "client": Mistral(api_key=os.environ["MISTRAL_API_KEY"]),
     }

examples/learn/calls/custom_messages/mistral_messages.py

@@ -1,10 +1,10 @@
 from mirascope.core import mistral
-from mistralai.models.chat_completion import ChatMessage
+from mistralai.models import UserMessage
 
 
 @mistral.call("mistral-large-latest")
 def recommend_book(genre: str) -> mistral.MistralDynamicConfig:
-    return {"messages": [ChatMessage(role="user", content=f"Recommend a {genre} book")]}
+    return {"messages": [UserMessage(role="user", content=f"Recommend a {genre} book")]}
 
 
 response = recommend_book("fantasy")

examples/learn/response_models/basic_usage/mistral/official_sdk.py

@@ -1,8 +1,10 @@
-from mistralai.client import MistralClient
-from mistralai.models.chat_completion import ToolChoice
+import os
+from typing import cast
+
+from mistralai import Mistral
 from pydantic import BaseModel
 
-client = MistralClient()
+client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
 
 
 class Book(BaseModel):
@@ -13,7 +15,7 @@ class Book(BaseModel):
 
 
 def extract_book(text: str) -> Book:
-    completion = client.chat(
+    completion = client.chat.complete(
         model="mistral-large-latest",
         messages=[{"role": "user", "content": f"Extract {text}"}],
         tools=[
@@ -33,10 +35,14 @@ def extract_book(text: str) -> Book:
                 "type": "function",
             }
         ],
-        tool_choice=ToolChoice.any,
+        tool_choice="any",
     )
-    if tool_calls := completion.choices[0].message.tool_calls:
-        return Book.model_validate_json(tool_calls[0].function.arguments)
+    if (
+        completion
+        and (choices := completion.choices)
+        and (tool_calls := choices[0].message.tool_calls)
+    ):
+        return Book.model_validate_json(cast(str, tool_calls[0].function.arguments))
     raise ValueError("No tool call found")