webscout 8.3.2__py3-none-any.whl → 8.3.3__py3-none-any.whl

webscout/Provider/HeckAI.py

@@ -57,7 +57,7 @@ class HeckAI(Provider):
         proxies: dict = {},
         history_offset: int = 10250,
         act: str = None,
-        model: str = "google/gemini-2.0-flash-001",
+        model: str = "google/gemini-2.5-flash-preview",
         language: str = "English"
     ):
         """
@@ -177,79 +177,73 @@ class HeckAI(Provider):
         def for_stream():
             streaming_text = "" # Initialize outside try block
             try:
-                # Use curl_cffi session post with impersonate
                 response = self.session.post(
                     self.url, 
-                    # headers are set on the session
                     data=json.dumps(payload), 
                     stream=True, 
                     timeout=self.timeout,
-                    impersonate="chrome110" # Use a common impersonation profile
+                    impersonate="chrome110"
                 )
-                response.raise_for_status() # Check for HTTP errors
+                response.raise_for_status()
 
-                # Use sanitize_stream to process the stream
                 processed_stream = sanitize_stream(
-                data=response.iter_content(chunk_size=1024), # Pass byte iterator
-                intro_value="data: ",  # Prefix to remove (note the space)
-                to_json=False,        # Content is text
-                start_marker="data: [ANSWER_START]",
-                end_marker="data: [ANSWER_DONE]",
-                skip_markers=["data: [RELATE_Q_START]", "data: [RELATE_Q_DONE]", "data: [REASON_START]", "data: [REASON_DONE]"],
-                yield_raw_on_error=True,
-                strip_chars=" \n\r\t"  # Strip whitespace characters from chunks
+                    data=response.iter_content(chunk_size=1024),
+                    intro_value="data: ",
+                    to_json=False,
+                    start_marker="data: [ANSWER_START]",
+                    end_marker="data: [ANSWER_DONE]",
+                    skip_markers=["data: [RELATE_Q_START]", "data: [RELATE_Q_DONE]", "data: [REASON_START]", "data: [REASON_DONE]"],
+                    yield_raw_on_error=True,
+                    strip_chars=" \n\r\t",
+                    raw=raw
                 )
 
                 for content_chunk in processed_stream:
-                    # content_chunk is the text between ANSWER_START and ANSWER_DONE
                     if content_chunk and isinstance(content_chunk, str):
-                        streaming_text += content_chunk
-                        yield dict(text=content_chunk) if not raw else content_chunk
+                        content_chunk = content_chunk.replace('\\\\', '\\').replace('\\"', '"')
+                    if raw:
+                        if content_chunk and isinstance(content_chunk, str):
+                            streaming_text += content_chunk
+                        yield content_chunk
+                    else:
+                        if content_chunk and isinstance(content_chunk, str):
+                            streaming_text += content_chunk
+                            yield dict(text=content_chunk)
                 
                 # Only update history if we received a valid response
                 if streaming_text:
-                    # Update history and previous answer after stream finishes
                     self.previous_answer = streaming_text
-                    # Convert to simple text before updating conversation
                     try:
-                        # Ensure content is valid before updating conversation
                         if streaming_text and isinstance(streaming_text, str):
-                            # Sanitize the content to ensure it's valid
                             sanitized_text = streaming_text.strip()
-                            if sanitized_text:  # Only update if we have non-empty content
+                            if sanitized_text:
                                 self.conversation.update_chat_history(prompt, sanitized_text)
                     except Exception as e:
-                        # If conversation update fails, log but don't crash
                         print(f"Warning: Failed to update conversation history: {str(e)}")
-                    
-            except CurlError as e: # Catch CurlError
+            except CurlError as e:
                 raise exceptions.FailedToGenerateResponseError(f"Request failed (CurlError): {str(e)}") from e
-            except Exception as e: # Catch other potential exceptions (like HTTPError)
+            except Exception as e:
                 err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
                 raise exceptions.FailedToGenerateResponseError(f"Request failed ({type(e).__name__}): {str(e)} - {err_text}") from e
 
-
         def for_non_stream():
-            # Aggregate the stream using the updated for_stream logic
             full_text = ""
             try:
-                # Ensure raw=False so for_stream yields dicts
                 for chunk_data in for_stream():
-                    if isinstance(chunk_data, dict) and "text" in chunk_data:
-                        full_text += chunk_data["text"]
-                    # Handle raw string case if raw=True was passed
-                    elif raw and isinstance(chunk_data, str):
-                         full_text += chunk_data
+                    if raw:
+                        if isinstance(chunk_data, str):
+                            chunk_data = chunk_data.replace('\\\\', '\\').replace('\\"', '"')
+                            full_text += chunk_data
+                    else:
+                        if isinstance(chunk_data, dict) and "text" in chunk_data:
+                            text = chunk_data["text"].replace('\\\\', '\\').replace('\\"', '"')
+                            full_text += text
             except Exception as e:
-                 # If aggregation fails but some text was received, use it. Otherwise, re-raise.
-                 if not full_text:
-                     raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
-
-            # Return the final aggregated response dict or raw string
-            self.last_response = {"text": full_text} # Update last_response here
+                if not full_text:
+                    raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
+            self.last_response = {"text": full_text}
             return full_text if raw else self.last_response
 
-
         return for_stream() if stream else for_non_stream()
 
     @staticmethod
@@ -266,15 +260,15 @@ class HeckAI(Provider):
         if isinstance(text, dict) and "text" in text:
             try:
                 text["text"] = text["text"].encode("latin1").decode("utf-8")
-                return text
+                return text.replace('\\\\', '\\').replace('\\"', '"') # Handle escaped backslashes 
             except (UnicodeError, AttributeError) as e:
-                return text
+                return text.replace('\\\\', '\\').replace('\\"', '"') # Handle escaped backslashes 
         elif isinstance(text, str):
             try:
                 return text.encode("latin1").decode("utf-8")
             except (UnicodeError, AttributeError) as e:
-                return text
-        return text
+                return text.replace('\\\\', '\\').replace('\\"', '"') # Handle escaped backslashes 
+        return text.replace('\\\\', '\\').replace('\\"', '"') # Handle escaped backslashes 
 
     def chat(
         self,
@@ -282,6 +276,7 @@ class HeckAI(Provider):
         stream: bool = False,
         optimizer: str = None,
         conversationally: bool = False,
+        raw: bool = False,
     ) -> Union[str, Generator[str, None, None]]:
         """
         Sends a prompt to the HeckAI API and returns only the message text.
@@ -298,18 +293,23 @@ class HeckAI(Provider):
         def for_stream_chat():
             # ask() yields dicts or strings when streaming
             gen = self.ask(
-                prompt, stream=True, raw=False, # Ensure ask yields dicts
+                prompt, stream=True, raw=raw,
                 optimizer=optimizer, conversationally=conversationally
             )
-            for response_dict in gen:
-                yield self.get_message(response_dict) # get_message expects dict
+            for response in gen:
+                if raw:
+                    yield response
+                else:
+                    yield self.get_message(response)
                 
         def for_non_stream_chat():
             # ask() returns dict or str when not streaming
             response_data = self.ask(
-                prompt, stream=False, raw=False, # Ensure ask returns dict
+                prompt, stream=False, raw=raw,
                 optimizer=optimizer, conversationally=conversationally
             )
+            if raw:
+                return response_data if isinstance(response_data, str) else str(response_data)
             return self.get_message(response_data) # get_message expects dict
             
         return for_stream_chat() if stream else for_non_stream_chat()
@@ -338,38 +338,43 @@ class HeckAI(Provider):
         # Ensure text is a string
         text = response["text"]
         if not isinstance(text, str):
-            return str(text)
+            text = str(text)
 
-        return text
+        return text.replace('\\\\', '\\').replace('\\"', '"')
 
 if __name__ == "__main__":
-    # Ensure curl_cffi is installed
-    print("-" * 80)
-    print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    print("-" * 80)
-
-    for model in HeckAI.AVAILABLE_MODELS:
-        try:
-            test_ai = HeckAI(model=model, timeout=60)
-            # Use non-streaming mode first to avoid potential streaming issues
-            try:
-                response_text = test_ai.chat("Say 'Hello' in one word", stream=False)
-                print(f"\r{model:<50} {'✓':<10} {response_text.strip()[:50]}")
-            except Exception as e1:
-                # Fall back to streaming if non-streaming fails
-                print(f"\r{model:<50} {'Testing stream...':<10}", end="", flush=True)
-                response = test_ai.chat("Say 'Hello' in one word", stream=True)
-                response_text = ""
-                for chunk in response:
-                    if chunk and isinstance(chunk, str):
-                        response_text += chunk
+    # # Ensure curl_cffi is installed
+    # print("-" * 80)
+    # print(f"{'Model':<50} {'Status':<10} {'Response'}")
+    # print("-" * 80)
+
+    # for model in HeckAI.AVAILABLE_MODELS:
+    #     try:
+    #         test_ai = HeckAI(model=model, timeout=60)
+    #         # Use non-streaming mode first to avoid potential streaming issues
+    #         try:
+    #             response_text = test_ai.chat("Say 'Hello' in one word", stream=False)
+    #             print(f"\r{model:<50} {'✓':<10} {response_text.strip()[:50]}")
+    #         except Exception as e1:
+    #             # Fall back to streaming if non-streaming fails
+    #             print(f"\r{model:<50} {'Testing stream...':<10}", end="", flush=True)
+    #             response = test_ai.chat("Say 'Hello' in one word", stream=True)
+    #             response_text = ""
+    #             for chunk in response:
+    #                 if chunk and isinstance(chunk, str):
+    #                     response_text += chunk
                 
-                if response_text and len(response_text.strip()) > 0:
-                    status = "✓"
-                    # Truncate response if too long
-                    display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
-                    print(f"\r{model:<50} {status:<10} {display_text}")
-                else:
-                    raise ValueError("Empty or invalid response")
-        except Exception as e:
-            print(f"\r{model:<50} {'✗':<10} {str(e)}")
+    #             if response_text and len(response_text.strip()) > 0:
+    #                 status = "✓"
+    #                 # Truncate response if too long
+    #                 display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
+    #                 print(f"\r{model:<50} {status:<10} {display_text}")
+    #             else:
+    #                 raise ValueError("Empty or invalid response")
+    #     except Exception as e:
+    #         print(f"\r{model:<50} {'✗':<10} {str(e)}")
+    from rich import print
+    ai = HeckAI()
+    response = ai.chat("tell me about humans", stream=True, raw=False)
+    for chunk in response:
+        print(chunk, end='', flush=True)

webscout/Provider/Jadve.py

@@ -170,16 +170,20 @@ class JadveOpenAI(Provider):
                     intro_value=None, # No simple prefix
                     to_json=False,    # Content is text after extraction
                     content_extractor=self._jadve_extractor, # Use the specific extractor
-                    # end_marker="e:", # Add if 'e:' reliably marks the end
-                    yield_raw_on_error=True
+                    yield_raw_on_error=True,
+                    raw=raw
                 )
 
                 for content_chunk in processed_stream:
-                    # content_chunk is the string extracted by _jadve_extractor
-                    if content_chunk and isinstance(content_chunk, str):
-                        full_response_text += content_chunk
-                        resp = {"text": content_chunk}
-                        yield resp if not raw else content_chunk
+                    if raw:
+                        if content_chunk and isinstance(content_chunk, str):
+                            full_response_text += content_chunk
+                        yield content_chunk
+                    else:
+                        if content_chunk and isinstance(content_chunk, str):
+                            full_response_text += content_chunk
+                            resp = {"text": content_chunk}
+                            yield resp
 
                 # Update history after stream finishes
                 self.last_response = {"text": full_response_text}
@@ -191,30 +195,22 @@ class JadveOpenAI(Provider):
                 err_text = getattr(e, 'response', None) and getattr(e.response, 'text', '')
                 raise exceptions.FailedToGenerateResponseError(f"Failed to generate response ({type(e).__name__}): {e} - {err_text}") from e
 
-
         def for_non_stream():
-            # Aggregate the stream using the updated for_stream logic
             collected_text = ""
             try:
-                # Ensure raw=False so for_stream yields dicts
                 for chunk_data in for_stream():
-                    if isinstance(chunk_data, dict) and "text" in chunk_data:
-                        collected_text += chunk_data["text"]
-                    # Handle raw string case if raw=True was passed
-                    elif raw and isinstance(chunk_data, str):
-                         collected_text += chunk_data
+                    if raw:
+                        if isinstance(chunk_data, str):
+                            collected_text += chunk_data
+                    else:
+                        if isinstance(chunk_data, dict) and "text" in chunk_data:
+                            collected_text += chunk_data["text"]
             except Exception as e:
-                 # If aggregation fails but some text was received, use it. Otherwise, re-raise.
-                 if not collected_text:
-                     raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
-
+                if not collected_text:
+                    raise exceptions.FailedToGenerateResponseError(f"Failed to get non-stream response: {str(e)}") from e
             # last_response and history are updated within for_stream
-            # Return the final aggregated response dict or raw string
             return collected_text if raw else self.last_response
 
-
-        # Since the API endpoint suggests streaming, always call the stream generator.
-        # The non-stream wrapper will handle aggregation if stream=False.
         return for_stream() if stream else for_non_stream()
 
     def chat(
@@ -223,6 +219,7 @@ class JadveOpenAI(Provider):
         stream: bool = False,
         optimizer: str = None,
         conversationally: bool = False,
+        raw: bool = False,
     ) -> Union[str, Generator[str, None, None]]:
         """
         Generate a chat response (string). 
@@ -232,25 +229,29 @@ class JadveOpenAI(Provider):
             stream (bool, optional): Flag for streaming response. Defaults to False.
             optimizer (str, optional): Prompt optimizer name. Defaults to None.
             conversationally (bool, optional): Flag for conversational optimization. Defaults to False.
+            raw (bool, optional): Return raw response. Defaults to False.
         Returns:
             str or generator: Generated response string or generator yielding response chunks.
         """
         def for_stream_chat():
-            # ask() yields dicts or strings when streaming
             gen = self.ask(
-                prompt, stream=True, raw=False, # Ensure ask yields dicts
+                prompt, stream=True, raw=raw,
                 optimizer=optimizer, conversationally=conversationally
             )
-            for response_dict in gen:
-                yield self.get_message(response_dict) # get_message expects dict
+            for response in gen:
+                if raw:
+                    yield response
+                else:
+                    yield self.get_message(response)
 
         def for_non_stream_chat():
-            # ask() returns dict or str when not streaming
             response_data = self.ask(
-                prompt, stream=False, raw=False, # Ensure ask returns dict
+                prompt, stream=False, raw=raw,
                 optimizer=optimizer, conversationally=conversationally
             )
-            return self.get_message(response_data) # get_message expects dict
+            if raw:
+                return response_data if isinstance(response_data, str) else str(response_data)
+            return self.get_message(response_data)
 
         return for_stream_chat() if stream else for_non_stream_chat()
 
@@ -268,24 +269,29 @@ class JadveOpenAI(Provider):
         return response.get("text", "")
 
 if __name__ == "__main__":
-    # Ensure curl_cffi is installed
-    print("-" * 80)
-    print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    print("-" * 80)
-
-    for model in JadveOpenAI.AVAILABLE_MODELS:
-        try:
-            test_ai = JadveOpenAI(model=model, timeout=60)
-            response = test_ai.chat("Say 'Hello' in one word")
-            response_text = response
+    # # Ensure curl_cffi is installed
+    # print("-" * 80)
+    # print(f"{'Model':<50} {'Status':<10} {'Response'}")
+    # print("-" * 80)
+
+    # for model in JadveOpenAI.AVAILABLE_MODELS:
+    #     try:
+    #         test_ai = JadveOpenAI(model=model, timeout=60)
+    #         response = test_ai.chat("Say 'Hello' in one word")
+    #         response_text = response
             
-            if response_text and len(response_text.strip()) > 0:
-                status = "✓"
-                # Truncate response if too long
-                display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
-            else:
-                status = "✗"
-                display_text = "Empty or invalid response"
-            print(f"{model:<50} {status:<10} {display_text}")
-        except Exception as e:
-            print(f"{model:<50} {'✗':<10} {str(e)}")
+    #         if response_text and len(response_text.strip()) > 0:
+    #             status = "✓"
+    #             # Truncate response if too long
+    #             display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
+    #         else:
+    #             status = "✗"
+    #             display_text = "Empty or invalid response"
+    #         print(f"{model:<50} {status:<10} {display_text}")
+    #     except Exception as e:
+    #         print(f"{model:<50} {'✗':<10} {str(e)}")
+    from rich import print
+    ai = JadveOpenAI()
+    response = ai.chat("tell me about humans", stream=True, raw=False)
+    for chunk in response:
+        print(chunk, end='', flush=True)

webscout/Provider/MiniMax.py

@@ -0,0 +1,207 @@
+import os
+import json
+import requests
+from typing import Any, Dict, Optional, Union, Generator
+from webscout.AIutel import sanitize_stream, Optimizers, Conversation, AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+
+class MiniMax(Provider):
+    """
+    Provider for MiniMax-Reasoning-01 API, following the standard provider interface.
+    """
+    AVAILABLE_MODELS = ["MiniMax-Reasoning-01"]
+    API_URL = "https://api.minimaxi.chat/v1/text/chatcompletion_v2"
+    # TODO: Move API_KEY to env/config for security
+    API_KEY = os.environ.get("MINIMAX_API_KEY") or """eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJHcm91cE5hbWUiOiJtbyBuaSIsIlVzZXJOYW1lIjoibW8gbmkiLCJBY2NvdW50IjoiIiwiU3ViamVjdElEIjoiMTg3NjIwMDY0ODA2NDYzNTI0MiIsIlBob25lIjoiIiwiR3JvdXBJRCI6IjE4NzYyMDA2NDgwNjA0NDA5MzgiLCJQYWdlTmFtZSI6IiIsIk1haWwiOiJuaW1vQHN1YnN1cC52aXAiLCJDcmVhdGVUaW1lIjoiMjAyNS0wMS0wNyAxMToyNzowNyIsIlRva2VuVHlwZSI6MSwiaXNzIjoibWluaW1heCJ9.Ge1ZnpFPUfXVdMini0P_qXbP_9VYwzXiffG9DsNQck4GtYEOs33LDeAiwrVsrrLZfvJ2icQZ4sRZS54wmPuWua_Dav6pYJty8ZtahmUX1IuhlUX5YErhhCRAIy3J1xB8FkLHLyylChuBHpkNz6O6BQLmPqmoa-cOYK9Qrc6IDeu8SX1iMzO9-MSkcWNvkvpCF2Pf9tekBVWNKMDK6IZoMEPbtkaPXdDyP6l0M0e2AlL_E0oM9exg3V-ohAi8OTPFyqM6dcd4TwF-b9DULxfIsRFw401mvIxcTDWa42u2LULewdATVRD2BthU65tuRqEiWeFWMvFlPj2soMze_QIiUA"""
+    MODEL_CONTROL_DEFAULTS = {"tokens_to_generate": 40000, "temperature": 1, "top_p": 0.95}
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 2049,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = "MiniMax-Reasoning-01",
+        system_prompt: str = "You are a helpful assistant, always respond in english",
+    ):
+        if model not in self.AVAILABLE_MODELS:
+            raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
+        self.model = model
+        self.api_url = self.API_URL
+        self.api_key = self.API_KEY
+        self.timeout = timeout
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.last_response = {}
+        self.system_prompt = system_prompt
+        self.proxies = proxies
+        self.__available_optimizers = tuple(
+            method for method in dir(Optimizers)
+            if callable(getattr(Optimizers, method)) and not method.startswith("__")
+        )
+        Conversation.intro = (
+            AwesomePrompts().get_act(
+                act, raise_not_found=True, default=None, case_insensitive=True
+            )
+            if act
+            else intro or Conversation.intro
+        )
+        self.conversation = Conversation(
+            is_conversation, self.max_tokens_to_sample, filepath, update_file
+        )
+        self.conversation.history_offset = history_offset
+
+    @staticmethod
+    def _extract_content(chunk: Any) -> Optional[dict]:
+        if not isinstance(chunk, dict):
+            return None
+        choice = chunk.get('choices', [{}])[0]
+        delta = choice.get('delta', {})
+        content = delta.get('content')
+        reasoning = delta.get('reasoning_content')
+        result = {}
+        if content:
+            result['content'] = content
+        if reasoning:
+            result['reasoning_content'] = reasoning
+        return result if result else None
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = True,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Union[Dict[str, Any], Generator]:
+        conversation_prompt = self.conversation.gen_complete_prompt(prompt)
+        if optimizer:
+            if optimizer in self.__available_optimizers:
+                conversation_prompt = getattr(Optimizers, optimizer)(
+                    conversation_prompt if conversationally else prompt
+                )
+            else:
+                raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
+        messages = [
+            {'role': 'system', 'content': self.system_prompt},
+            {'role': 'user', 'content': conversation_prompt}
+        ]
+        data = {
+            'model': self.model,
+            'messages': messages,
+            'stream': True,
+            'max_tokens': self.MODEL_CONTROL_DEFAULTS.get('tokens_to_generate', 512),
+            'temperature': self.MODEL_CONTROL_DEFAULTS.get('temperature', 1.0),
+            'top_p': self.MODEL_CONTROL_DEFAULTS.get('top_p', 1.0),
+        }
+        headers = {
+            'Content-Type': 'application/json',
+            'Authorization': f'Bearer {self.api_key}',
+        }
+        def for_stream():
+            try:
+                response = requests.post(
+                    self.api_url,
+                    headers=headers,
+                    data=json.dumps(data),
+                    stream=True,
+                    timeout=self.timeout,
+                    proxies=self.proxies if self.proxies else None
+                )
+                if not response.ok:
+                    raise exceptions.FailedToGenerateResponseError(
+                        f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
+                    )
+                streaming_response = ""
+                last_content = ""
+                last_reasoning = ""
+                in_think = False
+                processed_stream = sanitize_stream(
+                    response.iter_lines(),
+                    intro_value="data:",
+                    to_json=True,
+                    content_extractor=self._extract_content,
+                    raw=False # always process as dict for logic
+                )
+                for chunk in processed_stream:
+                    if not chunk:
+                        continue
+                    content = chunk.get('content') if isinstance(chunk, dict) else None
+                    reasoning = chunk.get('reasoning_content') if isinstance(chunk, dict) else None
+                    # Handle reasoning_content with <think> tags
+                    if reasoning and reasoning != last_reasoning:
+                        if not in_think:
+                            yield "<think>\n\n"
+                            in_think = True
+                        yield reasoning
+                        last_reasoning = reasoning
+                    # If we were in <think> and now have new content, close <think>
+                    if in_think and content and content != last_content:
+                        yield "</think>\n\n"
+                        in_think = False
+                    # Handle normal content
+                    if content and content != last_content:
+                        yield content
+                        streaming_response += content
+                        last_content = content
+                if not raw:
+                    self.last_response = {"text": streaming_response}
+                    self.conversation.update_chat_history(prompt, streaming_response)
+            except Exception as e:
+                raise exceptions.FailedToGenerateResponseError(f"Request failed: {e}")
+        def for_non_stream():
+            full_response = ""
+            for chunk in for_stream():
+                if isinstance(chunk, dict) and "text" in chunk:
+                    full_response += chunk["text"]
+                elif isinstance(chunk, str):
+                    full_response += chunk
+            if not raw:
+                self.last_response = {"text": full_response}
+                self.conversation.update_chat_history(prompt, full_response)
+                return {"text": full_response}
+            else:
+                return full_response
+        return for_stream() if stream else for_non_stream()
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = True,
+        optimizer: str = None,
+        conversationally: bool = False,
+        raw: bool = False,
+    ) -> Union[str, Generator[str, None, None]]:
+        def for_stream():
+            for response in self.ask(
+                prompt, stream=True, raw=raw, optimizer=optimizer, conversationally=conversationally
+            ):
+                if raw:
+                    yield response
+                else:
+                    yield response
+        def for_non_stream():
+            result = self.ask(
+                prompt, stream=False, raw=raw, optimizer=optimizer, conversationally=conversationally
+            )
+            if raw:
+                return result
+            else:
+                return self.get_message(result)
+        return for_stream() if stream else for_non_stream()
+
+    def get_message(self, response: dict) -> str:
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response.get("text", "")
+
+if __name__ == "__main__":
+    ai = MiniMax()
+    resp = ai.chat("What is the capital of France?", stream=True, raw=False)
+    for chunk in resp:
+        print(chunk, end="", flush=True)