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

webscout/Provider/Glider.py

@@ -1,225 +0,0 @@
-import cloudscraper
-# from curl_cffi.requests import Session
-import json
-from typing import Union, Any, Dict, Generator, Optional, List
-
-from curl_cffi import CurlError
-
-from webscout.AIutel import Optimizers, Conversation, AwesomePrompts, sanitize_stream # Import sanitize_stream
-from webscout.AIbase import Provider
-from webscout import exceptions
-from webscout.litagent import LitAgent as Lit
-
-class GliderAI(Provider):
-    """
-    A class to interact with the Glider.so API.
-    """
-
-    AVAILABLE_MODELS = [
-        "chat-llama-3-1-8b",
-        "chat-llama-3-2-3b",
-        "chat-deepseek-r1-qwen-32b",
-        "chat-qwen-2-5-7b",
-        "chat-qwen-qwq-32b",
-        "deepseek-ai/DeepSeek-R1",
-    ]
-
-    def __init__(
-        self,
-        is_conversation: bool = True,
-        max_tokens: int = 600,
-        timeout: int = 30,
-        intro: Optional[str] = None,
-        filepath: Optional[str] = None,
-        update_file: bool = True,
-        proxies: dict = {},
-        history_offset: int = 10250,
-        act: Optional[str] = None,
-        model: str = "chat-llama-3-1-8b",
-        system_prompt: str = "You are a helpful AI assistant."
-    ):
-        """Initializes the GliderAI API client."""
-        if model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Invalid model: {model}. Choose from: {', '.join(self.AVAILABLE_MODELS)}")
-        
-        self.session = cloudscraper.create_scraper() # Use cloudscraper Session
-        self.is_conversation = is_conversation
-        self.max_tokens_to_sample = max_tokens
-        self.api_endpoint = "https://glider.so/api/chat"
-        self.stream_chunk_size = 64
-        self.timeout = timeout
-        self.last_response = {}
-        self.model = model
-        self.system_prompt = system_prompt
-        self.headers = {
-            "accept": "*/*",
-            "accept-language": "en-US,en;q=0.9",
-            "content-type": "text/plain;charset=UTF-8",
-            "origin": "https://glider.so",
-            "referer": "https://glider.so/",
-            "user-agent": Lit().random(),
-            "cookie": "_vcrcs=1.1746977094.3600.NDlmNmM5YWFmNzMxZWUyNzE4ZjBhOTJlZGZlZDU3MGU=.850a77f5f36f60ae5da2f51b55231a54",
-        }
-        self.session.headers.update(self.headers)
-        self.session.proxies = proxies # Assign proxies directly
-
-        self.__available_optimizers = (
-            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 _glider_extractor(chunk: Union[str, Dict[str, Any]]) -> Optional[str]:
-        """Extracts content from Glider stream JSON objects."""
-        if isinstance(chunk, dict):
-            # Handle both standard and DeepSeek response formats within choices
-            return chunk.get("choices", [{}])[0].get("delta", {}).get("content")
-        return None
-
-    def ask(
-        self,
-        prompt: str,
-        stream: bool = False,
-        raw: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[Dict[str, Any], Generator[Any, None, None]]:
-        """Chat with AI.
-
-        Args:
-            prompt (str): Prompt to be sent.
-            stream (bool, optional): Flag for streaming response. Defaults to False.
-            raw (bool, optional): Return raw response chunks instead of dict. Defaults to False.
-            optimizer (str, optional): Prompt optimizer name. Defaults to None.
-            conversationally (bool, optional): Use conversationally modified prompt when optimizer specified. Defaults to False.
-        Returns:
-            dict or Generator[dict, None, None]: The response from the API.
-        """
-        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 {list(self.__available_optimizers)}")
-
-        payload = {
-            "messages": [
-                {"role": "system", "content": self.system_prompt},
-                {"role": "user", "content": conversation_prompt}
-            ],
-            "model": self.model,
-        }
-
-        def for_stream():
-            streaming_text = ""
-            try:
-                import json
-                response = self.session.post(
-                self.api_endpoint, data=json.dumps(payload), stream=True, timeout=self.timeout
-                )
-                response.raise_for_status()
-
-                # Use sanitize_stream
-                processed_stream = sanitize_stream(
-                    data=response.iter_content(chunk_size=None), # Pass byte iterator
-                    intro_value="data:",
-                    to_json=True,     # Stream sends JSON
-                    content_extractor=self._glider_extractor, # Use the specific extractor
-                    yield_raw_on_error=False # Skip non-JSON lines or lines where extractor fails
-                )
-
-                for content_chunk in processed_stream:
-                    # content_chunk is the string extracted by _glider_extractor
-                    if content_chunk and isinstance(content_chunk, str):
-                        streaming_text += content_chunk
-                        yield content_chunk if raw else {"text": content_chunk}
-            except CurlError as e:
-                raise exceptions.FailedToGenerateResponseError(f"Request failed (CurlError): {e}") from e
-            except Exception as e:
-                raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred ({type(e).__name__}): {e}") from e
-            self.last_response.update(dict(text=streaming_text))
-            self.conversation.update_chat_history(prompt, self.get_message(self.last_response))
-
-        def for_non_stream():
-            for _ in for_stream():
-                pass
-            return self.last_response
-
-        return for_stream() if stream else for_non_stream()
-
-    def chat(
-        self,
-        prompt: str,
-        stream: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[str, Generator[str, None, None]]:
-        """Generate response as a string.
-
-        Args:
-            prompt (str): Prompt to be sent.
-            stream (bool, optional): Flag for streaming response. Defaults to False.
-            optimizer (str, optional): Prompt optimizer name. Defaults to None.
-            conversationally (bool, optional): Use conversationally modified prompt when optimizer specified. Defaults to False.
-        Returns:
-            str or Generator[str, None, None]: The response generated.
-        """
-        def for_stream():
-            for response in self.ask(
-                prompt, stream=True, optimizer=optimizer, conversationally=conversationally
-            ):
-                yield self.get_message(response)
-        def for_non_stream():
-            return self.get_message(
-                self.ask(
-                    prompt,
-                    stream=False,
-                    optimizer=optimizer,
-                    conversationally=conversationally,
-                )
-            )
-        return for_stream() if stream else for_non_stream()
-
-    def get_message(self, response: dict) -> str:
-        """Retrieves message only from response."""
-        assert isinstance(response, dict), "Response should be of dict data-type only"
-        return response["text"]
-
-if __name__ == "__main__":
-    print("-" * 80)
-    print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    print("-" * 80)
-
-    for model in GliderAI.AVAILABLE_MODELS:
-        try:
-            test_ai = GliderAI(model=model, timeout=60)
-            response = test_ai.chat("Say 'Hello' in one word", stream=True)
-            response_text = ""
-            for chunk in response:
-                response_text += chunk
-                print(f"\r{model:<50} {'Testing...':<10}", end="", flush=True)
-            
-            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"\r{model:<50} {status:<10} {display_text}")
-        except Exception as e:
-            print(f"\r{model:<50} {'✗':<10} {str(e)}")

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!