webscout 8.3.4__py3-none-any.whl → 8.3.5__py3-none-any.whl

webscout/Provider/OPENAI/README_AUTOPROXY.md

@@ -1,238 +0,0 @@
-# WebScout Auto-Proxy System
-
-The WebScout Auto-Proxy system provides automatic proxy injection for all OpenAI-compatible providers. This system fetches proxies from a remote source and automatically configures them for HTTP sessions.
-
-## Features
-
-- **Automatic Proxy Injection**: All OpenAI-compatible providers automatically get proxy support
-- **Multiple HTTP Client Support**: Works with `requests`, `httpx`, and `curl_cffi`
-- **Proxy Pool Management**: Automatically fetches and caches proxies from remote source
-- **Working Proxy Detection**: Tests proxies to find working ones
-- **Easy Disable Option**: Can be disabled per provider instance or globally
-
-## How It Works
-
-The system uses a metaclass (`ProxyAutoMeta`) that automatically:
-
-1. Fetches proxies from `http://207.180.209.185:5000/ips.txt`
-2. Caches proxies for 5 minutes to avoid excessive requests
-3. Randomly selects a proxy for each provider instance
-4. Patches existing HTTP session objects with proxy configuration
-5. Provides helper methods for creating proxied sessions
-
-## Usage
-
-### Automatic Usage (Default)
-
-All OpenAI-compatible providers automatically get proxy support:
-
-```python
-from webscout.Provider.OPENAI.yep import YEPCHAT
-
-# Proxy is automatically configured
-client = YEPCHAT()
-
-# All requests will use the configured proxy
-response = client.chat.completions.create(
-    model="DeepSeek-R1-Distill-Qwen-32B",
-    messages=[{"role": "user", "content": "Hello!"}]
-)
-```
-
-### Disabling Auto-Proxy
-
-You can disable automatic proxy injection:
-
-```python
-# Disable for a specific instance
-client = YEPCHAT(disable_auto_proxy=True)
-
-# Or set a class attribute to disable for all instances
-class MyProvider(OpenAICompatibleProvider):
-    DISABLE_AUTO_PROXY = True
-```
-
-### Manual Proxy Configuration
-
-You can also provide your own proxies:
-
-```python
-custom_proxies = {
-    'http': 'http://user:pass@proxy.example.com:8080',
-    'https': 'http://user:pass@proxy.example.com:8080'
-}
-
-client = YEPCHAT(proxies=custom_proxies)
-```
-
-### Using Helper Methods
-
-Each provider instance gets helper methods for creating proxied sessions:
-
-```python
-client = YEPCHAT()
-
-# Get a requests.Session with proxies configured
-session = client.get_proxied_session()
-
-# Get a curl_cffi Session with proxies configured
-curl_session = client.get_proxied_curl_session(impersonate="chrome120")
-
-# Get an httpx.Client with proxies configured (if httpx is installed)
-httpx_client = client.get_proxied_httpx_client()
-```
-
-## Direct API Usage
-
-You can also use the proxy functions directly:
-
-```python
-from webscout.Provider.OPENAI.autoproxy import (
-    get_auto_proxy,
-    get_proxy_dict,
-    get_working_proxy,
-    test_proxy,
-    get_proxy_stats
-)
-
-# Get a random proxy
-proxy = get_auto_proxy()
-
-# Get proxy in dictionary format
-proxy_dict = get_proxy_dict()
-
-# Find a working proxy (tests multiple proxies)
-working_proxy = get_working_proxy(max_attempts=5)
-
-# Test if a proxy is working
-is_working = test_proxy(proxy)
-
-# Get proxy cache statistics
-stats = get_proxy_stats()
-```
-
-## Proxy Format
-
-The system expects proxies in the format:
-```
-http://username:password@host:port
-```
-
-Example:
-```
-http://fnXlN8NP6StpxZkxmNLyOt2MaVLQunpGC7K96j7R0KbnE5sU_2RdYRxaoy7P2yfqrD7Y8UFexv8kpTyK0LwkDQ==:fnXlN8NP6StpxZkxmNLyOt2MaVLQunpGC7K96j7R0KbnE5sU_2RdYRxaoy7P2yfqrD7Y8UFexv8kpTyK0LwkDQ==@190.103.177.163:80
-```
-
-## Configuration
-
-### Cache Duration
-
-You can adjust the proxy cache duration:
-
-```python
-from webscout.Provider.OPENAI.autoproxy import set_proxy_cache_duration
-
-# Set cache to 10 minutes
-set_proxy_cache_duration(600)
-```
-
-### Force Refresh
-
-You can force refresh the proxy cache:
-
-```python
-from webscout.Provider.OPENAI.autoproxy import refresh_proxy_cache
-
-# Force refresh and get number of proxies loaded
-count = refresh_proxy_cache()
-print(f"Loaded {count} proxies")
-```
-
-## Error Handling
-
-The system gracefully handles errors:
-
-- If proxy fetching fails, providers work without proxies
-- If a proxy test fails, the system tries other proxies
-- If no working proxy is found, providers fall back to direct connections
-
-## Logging
-
-The system uses Python's logging module. To see proxy-related logs:
-
-```python
-import logging
-logging.basicConfig(level=logging.INFO)
-
-# Or specifically for the autoproxy module
-logger = logging.getLogger('webscout.Provider.OPENAI.autoproxy')
-logger.setLevel(logging.DEBUG)
-```
-
-## Testing
-
-Run the test suite to verify functionality:
-
-```bash
-python webscout/Provider/OPENAI/test_autoproxy.py
-```
-
-## Implementation Details
-
-### ProxyAutoMeta Metaclass
-
-The `ProxyAutoMeta` metaclass is applied to `OpenAICompatibleProvider` and:
-
-1. Intercepts class instantiation
-2. Checks for `disable_auto_proxy` parameter or class attribute
-3. Fetches and configures proxies if not disabled
-4. Patches existing session objects
-5. Adds helper methods to the instance
-
-### Session Patching
-
-The system automatically patches these session types:
-- `requests.Session` - Updates the `proxies` attribute
-- `httpx.Client` - Sets the `_proxies` attribute
-- `curl_cffi.Session` - Updates the `proxies` attribute
-- `curl_cffi.AsyncSession` - Updates the `proxies` attribute
-
-### Proxy Source
-
-Proxies are fetched from: `http://207.180.209.185:5000/ips.txt`
-
-The system expects one proxy per line in the format shown above.
-
-## Troubleshooting
-
-### No Proxies Available
-
-If you see "No proxies available" messages:
-1. Check if the proxy source URL is accessible
-2. Verify your internet connection
-3. Check if the proxy format is correct
-
-### Proxy Test Failures
-
-If proxy tests fail:
-1. Some proxies may be temporarily unavailable (normal)
-2. The test URL (`https://httpbin.org/ip`) may be blocked
-3. Network connectivity issues
-
-### Provider Not Getting Proxies
-
-If a provider doesn't get automatic proxies:
-1. Ensure it inherits from `OpenAICompatibleProvider`
-2. Check if `disable_auto_proxy` is set
-3. Verify the metaclass is properly imported
-
-## Contributing
-
-To add proxy support to a new provider:
-
-1. Inherit from `OpenAICompatibleProvider`
-2. Accept `disable_auto_proxy` parameter in `__init__`
-3. Use `self.proxies` for HTTP requests
-4. Optionally use helper methods like `self.get_proxied_session()`
-
-The metaclass will handle the rest automatically!

webscout/Provider/OPENAI/typegpt.py

@@ -1,368 +0,0 @@
-import time
-import uuid
-import requests
-import json
-from typing import List, Dict, Optional, Union, Generator, Any
-
-# Import base classes and utility structures
-from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
-from .utils import (
-    ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
-    ChatCompletionMessage, CompletionUsage, count_tokens
-)
-
-# Attempt to import LitAgent, fallback if not available
-try:
-    from webscout.litagent import LitAgent
-except ImportError:
-    print("Warning: LitAgent not found. Functionality may be limited.")
-
-# --- TypeGPT Client ---
-
-class Completions(BaseCompletions):
-    def __init__(self, client: 'TypeGPT'):
-        self._client = client
-
-    def create(
-        self,
-        *,
-        model: str,
-        messages: List[Dict[str, str]],
-        max_tokens: Optional[int] = None,
-        stream: bool = False,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        presence_penalty: Optional[float] = None,
-        frequency_penalty: Optional[float] = None,
-        timeout: Optional[int] = None,
-        proxies: Optional[Dict[str, str]] = None,
-        **kwargs: Any
-    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
-        """
-        Creates a model response for the given chat conversation.
-        Mimics openai.chat.completions.create
-        """
-        # Prepare the payload for TypeGPT API
-        payload = {
-            "messages": messages,
-            "stream": stream,
-            "model": self._client.convert_model_name(model),
-            "temperature": temperature if temperature is not None else self._client.temperature,
-            "top_p": top_p if top_p is not None else self._client.top_p,
-            "presence_penalty": presence_penalty if presence_penalty is not None else self._client.presence_penalty,
-            "frequency_penalty": frequency_penalty if frequency_penalty is not None else self._client.frequency_penalty,
-            "max_tokens": max_tokens if max_tokens is not None else self._client.max_tokens,
-        }
-
-        # Add any additional parameters
-        for key, value in kwargs.items():
-            if key not in payload:
-                payload[key] = value
-
-        request_id = f"chatcmpl-{uuid.uuid4()}"
-        created_time = int(time.time())
-
-        if stream:
-            return self._create_stream(request_id, created_time, model, payload, timeout, proxies)
-        else:
-            return self._create_non_stream(request_id, created_time, model, payload, timeout, proxies)
-
-    def _create_stream(
-        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any], timeout: Optional[int] = None, proxies: Optional[Dict[str, str]] = None
-    ) -> Generator[ChatCompletionChunk, None, None]:
-        try:
-            response = self._client.session.post(
-                self._client.api_endpoint,
-                headers=self._client.headers,
-                json=payload,
-                stream=True,
-                timeout=timeout or self._client.timeout,
-                proxies=proxies or getattr(self._client, "proxies", None)
-            )
-
-            # Handle non-200 responses
-            if not response.ok:
-                raise IOError(
-                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
-                )
-
-            # Track token usage across chunks
-            prompt_tokens = 0
-            completion_tokens = 0
-            total_tokens = 0
-
-            # Estimate prompt tokens based on message length
-            for msg in payload.get("messages", []):
-                prompt_tokens += count_tokens(msg.get("content", ""))
-
-            for line in response.iter_lines():
-                if not line:
-                    continue
-
-                decoded_line = line.decode('utf-8').strip()
-
-                if decoded_line.startswith("data: "):
-                    json_str = decoded_line[6:]
-                    if json_str == "[DONE]":
-                        break
-
-                    try:
-                        data = json.loads(json_str)
-                        choice_data = data.get('choices', [{}])[0]
-                        delta_data = choice_data.get('delta', {})
-                        finish_reason = choice_data.get('finish_reason')
-
-                        # Update token counts if available
-                        usage_data = data.get('usage', {})
-                        if usage_data:
-                            prompt_tokens = usage_data.get('prompt_tokens', prompt_tokens)
-                            completion_tokens = usage_data.get('completion_tokens', completion_tokens)
-                            total_tokens = usage_data.get('total_tokens', total_tokens)
-
-                        # Create the delta object
-                        delta = ChoiceDelta(
-                            content=delta_data.get('content'),
-                            role=delta_data.get('role'),
-                            tool_calls=delta_data.get('tool_calls')
-                        )
-
-                        # Create the choice object
-                        choice = Choice(
-                            index=choice_data.get('index', 0),
-                            delta=delta,
-                            finish_reason=finish_reason,
-                            logprobs=choice_data.get('logprobs')
-                        )
-
-                        # Create the chunk object
-                        chunk = ChatCompletionChunk(
-                            id=request_id,
-                            choices=[choice],
-                            created=created_time,
-                            model=model,
-                            system_fingerprint=data.get('system_fingerprint')
-                        )
-
-                        # Convert chunk to dict using Pydantic's API
-                        if hasattr(chunk, "model_dump"):
-                            chunk_dict = chunk.model_dump(exclude_none=True)
-                        else:
-                            chunk_dict = chunk.dict(exclude_none=True)
-
-                        # Add usage information to match OpenAI format
-                        usage_dict = {
-                            "prompt_tokens": prompt_tokens or 10,
-                            "completion_tokens": completion_tokens or (len(delta_data.get('content', '')) if delta_data.get('content') else 0),
-                            "total_tokens": total_tokens or (10 + (len(delta_data.get('content', '')) if delta_data.get('content') else 0)),
-                            "estimated_cost": None
-                        }
-
-                        # Update completion_tokens and total_tokens as we receive more content
-                        if delta_data.get('content'):
-                            completion_tokens += 1
-                            total_tokens = prompt_tokens + completion_tokens
-                            usage_dict["completion_tokens"] = completion_tokens
-                            usage_dict["total_tokens"] = total_tokens
-
-                        chunk_dict["usage"] = usage_dict
-
-                        # Return the chunk object for internal processing
-                        yield chunk
-                    except json.JSONDecodeError:
-                        print(f"Warning: Could not decode JSON line: {json_str}")
-                        continue
-
-            # Final chunk with finish_reason="stop"
-            delta = ChoiceDelta(
-                content=None,
-                role=None,
-                tool_calls=None
-            )
-
-            choice = Choice(
-                index=0,
-                delta=delta,
-                finish_reason="stop",
-                logprobs=None
-            )
-
-            chunk = ChatCompletionChunk(
-                id=request_id,
-                choices=[choice],
-                created=created_time,
-                model=model,
-                system_fingerprint=None
-            )
-
-            if hasattr(chunk, "model_dump"):
-                chunk_dict = chunk.model_dump(exclude_none=True)
-            else:
-                chunk_dict = chunk.dict(exclude_none=True)
-            chunk_dict["usage"] = {
-                "prompt_tokens": prompt_tokens,
-                "completion_tokens": completion_tokens,
-                "total_tokens": total_tokens,
-                "estimated_cost": None
-            }
-
-            yield chunk
-
-        except Exception as e:
-            print(f"Error during TypeGPT stream request: {e}")
-            raise IOError(f"TypeGPT request failed: {e}") from e
-
-    def _create_non_stream(
-        self, request_id: str, created_time: int, model: str, payload: Dict[str, Any], timeout: Optional[int] = None, proxies: Optional[Dict[str, str]] = None
-    ) -> ChatCompletion:
-        try:
-            response = self._client.session.post(
-                self._client.api_endpoint,
-                headers=self._client.headers,
-                json=payload,
-                timeout=timeout or self._client.timeout,
-                proxies=proxies or getattr(self._client, "proxies", None)
-            )
-
-            # Handle non-200 responses
-            if not response.ok:
-                raise IOError(
-                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
-                )
-
-            # Parse the response
-            data = response.json()
-
-            choices_data = data.get('choices', [])
-            usage_data = data.get('usage', {})
-
-            choices = []
-            for choice_d in choices_data:
-                message_d = choice_d.get('message', {})
-                message = ChatCompletionMessage(
-                    role=message_d.get('role', 'assistant'),
-                    content=message_d.get('content', '')
-                )
-                choice = Choice(
-                    index=choice_d.get('index', 0),
-                    message=message,
-                    finish_reason=choice_d.get('finish_reason', 'stop')
-                )
-                choices.append(choice)
-
-            usage = CompletionUsage(
-                prompt_tokens=usage_data.get('prompt_tokens', 0),
-                completion_tokens=usage_data.get('completion_tokens', 0),
-                total_tokens=usage_data.get('total_tokens', 0)
-            )
-
-            completion = ChatCompletion(
-                id=request_id,
-                choices=choices,
-                created=created_time,
-                model=data.get('model', model),
-                usage=usage,
-            )
-            return completion
-
-        except Exception as e:
-            print(f"Error during TypeGPT non-stream request: {e}")
-            raise IOError(f"TypeGPT request failed: {e}") from e
-
-class Chat(BaseChat):
-    def __init__(self, client: 'TypeGPT'):
-        self.completions = Completions(client)
-
-class TypeGPT(OpenAICompatibleProvider):
-    """
-    OpenAI-compatible client for TypeGPT API.
-
-    Usage:
-        client = TypeGPT()
-        response = client.chat.completions.create(
-            model="gpt-4o",
-            messages=[{"role": "user", "content": "Hello!"}]
-        )
-    """
-
-    AVAILABLE_MODELS = [
-        # Working Models (based on testing)
-        "gpt-4o-mini",
-        "chatgpt-4o-latest",
-        # "deepseek-r1",
-        "deepseek-v3",
-        # "uncensored-r1",
-        # "Image-Generator",
-    ]
-
-    def __init__(
-        self,
-        timeout: Optional[int] = None,
-        browser: str = "chrome"
-    ):
-        """
-        Initialize the TypeGPT client.
-
-        Args:
-            timeout: Request timeout in seconds (None for no timeout)
-            browser: Browser to emulate in user agent
-        """
-        self.timeout = timeout or 60  # Default to 30 seconds if None
-        self.api_endpoint = "https://chat.typegpt.net/api/openai/v1/chat/completions"
-        self.session = requests.Session()
-
-        # Default parameters
-        self.max_tokens = 4000
-        self.temperature = 0.5
-        self.presence_penalty = 0
-        self.frequency_penalty = 0
-        self.top_p = 1
-
-        # Initialize LitAgent for user agent generation
-        agent = LitAgent()
-        self.fingerprint = agent.generate_fingerprint(browser)
-
-        # Headers for the request
-        self.headers = {
-            "authority": "chat.typegpt.net",
-            "accept": "application/json, text/event-stream",
-            "accept-language": self.fingerprint["accept_language"],
-            "content-type": "application/json",
-            "origin": "https://chat.typegpt.net",
-            "referer": "https://chat.typegpt.net/",
-            "user-agent": self.fingerprint["user_agent"]
-        }
-
-        self.session.headers.update(self.headers)
-
-        # Initialize the chat interface
-        self.chat = Chat(self)
-
-    def convert_model_name(self, model: str) -> str:
-        """
-        Convert model names to ones supported by TypeGPT.
-
-        Args:
-            model: Model name to convert
-
-        Returns:
-            TypeGPT model name
-        """
-        # If the model is already a valid TypeGPT model, return it
-        if model in self.AVAILABLE_MODELS:
-            return model
-
-        # Default to chatgpt-4o-latest if model not found (this one works reliably)
-        print(f"Warning: Unknown model '{model}'. Using 'chatgpt-4o-latest' instead.")
-        return "chatgpt-4o-latest"
-
-    @property
-    def models(self):
-        class _ModelList:
-            def list(inner_self):
-                return type(self).AVAILABLE_MODELS
-        return _ModelList()
-
-    @classmethod
-    def models(cls):
-        """Return the list of available models for TypeGPT."""
-        return cls.AVAILABLE_MODELS