webscout 8.2.8__py3-none-any.whl → 8.2.9__py3-none-any.whl

webscout/Provider/OPENAI/BLACKBOXAI.py

@@ -1,735 +1,766 @@
-import requests
-import random
-import string
-import base64
-from datetime import datetime, timedelta
-from typing import List, Dict, Optional, Any
-import json
-import uuid
-import time
-
-# Import base classes and utility structures
-from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
-from .utils import (
-    ChatCompletion, Choice,
-    ChatCompletionMessage, CompletionUsage
-)
-
-
-def to_data_uri(image_data):
-    """Convert image data to a data URI format"""
-    if isinstance(image_data, str):
-        # Assume it's already a data URI
-        return image_data
-
-    # Encode binary data to base64
-    encoded = base64.b64encode(image_data).decode('utf-8')
-
-    # Determine MIME type (simplified)
-    mime_type = "image/jpeg"  # Default
-    if image_data.startswith(b'\x89PNG'):
-        mime_type = "image/png"
-    elif image_data.startswith(b'\xff\xd8'):
-        mime_type = "image/jpeg"
-    elif image_data.startswith(b'GIF'):
-        mime_type = "image/gif"
-
-    return f"data:{mime_type};base64,{encoded}"
-
-
-class Completions(BaseCompletions):
-    def __init__(self, client: 'BLACKBOXAI'):
-        self._client = client
-
-    def create(
-        self,
-        *,
-        model: str,
-        messages: List[Dict[str, Any]],
-        max_tokens: Optional[int] = None,
-        stream: bool = False,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        **kwargs: Any
-    ) -> ChatCompletion:
-        """
-        Create a chat completion with BlackboxAI API.
-
-        Args:
-            model: The model to use (from AVAILABLE_MODELS)
-            messages: List of message dictionaries with 'role' and 'content'
-            max_tokens: Maximum number of tokens to generate
-            stream: If True, raises an error as streaming is not supported
-            temperature: Sampling temperature (0-1)
-            top_p: Nucleus sampling parameter (0-1)
-            **kwargs: Additional parameters to pass to the API
-
-        Returns:
-            Returns a ChatCompletion object
-        """
-        # Check if streaming is requested and raise an error
-        if stream:
-            raise ValueError("Streaming is not supported by the BLACKBOXAI provider. Please use stream=False.")
-
-        # Generate request ID and timestamp
-        request_id = str(uuid.uuid4())
-        created_time = int(time.time())
-
-        # Extract system message if present
-        system_message = "You are a helpful AI assistant."
-        for msg in messages:
-            if msg.get("role") == "system":
-                system_message = msg.get("content")
-                break
-
-        # Look for any image content
-        media = []
-        for msg in messages:
-            if msg.get("role") == "user":
-                # Check for image attachments in content
-                content = msg.get("content", [])
-                if isinstance(content, list):
-                    for item in content:
-                        if isinstance(item, dict) and item.get("type") == "image_url":
-                            image_url = item.get("image_url", {})
-                            if isinstance(image_url, dict) and "url" in image_url:
-                                url = image_url["url"]
-                                if url.startswith("data:"):
-                                    # It's already a data URI
-                                    image_name = f"image_{len(media)}.png"
-                                    media.append((url, image_name))
-                                else:
-                                    # Need to fetch and convert to data URI
-                                    try:
-                                        image_response = requests.get(url)
-                                        if image_response.ok:
-                                            image_name = f"image_{len(media)}.png"
-                                            media.append((image_response.content, image_name))
-                                    except Exception as e:
-                                        pass
-
-        # Use non-streaming implementation
-        return self._create_non_streaming(
-            request_id=request_id,
-            created_time=created_time,
-            model=model,
-            messages=messages,
-            system_message=system_message,
-            max_tokens=max_tokens,
-            temperature=temperature,
-            top_p=top_p,
-            media=media
-        )
-
-
-
-    def _create_non_streaming(
-        self,
-        *,
-        request_id: str,
-        created_time: int,
-        model: str,
-        messages: List[Dict[str, Any]],
-        system_message: str,
-        max_tokens: Optional[int] = None,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        media: List = None
-    ) -> ChatCompletion:
-        """Implementation for non-streaming chat completions."""
-        try:
-            # Prepare user messages for BlackboxAI API format
-            blackbox_messages = []
-            for i, msg in enumerate(messages):
-                if msg["role"] == "system":
-                    continue  # System message handled separately
-
-                msg_id = self._client.generate_id() if i > 0 else request_id
-                blackbox_messages.append({
-                    "id": msg_id,
-                    "content": msg["content"],
-                    "role": msg["role"]
-                })
-
-            # Add image data if provided
-            if media and blackbox_messages:
-                blackbox_messages[-1]['data'] = {
-                    "imagesData": [
-                        {
-                            "filePath": f"/",
-                            "contents": to_data_uri(image)
-                        } for image in media
-                    ],
-                    "fileText": "",
-                    "title": ""
-                }
-
-            # Generate request payload with session
-            request_email = f"{self._client.generate_random_string(8)}@blackbox.ai"
-            session_data = self._client.generate_session(request_email)
-
-            # Create the API request payload
-            payload = self._client.create_request_payload(
-                messages=blackbox_messages,
-                chat_id=request_id,
-                system_message=system_message,
-                max_tokens=max_tokens,
-                temperature=temperature,
-                top_p=top_p,
-                session_data=session_data,
-                model=model
-            )
-
-            # Make the API request with cookies
-            response = self._client.session.post(
-                self._client.api_endpoint,
-                json=payload,
-                headers=self._client.headers,
-                cookies=self._client.cookies,
-                timeout=self._client.timeout
-            )
-
-            # Process the response
-            full_content = ""
-            if response.status_code == 200:
-                # Extract content from response text
-                response_text = response.text
-
-                # Handle possible SSE format in response
-                if "data: " in response_text:
-                    # Extract content from SSE format
-                    content_lines = []
-                    for line in response_text.split('\n'):
-                        if line.startswith("data: "):
-                            line = line[6:].strip()
-                            if line and not any(error_msg in line.lower() for error_msg in [
-                                "service has been suspended",
-                                "api request failed",
-                                "you have reached your request limit"
-                            ]):
-                                content_lines.append(line)
-                    full_content = "".join(content_lines)
-                else:
-                    # Regular response
-                    full_content = response_text
-            else:
-                # Handle error response
-                raise IOError(f"BlackboxAI request failed with status code {response.status_code}")
-
-            # Create the completion message
-            message = ChatCompletionMessage(
-                role="assistant",
-                content=full_content
-            )
-
-            # Create the choice with the message
-            choice = Choice(
-                index=0,
-                message=message,
-                finish_reason="stop"
-            )
-
-            # Estimate token usage
-            prompt_tokens = sum(len(str(msg.get("content", ""))) // 4 for msg in messages)
-            completion_tokens = len(full_content) // 4
-
-            # Create the final completion object
-            completion = ChatCompletion(
-                id=request_id,
-                choices=[choice],
-                created=created_time,
-                model=model,
-                usage=CompletionUsage(
-                    prompt_tokens=prompt_tokens,
-                    completion_tokens=completion_tokens,
-                    total_tokens=prompt_tokens + completion_tokens
-                )
-            )
-
-            return completion
-
-        except Exception as e:
-            raise IOError(f"BlackboxAI request failed: {str(e)}") from e
-
-
-class Chat(BaseChat):
-    def __init__(self, client: 'BLACKBOXAI'):
-        self.completions = Completions(client)
-
-
-class BLACKBOXAI(OpenAICompatibleProvider):
-    """
-    OpenAI-compatible client for BlackboxAI API.
-
-    Usage:
-        client = BLACKBOXAI()
-        response = client.chat.completions.create(
-            model="GPT-4.1",
-            messages=[{"role": "user", "content": "Hello!"}]
-        )
-        print(response.choices[0].message.content)
-    """
-    # Default model
-    default_model = "GPT-4.1"
-    default_vision_model = default_model
-    api_endpoint = "https://www.blackbox.ai/api/chat"
-    timeout = 30
-
-
-    # Default model (remains the same as per original class)
-    default_model = "GPT-4.1"
-    default_vision_model = default_model
-
-    # New OpenRouter models list
-    openrouter_models = [
-        "Deepcoder 14B Preview",
-        "DeepHermes 3 Llama 3 8B Preview",
-        "DeepSeek R1 Zero",
-        "Dolphin3.0 Mistral 24B",
-        "Dolphin3.0 R1 Mistral 24B",
-        "Flash 3",
-        "Gemini 2.0 Flash Experimental",
-        "Gemma 2 9B",
-        "Gemma 3 12B",
-        "Gemma 3 1B",
-        "Gemma 3 27B",
-        "Gemma 3 4B",
-        "Kimi VL A3B Thinking",
-        "Llama 3.1 8B Instruct",
-        "Llama 3.1 Nemotron Ultra 253B v1",
-        "Llama 3.2 11B Vision Instruct",
-        "Llama 3.2 1B Instruct",
-        "Llama 3.2 3B Instruct",
-        "Llama 3.3 70B Instruct",
-        "Llama 3.3 Nemotron Super 49B v1",
-        "Llama 4 Maverick",
-        "Llama 4 Scout",
-        "Mistral 7B Instruct",
-        "Mistral Nemo",
-        "Mistral Small 3",
-        "Mistral Small 3.1 24B",
-        "Molmo 7B D",
-        "Moonlight 16B A3B Instruct",
-        "Qwen2.5 72B Instruct",
-        "Qwen2.5 7B Instruct",
-        "Qwen2.5 Coder 32B Instruct",
-        "Qwen2.5 VL 32B Instruct",
-        "Qwen2.5 VL 3B Instruct",
-        "Qwen2.5 VL 72B Instruct",
-        "Qwen2.5-VL 7B Instruct",
-        "Qwerky 72B",
-        "QwQ 32B",
-        "QwQ 32B Preview",
-        "QwQ 32B RpR v1",
-        "R1",
-        "R1 Distill Llama 70B",
-        "R1 Distill Qwen 14B",
-        "R1 Distill Qwen 32B",
-    ]
-
-    # New base models list
-    models = [
-        default_model,
-        "o3-mini",
-        "gpt-4.1-nano",
-        "Claude-sonnet-3.7",
-        "Claude-sonnet-3.5",
-        "DeepSeek-R1",
-        "Mistral-Small-24B-Instruct-2501",
-        *openrouter_models,
-        # Trending agent modes (names)
-        'Python Agent', 'HTML Agent', 'Builder Agent', 'Java Agent', 'JavaScript Agent',
-        'React Agent', 'Android Agent', 'Flutter Agent', 'Next.js Agent', 'AngularJS Agent',
-        'Swift Agent', 'MongoDB Agent', 'PyTorch Agent', 'Xcode Agent', 'Azure Agent',
-        'Bitbucket Agent', 'DigitalOcean Agent', 'Docker Agent', 'Electron Agent',
-        'Erlang Agent', 'FastAPI Agent', 'Firebase Agent', 'Flask Agent', 'Git Agent',
-        'Gitlab Agent', 'Go Agent', 'Godot Agent', 'Google Cloud Agent', 'Heroku Agent'
-    ]
-
-    # Models that support vision capabilities
-    vision_models = [default_vision_model, 'o3-mini', "Llama 3.2 11B Vision Instruct"] # Added Llama vision
-
-    # Models that can be directly selected by users
-    userSelectedModel = ['o3-mini','Claude-sonnet-3.7', 'Claude-sonnet-3.5', 'DeepSeek-R1', 'Mistral-Small-24B-Instruct-2501'] + openrouter_models
-
-    # Agent mode configurations
-    agentMode = {
-        # OpenRouter Free
-        'Deepcoder 14B Preview': {'mode': True, 'id': "agentica-org/deepcoder-14b-preview:free", 'name': "Deepcoder 14B Preview"},
-        'DeepHermes 3 Llama 3 8B Preview': {'mode': True, 'id': "nousresearch/deephermes-3-llama-3-8b-preview:free", 'name': "DeepHermes 3 Llama 3 8B Preview"},
-        'DeepSeek R1 Zero': {'mode': True, 'id': "deepseek/deepseek-r1-zero:free", 'name': "DeepSeek R1 Zero"},
-        'Dolphin3.0 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-mistral-24b:free", 'name': "Dolphin3.0 Mistral 24B"},
-        'Dolphin3.0 R1 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-r1-mistral-24b:free", 'name': "Dolphin3.0 R1 Mistral 24B"},
-        'Flash 3': {'mode': True, 'id': "rekaai/reka-flash-3:free", 'name': "Flash 3"},
-        'Gemini 2.0 Flash Experimental': {'mode': True, 'id': "google/gemini-2.0-flash-exp:free", 'name': "Gemini 2.0 Flash Experimental"},
-        'Gemma 2 9B': {'mode': True, 'id': "google/gemma-2-9b-it:free", 'name': "Gemma 2 9B"},
-        'Gemma 3 12B': {'mode': True, 'id': "google/gemma-3-12b-it:free", 'name': "Gemma 3 12B"},
-        'Gemma 3 1B': {'mode': True, 'id': "google/gemma-3-1b-it:free", 'name': "Gemma 3 1B"},
-        'Gemma 3 27B': {'mode': True, 'id': "google/gemma-3-27b-it:free", 'name': "Gemma 3 27B"},
-        'Gemma 3 4B': {'mode': True, 'id': "google/gemma-3-4b-it:free", 'name': "Gemma 3 4B"},
-        'Kimi VL A3B Thinking': {'mode': True, 'id': "moonshotai/kimi-vl-a3b-thinking:free", 'name': "Kimi VL A3B Thinking"},
-        'Llama 3.1 8B Instruct': {'mode': True, 'id': "meta-llama/llama-3.1-8b-instruct:free", 'name': "Llama 3.1 8B Instruct"},
-        'Llama 3.1 Nemotron Ultra 253B v1': {'mode': True, 'id': "nvidia/llama-3.1-nemotron-ultra-253b-v1:free", 'name': "Llama 3.1 Nemotron Ultra 253B v1"},
-        'Llama 3.2 11B Vision Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-11b-vision-instruct:free", 'name': "Llama 3.2 11B Vision Instruct"},
-        'Llama 3.2 1B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-1b-instruct:free", 'name': "Llama 3.2 1B Instruct"},
-        'Llama 3.2 3B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-3b-instruct:free", 'name': "Llama 3.2 3B Instruct"},
-        'Llama 3.3 70B Instruct': {'mode': True, 'id': "meta-llama/llama-3.3-70b-instruct:free", 'name': "Llama 3.3 70B Instruct"},
-        'Llama 3.3 Nemotron Super 49B v1': {'mode': True, 'id': "nvidia/llama-3.3-nemotron-super-49b-v1:free", 'name': "Llama 3.3 Nemotron Super 49B v1"},
-        'Llama 4 Maverick': {'mode': True, 'id': "meta-llama/llama-4-maverick:free", 'name': "Llama 4 Maverick"},
-        'Llama 4 Scout': {'mode': True, 'id': "meta-llama/llama-4-scout:free", 'name': "Llama 4 Scout"},
-        'Mistral 7B Instruct': {'mode': True, 'id': "mistralai/mistral-7b-instruct:free", 'name': "Mistral 7B Instruct"},
-        'Mistral Nemo': {'mode': True, 'id': "mistralai/mistral-nemo:free", 'name': "Mistral Nemo"},
-        'Mistral Small 3': {'mode': True, 'id': "mistralai/mistral-small-24b-instruct-2501:free", 'name': "Mistral Small 3"}, # Matches Mistral-Small-24B-Instruct-2501
-        'Mistral Small 3.1 24B': {'mode': True, 'id': "mistralai/mistral-small-3.1-24b-instruct:free", 'name': "Mistral Small 3.1 24B"},
-        'Molmo 7B D': {'mode': True, 'id': "allenai/molmo-7b-d:free", 'name': "Molmo 7B D"},
-        'Moonlight 16B A3B Instruct': {'mode': True, 'id': "moonshotai/moonlight-16b-a3b-instruct:free", 'name': "Moonlight 16B A3B Instruct"},
-        'Qwen2.5 72B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-72b-instruct:free", 'name': "Qwen2.5 72B Instruct"},
-        'Qwen2.5 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-7b-instruct:free", 'name': "Qwen2.5 7B Instruct"},
-        'Qwen2.5 Coder 32B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-coder-32b-instruct:free", 'name': "Qwen2.5 Coder 32B Instruct"},
-        'Qwen2.5 VL 32B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-32b-instruct:free", 'name': "Qwen2.5 VL 32B Instruct"},
-        'Qwen2.5 VL 3B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-3b-instruct:free", 'name': "Qwen2.5 VL 3B Instruct"},
-        'Qwen2.5 VL 72B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-72b-instruct:free", 'name': "Qwen2.5 VL 72B Instruct"},
-        'Qwen2.5-VL 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-vl-7b-instruct:free", 'name': "Qwen2.5-VL 7B Instruct"},
-        'Qwerky 72B': {'mode': True, 'id': "featherless/qwerky-72b:free", 'name': "Qwerky 72B"},
-        'QwQ 32B': {'mode': True, 'id': "qwen/qwq-32b:free", 'name': "QwQ 32B"},
-        'QwQ 32B Preview': {'mode': True, 'id': "qwen/qwq-32b-preview:free", 'name': "QwQ 32B Preview"},
-        'QwQ 32B RpR v1': {'mode': True, 'id': "arliai/qwq-32b-arliai-rpr-v1:free", 'name': "QwQ 32B RpR v1"},
-        'R1': {'mode': True, 'id': "deepseek/deepseek-r1:free", 'name': "R1"}, # Matches DeepSeek-R1
-        'R1 Distill Llama 70B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-llama-70b:free", 'name': "R1 Distill Llama 70B"},
-        'R1 Distill Qwen 14B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-14b:free", 'name': "R1 Distill Qwen 14B"},
-        'R1 Distill Qwen 32B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-32b:free", 'name': "R1 Distill Qwen 32B"},
-        # Default models from the new list
-        'Claude-sonnet-3.7': {'mode': True, 'id': "Claude-sonnet-3.7", 'name': "Claude-sonnet-3.7"},
-        'Claude-sonnet-3.5': {'mode': True, 'id': "Claude-sonnet-3.5", 'name': "Claude-sonnet-3.5"},
-        'DeepSeek-R1': {'mode': True, 'id': "deepseek-reasoner", 'name': "DeepSeek-R1"}, # This is 'R1' in openrouter, but 'DeepSeek-R1' in base models
-        'Mistral-Small-24B-Instruct-2501': {'mode': True, 'id': "mistralai/Mistral-Small-24B-Instruct-2501", 'name': "Mistral-Small-24B-Instruct-2501"},
-        # Add default_model if it's not covered and has an agent mode
-        default_model: {'mode': True, 'id': "openai/gpt-4.1", 'name': default_model}, # Assuming GPT-4.1 is agent-compatible
-        'o3-mini': {'mode': True, 'id': "o3-mini", 'name': "o3-mini"}, # Assuming o3-mini is agent-compatible
-        'gpt-4.1-nano': {'mode': True, 'id': "gpt-4.1-nano", 'name': "gpt-4.1-nano"}, # Assuming gpt-4.1-nano is agent-compatible
-    }
-
-    # Trending agent modes
-    trendingAgentMode = {
-        'Python Agent': {'mode': True, 'id': "python"},
-        'HTML Agent': {'mode': True, 'id': "html"},
-        'Builder Agent': {'mode': True, 'id': "builder"},
-        'Java Agent': {'mode': True, 'id': "java"},
-        'JavaScript Agent': {'mode': True, 'id': "javascript"},
-        'React Agent': {'mode': True, 'id': "react"},
-        'Android Agent': {'mode': True, 'id': "android"},
-        'Flutter Agent': {'mode': True, 'id': "flutter"},
-        'Next.js Agent': {'mode': True, 'id': "next.js"},
-        'AngularJS Agent': {'mode': True, 'id': "angularjs"},
-        'Swift Agent': {'mode': True, 'id': "swift"},
-        'MongoDB Agent': {'mode': True, 'id': "mongodb"},
-        'PyTorch Agent': {'mode': True, 'id': "pytorch"},
-        'Xcode Agent': {'mode': True, 'id': "xcode"},
-        'Azure Agent': {'mode': True, 'id': "azure"},
-        'Bitbucket Agent': {'mode': True, 'id': "bitbucket"},
-        'DigitalOcean Agent': {'mode': True, 'id': "digitalocean"},
-        'Docker Agent': {'mode': True, 'id': "docker"},
-        'Electron Agent': {'mode': True, 'id': "electron"},
-        'Erlang Agent': {'mode': True, 'id': "erlang"},
-        'FastAPI Agent': {'mode': True, 'id': "fastapi"},
-        'Firebase Agent': {'mode': True, 'id': "firebase"},
-        'Flask Agent': {'mode': True, 'id': "flask"},
-        'Git Agent': {'mode': True, 'id': "git"},
-        'Gitlab Agent': {'mode': True, 'id': "gitlab"},
-        'Go Agent': {'mode': True, 'id': "go"},
-        'Godot Agent': {'mode': True, 'id': "godot"},
-        'Google Cloud Agent': {'mode': True, 'id': "googlecloud"},
-        'Heroku Agent': {'mode': True, 'id': "heroku"},
-    }
-
-    # Create a list of all model aliases
-    _all_model_aliases = list(dict.fromkeys([
-        # Add all model aliases
-        "gpt-4", "gpt-4.1", "gpt-4o", "gpt-4o-mini",
-        "claude-3.7-sonnet", "claude-3.5-sonnet",
-        "deepcoder-14b", "deephermes-3-8b", "deepseek-r1-zero", "deepseek-r1",
-        "dolphin-3.0-24b", "dolphin-3.0-r1-24b", "reka-flash", "gemini-2.0-flash",
-        "gemma-2-9b", "gemma-3-12b", "gemma-3-1b", "gemma-3-27b", "gemma-3-4b",
-        "kimi-vl-a3b-thinking", "llama-3.1-8b", "nemotron-253b", "llama-3.2-11b",
-        "llama-3.2-1b", "llama-3.2-3b", "llama-3.3-70b", "nemotron-49b",
-        "llama-4-maverick", "llama-4-scout", "mistral-7b", "mistral-nemo",
-        "mistral-small-24b", "mistral-small-24b-instruct-2501", "mistral-small-3.1-24b",
-        "molmo-7b", "moonlight-16b", "qwen-2.5-72b", "qwen-2.5-7b", "qwen-2.5-coder-32b",
-        "qwen-2.5-vl-32b", "qwen-2.5-vl-3b", "qwen-2.5-vl-72b", "qwen-2.5-vl-7b",
-        "qwerky-72b", "qwq-32b", "qwq-32b-preview", "qwq-32b-arliai",
-        "deepseek-r1-distill-llama-70b", "deepseek-r1-distill-qwen-14b", "deepseek-r1-distill-qwen-32b",
-        # Add base models
-        "o3-mini", "gpt-4.1-nano"
-    ]))
-
-    # Create AVAILABLE_MODELS as a list with the format "BLACKBOXAI/model"
-    AVAILABLE_MODELS = [f"BLACKBOXAI/{name}" for name in _all_model_aliases]
-
-    # Create a mapping dictionary for internal use
-    _model_mapping = {name: f"BLACKBOXAI/{name}" for name in _all_model_aliases}
-
-
-    # Model aliases for easier reference
-    model_aliases = {
-        "gpt-4": default_model, # default_model is "GPT-4.1"
-        "gpt-4.1": default_model,
-        "gpt-4o": default_model, # Defaulting to GPT-4.1 as per previous logic if specific GPT-4o handling isn't defined elsewhere
-        "gpt-4o-mini": default_model, # Defaulting
-        "claude-3.7-sonnet": "Claude-sonnet-3.7",
-        "claude-3.5-sonnet": "Claude-sonnet-3.5",
-        # "deepseek-r1": "DeepSeek-R1", # This is in base models, maps to R1 or DeepSeek R1 Zero in agentMode
-        #
-        "deepcoder-14b": "Deepcoder 14B Preview",
-        "deephermes-3-8b": "DeepHermes 3 Llama 3 8B Preview",
-        "deepseek-r1-zero": "DeepSeek R1 Zero",
-        "deepseek-r1": "R1", # Alias for R1 (which is deepseek/deepseek-r1:free)
-        "dolphin-3.0-24b": "Dolphin3.0 Mistral 24B",
-        "dolphin-3.0-r1-24b": "Dolphin3.0 R1 Mistral 24B",
-        "reka-flash": "Flash 3",
-        "gemini-2.0-flash": "Gemini 2.0 Flash Experimental",
-        "gemma-2-9b": "Gemma 2 9B",
-        "gemma-3-12b": "Gemma 3 12B",
-        "gemma-3-1b": "Gemma 3 1B",
-        "gemma-3-27b": "Gemma 3 27B",
-        "gemma-3-4b": "Gemma 3 4B",
-        "kimi-vl-a3b-thinking": "Kimi VL A3B Thinking",
-        "llama-3.1-8b": "Llama 3.1 8B Instruct",
-        "nemotron-253b": "Llama 3.1 Nemotron Ultra 253B v1",
-        "llama-3.2-11b": "Llama 3.2 11B Vision Instruct",
-        "llama-3.2-1b": "Llama 3.2 1B Instruct",
-        "llama-3.2-3b": "Llama 3.2 3B Instruct",
-        "llama-3.3-70b": "Llama 3.3 70B Instruct",
-        "nemotron-49b": "Llama 3.3 Nemotron Super 49B v1",
-        "llama-4-maverick": "Llama 4 Maverick",
-        "llama-4-scout": "Llama 4 Scout",
-        "mistral-7b": "Mistral 7B Instruct",
-        "mistral-nemo": "Mistral Nemo",
-        "mistral-small-24b": "Mistral Small 3", # Alias for "Mistral Small 3"
-        "mistral-small-24b-instruct-2501": "Mistral-Small-24B-Instruct-2501", # Specific name
-        "mistral-small-3.1-24b": "Mistral Small 3.1 24B",
-        "molmo-7b": "Molmo 7B D",
-        "moonlight-16b": "Moonlight 16B A3B Instruct",
-        "qwen-2.5-72b": "Qwen2.5 72B Instruct",
-        "qwen-2.5-7b": "Qwen2.5 7B Instruct",
-        "qwen-2.5-coder-32b": "Qwen2.5 Coder 32B Instruct",
-        "qwen-2.5-vl-32b": "Qwen2.5 VL 32B Instruct",
-        "qwen-2.5-vl-3b": "Qwen2.5 VL 3B Instruct",
-        "qwen-2.5-vl-72b": "Qwen2.5 VL 72B Instruct",
-        "qwen-2.5-vl-7b": "Qwen2.5-VL 7B Instruct",
-        "qwerky-72b": "Qwerky 72B",
-        "qwq-32b": "QwQ 32B",
-        "qwq-32b-preview": "QwQ 32B Preview",
-        "qwq-32b-arliai": "QwQ 32B RpR v1",
-        "deepseek-r1-distill-llama-70b": "R1 Distill Llama 70B",
-        "deepseek-r1-distill-qwen-14b": "R1 Distill Qwen 14B",
-        "deepseek-r1-distill-qwen-32b": "R1 Distill Qwen 32B",
-    }
-
-    def __init__(
-        self,
-        proxies: dict = {}
-    ):
-        """
-        Initialize the BlackboxAI provider with OpenAI compatibility.
-
-        Args:
-            proxies: Optional proxy configuration
-        """
-        # Initialize session
-        self.session = requests.Session()
-
-        # Set headers based on GitHub reference
-        self.headers = {
-            'Accept': 'text/event-stream',
-            'Accept-Encoding': 'gzip, deflate, br, zstd',
-            'Accept-Language': 'en-US,en;q=0.9,en-IN;q=0.8',
-            'Content-Type': 'application/json',
-            'DNT': '1',
-            'Origin': 'https://www.blackbox.ai',
-            'Referer': 'https://www.blackbox.ai/',
-            'Sec-CH-UA': '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
-            'Sec-CH-UA-Mobile': '?0',
-            'Sec-CH-UA-Platform': '"Windows"',
-            'Sec-Fetch-Dest': 'empty',
-            'Sec-Fetch-Mode': 'cors',
-            'Sec-Fetch-Site': 'same-origin',
-            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36'
-        }
-
-        # Set cookies for the session
-        self.cookies = {
-            'cfzs_amplitude': self.generate_id(32),
-            'cfz_amplitude': self.generate_id(32),
-            '__cf_bm': self.generate_id(32),
-        }
-
-        # Set proxies if provided
-        self.session.proxies = proxies
-
-        # Initialize chat interface with completions
-        self.chat = Chat(self)
-
-    @property
-    def models(self):
-        class _ModelList:
-            def list(inner_self):
-                return type(self).AVAILABLE_MODELS
-        return _ModelList()
-
-
-    @classmethod
-    def get_model(cls, model: str) -> str:
-        """Resolve model name from alias."""
-        # Remove BLACKBOXAI/ prefix if present
-        if model.startswith("BLACKBOXAI/"):
-            model = model[len("BLACKBOXAI/"):]
-
-        # Convert to lowercase for case-insensitive matching
-        model_lower = model.lower()
-
-        # Check aliases (case-insensitive)
-        for alias, target in cls.model_aliases.items():
-            if model_lower == alias.lower():
-                return target
-
-        # If the model is directly in available models (without the prefix), return it
-        for available_model in cls._all_model_aliases:
-            if model_lower == available_model.lower():
-                # Find the corresponding model in model_aliases or use the model directly
-                for alias, target in cls.model_aliases.items():
-                    if available_model.lower() == alias.lower():
-                        return target
-                return available_model
-
-        # If we get here, use the default model
-        return cls.default_model
-
-    @classmethod
-    def generate_random_string(cls, length: int = 8) -> str:
-        """Generate a random string of specified length."""
-        chars = string.ascii_lowercase + string.digits
-        return ''.join(random.choice(chars) for _ in range(length))
-
-    @classmethod
-    def generate_id(cls, length: int = 7) -> str:
-        """Generate a random ID of specified length."""
-        chars = string.ascii_letters + string.digits
-        return ''.join(random.choice(chars) for _ in range(length))
-
-    @classmethod
-    def generate_session(cls, email: str, id_length: int = 21, days_ahead: int = 30) -> dict:
-        """
-        Generate a dynamic session with proper ID and expiry format using a specific email.
-
-        Args:
-            email: The email to use for this session
-            id_length: Length of the numeric ID (default: 21)
-            days_ahead: Number of days ahead for expiry (default: 30)
-
-        Returns:
-            dict: A session dictionary with user information and expiry
-        """
-        # Generate a random name
-        first_names = ["Alex", "Jordan", "Taylor", "Morgan", "Casey", "Riley", "Avery", "Quinn", "Skyler", "Dakota"]
-        last_names = ["Smith", "Johnson", "Williams", "Brown", "Jones", "Miller", "Davis", "Garcia", "Rodriguez", "Wilson"]
-        name = f"{random.choice(first_names)} {random.choice(last_names)}"
-
-        # Generate numeric ID - using Google-like ID format
-        numeric_id = ''.join(random.choice('0123456789') for _ in range(id_length))
-
-        # Generate future expiry date
-        future_date = datetime.now() + timedelta(days=days_ahead)
-        expiry = future_date.strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
-
-        # Generate random image ID for the new URL format
-        chars = string.ascii_letters + string.digits + "-"
-        random_img_id = ''.join(random.choice(chars) for _ in range(48))
-        image_url = f"https://lh3.googleusercontent.com/a/ACg8oc{random_img_id}=s96-c"
-
-        return {
-            "user": {
-                "name": name,
-                "email": email,
-                "image": image_url,
-                "id": numeric_id
-            },
-            "expires": expiry,
-            "isNewUser": False
-        }
-
-    def create_request_payload(
-        self,
-        messages: List[Dict[str, Any]],
-        chat_id: str,
-        system_message: str,
-        max_tokens: int,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        session_data: Dict[str, Any] = None,
-        model: str = None
-    ) -> Dict[str, Any]:
-        """Create the full request payload for the BlackboxAI API."""
-        # Get the correct model ID and agent mode
-        model_name = self.get_model(model or self.default_model)
-        agent_mode = self.agentMode.get(model_name, {})
-
-        # Generate a random customer ID for the subscription
-        customer_id = "cus_" + ''.join(random.choice(string.ascii_letters + string.digits) for _ in range(14))
-
-        # Create the full request payload
-        return {
-            "messages": messages,
-            "agentMode": agent_mode,
-            "id": chat_id,
-            "previewToken": None,
-            "userId": None,
-            "codeModelMode": True,
-            "trendingAgentMode": {},
-            "isMicMode": False,
-            "userSystemPrompt": system_message,
-            "maxTokens": max_tokens,
-            "playgroundTopP": top_p,
-            "playgroundTemperature": temperature,
-            "isChromeExt": False,
-            "githubToken": "",
-            "clickedAnswer2": False,
-            "clickedAnswer3": False,
-            "clickedForceWebSearch": False,
-            "visitFromDelta": False,
-            "isMemoryEnabled": False,
-            "mobileClient": False,
-            "userSelectedModel": model_name if model_name in self.userSelectedModel else None,
-            "validated": "00f37b34-a166-4efb-bce5-1312d87f2f94",
-            "imageGenerationMode": False,
-            "webSearchModePrompt": False,
-            "deepSearchMode": False,
-            "designerMode": False,
-            "domains": None,
-            "vscodeClient": False,
-            "codeInterpreterMode": False,
-            "customProfile": {
-                "name": "",
-                "occupation": "",
-                "traits": [],
-                "additionalInfo": "",
-                "enableNewChats": False
-            },
-            "webSearchModeOption": {
-                "autoMode": True,
-                "webMode": False,
-                "offlineMode": False
-            },
-            "session": session_data,
-            "isPremium": True,
-            "subscriptionCache": {
-                "status": "PREMIUM",
-                "customerId": customer_id,
-                "expiryTimestamp": int((datetime.now() + timedelta(days=30)).timestamp()),
-                "lastChecked": int(datetime.now().timestamp() * 1000),
-                "isTrialSubscription": True
-            },
-            "beastMode": False,
-            "reasoningMode": False,
-            "designerMode": False,
-            "workspaceId": ""
-        }
+import requests
+import random
+import string
+import base64
+from datetime import datetime, timedelta
+from typing import Generator, List, Dict, Optional, Any, Union
+import json # Not used directly in this snippet, but often useful
+import uuid
+import time
+
+# Import base classes and utility structures
+from webscout.Provider.OPENAI.base import OpenAICompatibleProvider, BaseChat, BaseCompletions
+from webscout.Provider.OPENAI.utils import (
+    ChatCompletion, Choice,
+    ChatCompletionMessage, CompletionUsage, count_tokens,
+    ChatCompletionChunk, ChoiceDelta # Added for streaming return type
+)
+from webscout.litagent import LitAgent, agent
+agent = LitAgent()
+
+def to_data_uri(image_data):
+    """Convert image data to a data URI format"""
+    if isinstance(image_data, str):
+        # Assume it's already a data URI
+        return image_data
+
+    # Encode binary data to base64
+    encoded = base64.b64encode(image_data).decode('utf-8')
+
+    # Determine MIME type (simplified)
+    mime_type = "image/jpeg"  # Default
+    if image_data.startswith(b'\x89PNG'):
+        mime_type = "image/png"
+    elif image_data.startswith(b'\xff\xd8'):
+        mime_type = "image/jpeg"
+    elif image_data.startswith(b'GIF'):
+        mime_type = "image/gif"
+
+    return f"data:{mime_type};base64,{encoded}"
+
+
+class Completions(BaseCompletions):
+    def __init__(self, client: 'BLACKBOXAI'):
+        self._client = client
+
+    def create(
+        self,
+        *,
+        model: str,
+        messages: List[Dict[str, Any]],
+        max_tokens: Optional[int] = None,
+        stream: bool = False,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        **kwargs: Any
+    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
+        """
+        Create a chat completion with BlackboxAI API.
+
+        Args:
+            model: The model to use (from AVAILABLE_MODELS)
+            messages: List of message dictionaries with 'role' and 'content'
+            max_tokens: Maximum number of tokens to generate
+            stream: If True, yields streaming chunks
+            temperature: Sampling temperature (0-1)
+            top_p: Nucleus sampling parameter (0-1)
+            **kwargs: Additional parameters to pass to the API
+
+        Returns:
+            Returns a ChatCompletion object or a generator for streaming
+        """
+        # Generate request ID and timestamp
+        request_id = str(uuid.uuid4())
+        created_time = int(time.time())
+
+        # Extract system message if present
+        system_message = "You are a helpful AI assistant."
+        for msg in messages:
+            if msg.get("role") == "system":
+                system_message = msg.get("content")
+                break
+
+        # Look for any image content
+        media = []
+        for msg in messages:
+            if msg.get("role") == "user":
+                # Check for image attachments in content
+                content = msg.get("content", [])
+                if isinstance(content, list):
+                    for item in content:
+                        if isinstance(item, dict) and item.get("type") == "image_url":
+                            image_url = item.get("image_url", {})
+                            if isinstance(image_url, dict) and "url" in image_url:
+                                url = image_url["url"]
+                                if url.startswith("data:"):
+                                    # It's already a data URI
+                                    image_name = f"image_{len(media)}.png"
+                                    media.append((url, image_name))
+                                else:
+                                    # Need to fetch and convert to data URI
+                                    try:
+                                        image_response = requests.get(url)
+                                        if image_response.ok:
+                                            image_name = f"image_{len(media)}.png"
+                                            media.append((image_response.content, image_name))
+                                    except Exception as e:
+                                        pass
+
+        # Check if streaming is requested and raise an error
+        if stream:
+            return self._create_streaming(
+                request_id=request_id,
+                created_time=created_time,
+                model=model,
+                messages=messages,
+                system_message=system_message,
+                max_tokens=max_tokens,
+                temperature=temperature,
+                top_p=top_p,
+                media=media
+            )
+
+        # Use non-streaming implementation
+        return self._create_non_streaming(
+            request_id=request_id,
+            created_time=created_time,
+            model=model,
+            messages=messages,
+            system_message=system_message,
+            max_tokens=max_tokens,
+            temperature=temperature,
+            top_p=top_p,
+            media=media
+        )
+
+
+    def _create_non_streaming(
+        self,
+        *,
+        request_id: str,
+        created_time: int,
+        model: str,
+        messages: List[Dict[str, Any]],
+        system_message: str,
+        max_tokens: Optional[int] = None,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        media: List = None
+    ) -> ChatCompletion:
+        """Implementation for non-streaming chat completions."""
+        try:
+            # Prepare user messages for BlackboxAI API format
+            blackbox_messages = []
+            for i, msg in enumerate(messages):
+                if msg["role"] == "system":
+                    continue  # System message handled separately
+
+                msg_id = self._client.generate_id() if i > 0 else request_id
+                blackbox_messages.append({
+                    "id": msg_id,
+                    "content": msg["content"],
+                    "role": msg["role"]
+                })
+
+            # Add image data if provided
+            if media and blackbox_messages:
+                blackbox_messages[-1]['data'] = {
+                    "imagesData": [
+                        {
+                            "filePath": f"/",
+                            "contents": to_data_uri(image[0])
+                        } for image in media
+                    ],
+                    "fileText": "",
+                    "title": ""
+                }
+
+            # Generate request payload with session
+            request_email = f"{self._client.generate_random_string(8)}@blackbox.ai"
+            session_data = self._client.generate_session(request_email)
+
+            # Create the API request payload
+            payload = self._client.create_request_payload(
+                messages=blackbox_messages,
+                chat_id=request_id,
+                system_message=system_message,
+                max_tokens=max_tokens,
+                temperature=temperature,
+                top_p=top_p,
+                session_data=session_data,
+                model=model
+            )
+
+            # Make the API request with cookies
+            response = self._client.session.post(
+                self._client.api_endpoint,
+                json=payload,
+                headers=self._client.headers,
+                cookies=self._client.cookies,
+                timeout=self._client.timeout
+            )
+
+            # Process the response
+            full_content = ""
+            if response.status_code == 200:
+                # Extract content from response text
+                response_text = response.text
+
+                # Handle possible SSE format in response
+                if "data: " in response_text:
+                    # Extract content from SSE format
+                    content_lines = []
+                    for line in response_text.split('\n'):
+                        if line.startswith("data: "):
+                            line = line[6:].strip()
+                            if line and not any(error_msg in line.lower() for error_msg in [
+                                "service has been suspended",
+                                "api request failed",
+                                "you have reached your request limit"
+                            ]):
+                                content_lines.append(line)
+                    full_content = "".join(content_lines)
+                else:
+                    # Regular response
+                    full_content = response_text
+            else:
+                # Handle error response
+                raise IOError(f"BlackboxAI request failed with status code {response.status_code}")
+
+            # Create the completion message
+            message = ChatCompletionMessage(
+                role="assistant",
+                content=full_content
+            )
+
+            # Create the choice with the message
+            choice = Choice(
+                index=0,
+                message=message,
+                finish_reason="stop"
+            )
+
+            # Estimate token usage using count_tokens
+            prompt_tokens = count_tokens([str(msg.get("content", "")) for msg in messages])
+            completion_tokens = count_tokens(full_content)
+
+            # Create the final completion object
+            completion = ChatCompletion(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model,
+                usage=CompletionUsage(
+                    prompt_tokens=prompt_tokens,
+                    completion_tokens=completion_tokens,
+                    total_tokens=prompt_tokens + completion_tokens
+                )
+            )
+
+            return completion
+
+        except Exception as e:
+            raise IOError(f"BlackboxAI request failed: {str(e)}") from e
+
+    def _create_streaming(
+        self,
+        *,
+        request_id: str,
+        created_time: int,
+        model: str,
+        messages: List[Dict[str, Any]],
+        system_message: str,
+        max_tokens: Optional[int] = None,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        media: List = None
+    ):
+        """Implementation for streaming chat completions (OpenAI-compatible chunks)."""
+        # Prepare user messages for BlackboxAI API format
+        blackbox_messages = []
+        for i, msg in enumerate(messages):
+            if msg["role"] == "system":
+                continue  # System message handled separately
+            msg_id = self._client.generate_id() if i > 0 else request_id
+            blackbox_messages.append({
+                "id": msg_id,
+                "content": msg["content"],
+                "role": msg["role"]
+            })
+        # Add image data if provided
+        if media and blackbox_messages:
+            blackbox_messages[-1]['data'] = {
+                "imagesData": [
+                    {
+                        "filePath": f"/",
+                        "contents": to_data_uri(image[0])
+                    } for image in media
+                ],
+                "fileText": "",
+                "title": ""
+            }
+        # Generate request payload with session
+        request_email = f"{self._client.generate_random_string(8)}@blackbox.ai"
+        session_data = self._client.generate_session(request_email)
+        payload = self._client.create_request_payload(
+            messages=blackbox_messages,
+            chat_id=request_id,
+            system_message=system_message,
+            max_tokens=max_tokens,
+            temperature=temperature,
+            top_p=top_p,
+            session_data=session_data,
+            model=model
+        )
+        # Make the API request with cookies, stream=True
+        response = self._client.session.post(
+            self._client.api_endpoint,
+            json=payload,
+            headers=self._client.headers,
+            cookies=self._client.cookies,
+            stream=True,
+            timeout=self._client.timeout
+        )
+        # Blackbox streams as raw text, no line breaks, so chunk manually
+        buffer = ""
+        chunk_size = 32  # Tune as needed for smoothness
+        from webscout.Provider.OPENAI.utils import ChatCompletionChunk, Choice, ChoiceDelta
+        for chunk in response.iter_content(chunk_size=chunk_size):
+            if not chunk:
+                continue
+            text = chunk.decode(errors="ignore")
+            buffer += text
+            # Yield in small pieces, but only non-empty
+            while len(buffer) >= chunk_size:
+                out = buffer[:chunk_size]
+                buffer = buffer[chunk_size:]
+                if out.strip():
+                    # Wrap the chunk in OpenAI-compatible structure
+                    delta = ChoiceDelta(content=out, role="assistant")
+                    choice = Choice(index=0, delta=delta, finish_reason=None)
+                    chunk_obj = ChatCompletionChunk(
+                        id=request_id,
+                        choices=[choice],
+                        created=created_time,
+                        model=model,
+                        system_fingerprint=None
+                    )
+                    yield chunk_obj
+        # Yield any remaining buffer
+        if buffer.strip():
+            delta = ChoiceDelta(content=buffer, role="assistant")
+            choice = Choice(index=0, delta=delta, finish_reason=None)
+            chunk_obj = ChatCompletionChunk(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model,
+                system_fingerprint=None
+            )
+            yield chunk_obj
+
+
+class Chat(BaseChat):
+    def __init__(self, client: 'BLACKBOXAI'):
+        self.completions = Completions(client)
+
+
+class BLACKBOXAI(OpenAICompatibleProvider):
+    """
+    OpenAI-compatible client for BlackboxAI API.
+
+    Usage:
+        client = BLACKBOXAI()
+        response = client.chat.completions.create(
+            model="GPT-4.1",
+            messages=[{"role": "user", "content": "Hello!"}]
+        )
+        print(response.choices[0].message.content)
+    """
+    # Default model
+    default_model = "GPT-4.1"
+    default_vision_model = default_model
+    api_endpoint = "https://www.blackbox.ai/api/chat"
+    timeout = 30
+
+
+    # Default model (remains the same as per original class)
+    default_model = "GPT-4.1"
+    default_vision_model = default_model
+
+    # New OpenRouter models list
+    openrouter_models = [
+        "Deepcoder 14B Preview",
+        "DeepHermes 3 Llama 3 8B Preview",
+        "DeepSeek R1 Zero",
+        "Dolphin3.0 Mistral 24B",
+        "Dolphin3.0 R1 Mistral 24B",
+        "Flash 3",
+        "Gemini 2.0 Flash Experimental",
+        "Gemma 2 9B",
+        "Gemma 3 12B",
+        "Gemma 3 1B",
+        "Gemma 3 27B",
+        "Gemma 3 4B",
+        "Kimi VL A3B Thinking",
+        "Llama 3.1 8B Instruct",
+        "Llama 3.1 Nemotron Ultra 253B v1",
+        "Llama 3.2 11B Vision Instruct",
+        "Llama 3.2 1B Instruct",
+        "Llama 3.2 3B Instruct",
+        "Llama 3.3 70B Instruct",
+        "Llama 3.3 Nemotron Super 49B v1",
+        "Llama 4 Maverick",
+        "Llama 4 Scout",
+        "Mistral 7B Instruct",
+        "Mistral Nemo",
+        "Mistral Small 3",
+        "Mistral Small 3.1 24B",
+        "Molmo 7B D",
+        "Moonlight 16B A3B Instruct",
+        "Qwen2.5 72B Instruct",
+        "Qwen2.5 7B Instruct",
+        "Qwen2.5 Coder 32B Instruct",
+        "Qwen2.5 VL 32B Instruct",
+        "Qwen2.5 VL 3B Instruct",
+        "Qwen2.5 VL 72B Instruct",
+        "Qwen2.5-VL 7B Instruct",
+        "Qwerky 72B",
+        "QwQ 32B",
+        "QwQ 32B Preview",
+        "QwQ 32B RpR v1",
+        "R1",
+        "R1 Distill Llama 70B",
+        "R1 Distill Qwen 14B",
+        "R1 Distill Qwen 32B",
+    ]
+
+    # New base models list
+    models = [
+        default_model,
+        "o3-mini",
+        "gpt-4.1-nano",
+        "Claude Opus 4",  # Added Claude Opus 4
+        "Claude Sonnet 4",  # Added Claude Sonnet 4
+        "Claude-sonnet-3.7",
+        "Claude-sonnet-3.5",
+        "Grok 3",  # Added Grok 3
+        "Gemini 2.5 Pro",  # Added Gemini 2.5 Pro
+        "UI-TARS 72B",  # Added UI-TARS 72B
+        "DeepSeek-R1",
+        "Mistral-Small-24B-Instruct-2501",
+        *openrouter_models,
+        # Trending agent modes (names)
+        'Python Agent', 'HTML Agent', 'Builder Agent', 'Java Agent', 'JavaScript Agent',
+        'React Agent', 'Android Agent', 'Flutter Agent', 'Next.js Agent', 'AngularJS Agent',
+        'Swift Agent', 'MongoDB Agent', 'PyTorch Agent', 'Xcode Agent', 'Azure Agent',
+        'Bitbucket Agent', 'DigitalOcean Agent', 'Docker Agent', 'Electron Agent',
+        'Erlang Agent', 'FastAPI Agent', 'Firebase Agent', 'Flask Agent', 'Git Agent',
+        'Gitlab Agent', 'Go Agent', 'Godot Agent', 'Google Cloud Agent', 'Heroku Agent'
+    ]
+
+    # Models that support vision capabilities
+    vision_models = [default_vision_model, 'o3-mini', "Llama 3.2 11B Vision Instruct", "Gemini 2.5 Pro", "Claude Sonnet 4", "Claude Opus 4", "UI-TARS 72B"] # Added Llama vision, Gemini 2.5 Pro, Claude Sonnet 4, Claude Opus 4, and UI-TARS 72B
+
+    # Models that can be directly selected by users
+    userSelectedModel = ['o3-mini', 'Claude Opus 4', 'Claude Sonnet 4', 'Claude-sonnet-3.7', 'Claude-sonnet-3.5', 'Grok 3', 'Gemini 2.5 Pro', 'UI-TARS 72B', 'DeepSeek-R1', 'Mistral-Small-24B-Instruct-2501'] + openrouter_models
+
+    # Agent mode configurations
+    agentMode = {
+        # OpenRouter Free
+        'Deepcoder 14B Preview': {'mode': True, 'id': "agentica-org/deepcoder-14b-preview:free", 'name': "Deepcoder 14B Preview"},
+        'DeepHermes 3 Llama 3 8B Preview': {'mode': True, 'id': "nousresearch/deephermes-3-llama-3-8b-preview:free", 'name': "DeepHermes 3 Llama 3 8B Preview"},
+        'DeepSeek R1 Zero': {'mode': True, 'id': "deepseek/deepseek-r1-zero:free", 'name': "DeepSeek R1 Zero"},
+        'Dolphin3.0 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-mistral-24b:free", 'name': "Dolphin3.0 Mistral 24B"},
+        'Dolphin3.0 R1 Mistral 24B': {'mode': True, 'id': "cognitivecomputations/dolphin3.0-r1-mistral-24b:free", 'name': "Dolphin3.0 R1 Mistral 24B"},
+        'Flash 3': {'mode': True, 'id': "rekaai/reka-flash-3:free", 'name': "Flash 3"},
+        'Gemini 2.0 Flash Experimental': {'mode': True, 'id': "google/gemini-2.0-flash-exp:free", 'name': "Gemini 2.0 Flash Experimental"},
+        'Gemma 2 9B': {'mode': True, 'id': "google/gemma-2-9b-it:free", 'name': "Gemma 2 9B"},
+        'Gemma 3 12B': {'mode': True, 'id': "google/gemma-3-12b-it:free", 'name': "Gemma 3 12B"},
+        'Gemma 3 1B': {'mode': True, 'id': "google/gemma-3-1b-it:free", 'name': "Gemma 3 1B"},
+        'Gemma 3 27B': {'mode': True, 'id': "google/gemma-3-27b-it:free", 'name': "Gemma 3 27B"},
+        'Gemma 3 4B': {'mode': True, 'id': "google/gemma-3-4b-it:free", 'name': "Gemma 3 4B"},
+        'Kimi VL A3B Thinking': {'mode': True, 'id': "moonshotai/kimi-vl-a3b-thinking:free", 'name': "Kimi VL A3B Thinking"},
+        'Llama 3.1 8B Instruct': {'mode': True, 'id': "meta-llama/llama-3.1-8b-instruct:free", 'name': "Llama 3.1 8B Instruct"},
+        'Llama 3.1 Nemotron Ultra 253B v1': {'mode': True, 'id': "nvidia/llama-3.1-nemotron-ultra-253b-v1:free", 'name': "Llama 3.1 Nemotron Ultra 253B v1"},
+        'Llama 3.2 11B Vision Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-11b-vision-instruct:free", 'name': "Llama 3.2 11B Vision Instruct"},
+        'Llama 3.2 1B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-1b-instruct:free", 'name': "Llama 3.2 1B Instruct"},
+        'Llama 3.2 3B Instruct': {'mode': True, 'id': "meta-llama/llama-3.2-3b-instruct:free", 'name': "Llama 3.2 3B Instruct"},
+        'Llama 3.3 70B Instruct': {'mode': True, 'id': "meta-llama/llama-3.3-70b-instruct:free", 'name': "Llama 3.3 70B Instruct"},
+        'Llama 3.3 Nemotron Super 49B v1': {'mode': True, 'id': "nvidia/llama-3.3-nemotron-super-49b-v1:free", 'name': "Llama 3.3 Nemotron Super 49B v1"},
+        'Llama 4 Maverick': {'mode': True, 'id': "meta-llama/llama-4-maverick:free", 'name': "Llama 4 Maverick"},
+        'Llama 4 Scout': {'mode': True, 'id': "meta-llama/llama-4-scout:free", 'name': "Llama 4 Scout"},
+        'Mistral 7B Instruct': {'mode': True, 'id': "mistralai/mistral-7b-instruct:free", 'name': "Mistral 7B Instruct"},
+        'Mistral Nemo': {'mode': True, 'id': "mistralai/mistral-nemo:free", 'name': "Mistral Nemo"},
+        'Mistral Small 3': {'mode': True, 'id': "mistralai/mistral-small-24b-instruct-2501:free", 'name': "Mistral Small 3"}, # Matches Mistral-Small-24B-Instruct-2501
+        'Mistral Small 3.1 24B': {'mode': True, 'id': "mistralai/mistral-small-3.1-24b-instruct:free", 'name': "Mistral Small 3.1 24B"},
+        'Molmo 7B D': {'mode': True, 'id': "allenai/molmo-7b-d:free", 'name': "Molmo 7B D"},
+        'Moonlight 16B A3B Instruct': {'mode': True, 'id': "moonshotai/moonlight-16b-a3b-instruct:free", 'name': "Moonlight 16B A3B Instruct"},
+        'Qwen2.5 72B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-72b-instruct:free", 'name': "Qwen2.5 72B Instruct"},
+        'Qwen2.5 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-7b-instruct:free", 'name': "Qwen2.5 7B Instruct"},
+        'Qwen2.5 Coder 32B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-coder-32b-instruct:free", 'name': "Qwen2.5 Coder 32B Instruct"},
+        'Qwen2.5 VL 32B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-32b-instruct:free", 'name': "Qwen2.5 VL 32B Instruct"},
+        'Qwen2.5 VL 3B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-3b-instruct:free", 'name': "Qwen2.5 VL 3B Instruct"},
+        'Qwen2.5 VL 72B Instruct': {'mode': True, 'id': "qwen/qwen2.5-vl-72b-instruct:free", 'name': "Qwen2.5 VL 72B Instruct"},
+        'Qwen2.5-VL 7B Instruct': {'mode': True, 'id': "qwen/qwen-2.5-vl-7b-instruct:free", 'name': "Qwen2.5-VL 7B Instruct"},
+        'Qwerky 72B': {'mode': True, 'id': "featherless/qwerky-72b:free", 'name': "Qwerky 72B"},
+        'QwQ 32B': {'mode': True, 'id': "qwen/qwq-32b:free", 'name': "QwQ 32B"},
+        'QwQ 32B Preview': {'mode': True, 'id': "qwen/qwq-32b-preview:free", 'name': "QwQ 32B Preview"},
+        'QwQ 32B RpR v1': {'mode': True, 'id': "arliai/qwq-32b-arliai-rpr-v1:free", 'name': "QwQ 32B RpR v1"},
+        'R1': {'mode': True, 'id': "deepseek/deepseek-r1:free", 'name': "R1"}, # Matches DeepSeek-R1
+        'R1 Distill Llama 70B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-llama-70b:free", 'name': "R1 Distill Llama 70B"},
+        'R1 Distill Qwen 14B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-14b:free", 'name': "R1 Distill Qwen 14B"},
+        'R1 Distill Qwen 32B': {'mode': True, 'id': "deepseek/deepseek-r1-distill-qwen-32b:free", 'name': "R1 Distill Qwen 32B"},
+        # Default models from the new list
+        'Claude Opus 4': {'mode': True, 'id': "anthropic/claude-opus-4", 'name': "Claude Opus 4"},
+        'Claude Sonnet 4': {'mode': True, 'id': "anthropic/claude-sonnet-4", 'name': "Claude Sonnet 4"},
+        'Claude-sonnet-3.7': {'mode': True, 'id': "Claude-sonnet-3.7", 'name': "Claude-sonnet-3.7"},
+        'Claude-sonnet-3.5': {'mode': True, 'id': "Claude-sonnet-3.5", 'name': "Claude-sonnet-3.5"},
+        'Grok 3': {'mode': True, 'id': "x-ai/grok-3-beta", 'name': "Grok 3"},
+        'Gemini 2.5 Pro': {'mode': True, 'id': "google/gemini-2.5-pro-preview-03-25", 'name': "Gemini 2.5 Pro"},
+        'UI-TARS 72B': {'mode': True, 'id': "bytedance-research/ui-tars-72b:free", 'name': "UI-TARS 72B"},
+        'DeepSeek-R1': {'mode': True, 'id': "deepseek-reasoner", 'name': "DeepSeek-R1"}, # This is 'R1' in openrouter, but 'DeepSeek-R1' in base models
+        'Mistral-Small-24B-Instruct-2501': {'mode': True, 'id': "mistralai/Mistral-Small-24B-Instruct-2501", 'name': "Mistral-Small-24B-Instruct-2501"},
+        # Add default_model if it's not covered and has an agent mode
+        default_model: {'mode': True, 'id': "openai/gpt-4.1", 'name': default_model}, # Assuming GPT-4.1 is agent-compatible
+        'o3-mini': {'mode': True, 'id': "o3-mini", 'name': "o3-mini"}, # Assuming o3-mini is agent-compatible
+        'gpt-4.1-nano': {'mode': True, 'id': "gpt-4.1-nano", 'name': "gpt-4.1-nano"}, # Assuming gpt-4.1-nano is agent-compatible
+    }
+
+    # Trending agent modes
+    trendingAgentMode = {
+        'Python Agent': {'mode': True, 'id': "python"},
+        'HTML Agent': {'mode': True, 'id': "html"},
+        'Builder Agent': {'mode': True, 'id': "builder"},
+        'Java Agent': {'mode': True, 'id': "java"},
+        'JavaScript Agent': {'mode': True, 'id': "javascript"},
+        'React Agent': {'mode': True, 'id': "react"},
+        'Android Agent': {'mode': True, 'id': "android"},
+        'Flutter Agent': {'mode': True, 'id': "flutter"},
+        'Next.js Agent': {'mode': True, 'id': "next.js"},
+        'AngularJS Agent': {'mode': True, 'id': "angularjs"},
+        'Swift Agent': {'mode': True, 'id': "swift"},
+        'MongoDB Agent': {'mode': True, 'id': "mongodb"},
+        'PyTorch Agent': {'mode': True, 'id': "pytorch"},
+        'Xcode Agent': {'mode': True, 'id': "xcode"},
+        'Azure Agent': {'mode': True, 'id': "azure"},
+        'Bitbucket Agent': {'mode': True, 'id': "bitbucket"},
+        'DigitalOcean Agent': {'mode': True, 'id': "digitalocean"},
+        'Docker Agent': {'mode': True, 'id': "docker"},
+        'Electron Agent': {'mode': True, 'id': "electron"},
+        'Erlang Agent': {'mode': True, 'id': "erlang"},
+        'FastAPI Agent': {'mode': True, 'id': "fastapi"},
+        'Firebase Agent': {'mode': True, 'id': "firebase"},
+        'Flask Agent': {'mode': True, 'id': "flask"},
+        'Git Agent': {'mode': True, 'id': "git"},
+        'Gitlab Agent': {'mode': True, 'id': "gitlab"},
+        'Go Agent': {'mode': True, 'id': "go"},
+        'Godot Agent': {'mode': True, 'id': "godot"},
+        'Google Cloud Agent': {'mode': True, 'id': "googlecloud"},
+        'Heroku Agent': {'mode': True, 'id': "heroku"},
+    }
+
+    # Create AVAILABLE_MODELS as a list with just the model aliases (no "BLACKBOXAI/" prefix)
+    AVAILABLE_MODELS = list(models)
+
+
+    def __init__(
+        self,
+        proxies: dict = {}
+    ):
+        """
+        Initialize the BlackboxAI provider with OpenAI compatibility.
+
+        Args:
+            proxies: Optional proxy configuration
+        """
+        # Initialize session
+        self.session = requests.Session()
+
+        # Set headers based on GitHub reference
+        self.headers = {
+            'Accept': 'text/event-stream',
+            'Accept-Encoding': 'gzip, deflate, br, zstd',
+            'Accept-Language': 'en-US,en;q=0.9,en-IN;q=0.8',
+            'Content-Type': 'application/json',
+            'DNT': '1',
+            'Origin': 'https://www.blackbox.ai',
+            'Referer': 'https://www.blackbox.ai/',
+            'Sec-CH-UA': '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
+            'Sec-CH-UA-Mobile': '?0',
+            'Sec-CH-UA-Platform': '"Windows"',
+            'Sec-Fetch-Dest': 'empty',
+            'Sec-Fetch-Mode': 'cors',
+            'Sec-Fetch-Site': 'same-origin',
+            'User-Agent': agent.random(),
+        }
+
+        # Set cookies for the session
+        self.cookies = {
+            'cfzs_amplitude': self.generate_id(32),
+            'cfz_amplitude': self.generate_id(32),
+            '__cf_bm': self.generate_id(32),
+        }
+
+        # Set proxies if provided
+        self.session.proxies = proxies
+
+        # Initialize chat interface with completions
+        self.chat = Chat(self)
+
+    @property
+    def models(self):
+        class _ModelList:
+            def list(inner_self):
+                return type(self).AVAILABLE_MODELS
+        return _ModelList()
+
+
+    @classmethod
+    def get_model(cls, model: str) -> str:
+        """Return the model name, removing BLACKBOXAI/ prefix if present, or default_model."""
+        if model.startswith("BLACKBOXAI/"):
+            model = model[len("BLACKBOXAI/"):]
+        if model in cls.AVAILABLE_MODELS:
+            return model
+        return cls.default_model
+
+    @classmethod
+    def generate_random_string(cls, length: int = 8) -> str:
+        """Generate a random string of specified length."""
+        chars = string.ascii_lowercase + string.digits
+        return ''.join(random.choice(chars) for _ in range(length))
+
+    @classmethod
+    def generate_id(cls, length: int = 7) -> str:
+        """Generate a random ID of specified length."""
+        chars = string.ascii_letters + string.digits
+        return ''.join(random.choice(chars) for _ in range(length))
+
+    @classmethod
+    def generate_session(cls, email: str, id_length: int = 21, days_ahead: int = 30) -> dict:
+        """
+        Generate a dynamic session with proper ID and expiry format using a specific email.
+
+        Args:
+            email: The email to use for this session
+            id_length: Length of the numeric ID (default: 21)
+            days_ahead: Number of days ahead for expiry (default: 30)
+
+        Returns:
+            dict: A session dictionary with user information and expiry
+        """
+        # Generate a random name
+        first_names = ["Alex", "Jordan", "Taylor", "Morgan", "Casey", "Riley", "Avery", "Quinn", "Skyler", "Dakota"]
+        last_names = ["Smith", "Johnson", "Williams", "Brown", "Jones", "Miller", "Davis", "Garcia", "Rodriguez", "Wilson"]
+        name = f"{random.choice(first_names)} {random.choice(last_names)}"
+
+        # Generate numeric ID - using Google-like ID format
+        numeric_id = ''.join(random.choice('0123456789') for _ in range(id_length))
+
+        # Generate future expiry date
+        future_date = datetime.now() + timedelta(days=days_ahead)
+        expiry = future_date.strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
+
+        # Generate random image ID for the new URL format
+        chars = string.ascii_letters + string.digits + "-"
+        random_img_id = ''.join(random.choice(chars) for _ in range(48))
+        image_url = f"https://lh3.googleusercontent.com/a/ACg8oc{random_img_id}=s96-c"
+
+        return {
+            "user": {
+                "name": name,
+                "email": email,
+                "image": image_url,
+                "id": numeric_id
+            },
+            "expires": expiry,
+            "isNewUser": False
+        }
+
+    def create_request_payload(
+        self,
+        messages: List[Dict[str, Any]],
+        chat_id: str,
+        system_message: str,
+        max_tokens: int,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        session_data: Dict[str, Any] = None,
+        model: str = None
+    ) -> Dict[str, Any]:
+        """Create the full request payload for the BlackboxAI API."""
+        # Get the correct model ID and agent mode
+        model_name = self.get_model(model or self.default_model)
+        agent_mode = self.agentMode.get(model_name, {})
+
+        # Generate a random customer ID for the subscription
+        customer_id = "cus_" + ''.join(random.choice(string.ascii_letters + string.digits) for _ in range(14))
+
+        # Create the full request payload
+        return {
+            "messages": messages,
+            "agentMode": agent_mode,
+            "id": chat_id,
+            "previewToken": None,
+            "userId": None,
+            "codeModelMode": True,
+            "trendingAgentMode": {},
+            "isMicMode": False,
+            "userSystemPrompt": system_message,
+            "maxTokens": max_tokens,
+            "playgroundTopP": top_p,
+            "playgroundTemperature": temperature,
+            "isChromeExt": False,
+            "githubToken": "",
+            "clickedAnswer2": False,
+            "clickedAnswer3": False,
+            "clickedForceWebSearch": False,
+            "visitFromDelta": False,
+            "isMemoryEnabled": False,
+            "mobileClient": False,
+            "userSelectedModel": model_name if model_name in self.userSelectedModel else None,
+            "validated": "00f37b34-a166-4efb-bce5-1312d87f2f94",
+            "imageGenerationMode": False,
+            "webSearchModePrompt": False,
+            "deepSearchMode": False,
+            "designerMode": False,
+            "domains": None,
+            "vscodeClient": False,
+            "codeInterpreterMode": False,
+            "customProfile": {
+                "name": "",
+                "occupation": "",
+                "traits": [],
+                "additionalInfo": "",
+                "enableNewChats": False
+            },
+            "webSearchModeOption": {
+                "autoMode": True,
+                "webMode": False,
+                "offlineMode": False
+            },
+            "session": session_data,
+            "isPremium": True,
+            "subscriptionCache": {
+                "status": "PREMIUM",
+                "customerId": customer_id,
+                "expiryTimestamp": int((datetime.now() + timedelta(days=30)).timestamp()),
+                "lastChecked": int(datetime.now().timestamp() * 1000),
+                "isTrialSubscription": True
+            },
+            "beastMode": False,
+            "reasoningMode": False,
+            "designerMode": False,
+            "workspaceId": ""
+        }
+if __name__ == "__main__":
+    # Example usage
+    client = BLACKBOXAI()
+    response = client.chat.completions.create(
+        model="GPT-4.1",
+        messages=[{"role": "user", "content": "Tell me about india in points"}],
+        stream=True
+    )
+    for chunk in response:
+        print(chunk.choices[0].delta.content, end='', flush=True)