webscout 7.2__py3-none-any.whl → 7.3__py3-none-any.whl

webscout/Provider/freeaichat.py

@@ -0,0 +1,221 @@
+import requests
+import json
+import time
+from typing import Any, Dict, Optional, Generator, Union
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts, sanitize_stream
+from webscout.AIbase import Provider, AsyncProvider
+from webscout import exceptions
+from webscout import LitAgent
+from webscout.Litlogger import Logger, LogFormat
+
+class FreeAIChat(Provider):
+    """
+    A class to interact with the FreeAIChat API with logging and LitAgent user-agent.
+    """
+
+    AVAILABLE_MODELS = [
+        "mistral-nemo",
+        "mistral-large",
+        "llama3.1-70b-fast",
+        "gemini-2.0-flash",
+        "gemini-1.5-pro",
+        "gemini-1.5-flash",
+        "gemini-2.0-pro-exp-02-05",
+        "deepseek-r1",
+        "deepseek-v3",
+        "Deepseek r1 14B",
+        "Deepseek r1 32B",
+        "o3-mini-high",
+        "o3-mini-medium",
+        "o3-mini-low",
+        "o3-mini",
+        "GPT-4o-mini",
+        "o1",
+        "o1-mini",
+        "GPT-4o"
+    ]
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 2049,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = "GPT-4o",
+        system_prompt: str = "You are a helpful AI assistant.",
+        logging: bool = False
+    ):
+        """Initializes the FreeAIChat API client with logging support."""
+        if model not in self.AVAILABLE_MODELS:
+            raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
+
+        self.url = "https://freeaichatplayground.com/api/v1/chat/completions"
+        self.headers = {
+            'User-Agent': LitAgent().random(),
+            'Accept': '*/*',
+            'Content-Type': 'application/json',
+            'Origin': 'https://freeaichatplayground.com',
+            'Referer': 'https://freeaichatplayground.com/',
+            'Sec-Fetch-Mode': 'cors',
+            'Sec-Fetch-Site': 'same-origin'
+        }
+        self.session = requests.Session()
+        self.session.headers.update(self.headers)
+        self.session.proxies.update(proxies)
+
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.timeout = timeout
+        self.last_response = {}
+        self.model = model
+        self.system_prompt = system_prompt
+
+        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
+
+        self.logger = Logger(
+            name="FreeAIChat",
+            format=LogFormat.MODERN_EMOJI,
+        ) if logging else None
+
+        if self.logger:
+            self.logger.info(f"FreeAIChat initialized successfully with model: {model}")
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Union[Dict[str, Any], Generator]:
+        conversation_prompt = self.conversation.gen_complete_prompt(prompt)
+        if optimizer:
+            if optimizer in self.__available_optimizers:
+                conversation_prompt = getattr(Optimizers, optimizer)(
+                    conversation_prompt if conversationally else prompt
+                )
+                if self.logger:
+                    self.logger.debug(f"Applied optimizer: {optimizer}")
+            else:
+                if self.logger:
+                    self.logger.error(f"Invalid optimizer requested: {optimizer}")
+                raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
+
+        messages = [
+            {
+                "role": "system",
+                "content": self.system_prompt
+            },
+            {
+                "role": "user",
+                "content": conversation_prompt
+            }
+        ]
+
+        payload = {
+            "model": self.model,
+            "messages": messages
+        }
+
+        def for_stream():
+            if self.logger:
+                self.logger.debug("Sending streaming request to FreeAIChat API...")
+            try:
+                with requests.post(self.url, headers=self.headers, json=payload, stream=True, timeout=self.timeout) as response:
+                    if response.status_code != 200:
+                        if self.logger:
+                            self.logger.error(f"Request failed with status code {response.status_code}")
+                        raise exceptions.FailedToGenerateResponseError(
+                            f"Request failed with status code {response.status_code}"
+                        )
+                    
+                    streaming_text = ""
+                    for line in response.iter_lines(decode_unicode=True):
+                        if line:
+                            line = line.strip()
+                            if line.startswith("data: "):
+                                json_str = line[6:]  # Remove "data: " prefix
+                                if json_str == "[DONE]":
+                                    break
+                                try:
+                                    json_data = json.loads(json_str)
+                                    if 'choices' in json_data:
+                                        choice = json_data['choices'][0]
+                                        if 'delta' in choice and 'content' in choice['delta']:
+                                            content = choice['delta']['content']
+                                            streaming_text += content
+                                            resp = dict(text=content)
+                                            yield resp if raw else resp
+                                except json.JSONDecodeError:
+                                    if self.logger:
+                                        self.logger.error("JSON decode error in streaming data")
+                                    pass
+                    
+                    self.conversation.update_chat_history(prompt, streaming_text)
+                    if self.logger:
+                        self.logger.info("Streaming response completed successfully")
+                        
+            except requests.RequestException as e:
+                if self.logger:
+                    self.logger.error(f"Request failed: {e}")
+                raise exceptions.FailedToGenerateResponseError(f"Request failed: {e}")
+
+        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: str = None,
+        conversationally: bool = False,
+    ) -> str:
+        def for_stream():
+            for response in self.ask(prompt, True, optimizer=optimizer, conversationally=conversationally):
+                yield self.get_message(response)
+                
+        def for_non_stream():
+            return self.get_message(
+                self.ask(prompt, False, optimizer=optimizer, conversationally=conversationally)
+            )
+            
+        return for_stream() if stream else for_non_stream()
+
+    def get_message(self, response: dict) -> str:
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+if __name__ == "__main__":
+    from rich import print
+    ai = FreeAIChat(model="GPT-4o", logging=True)
+    response = ai.chat("Write a hello world program in Python", stream=True)
+    for chunk in response:
+        print(chunk, end="", flush=True)

webscout/Provider/yep.py

@@ -24,7 +24,7 @@ class YEPCHAT(Provider):
         AVAILABLE_MODELS (list): List of available models for the provider.
     """
 
-    AVAILABLE_MODELS = ["DeepSeek-R1-Distill-Qwen-32B"]
+    AVAILABLE_MODELS = ["DeepSeek-R1-Distill-Qwen-32B", "Mixtral-8x7B-Instruct-v0.1"]
 
     def __init__(
         self,

webscout/__init__.py

@@ -17,6 +17,7 @@ from .swiftcli import *
 from .litagent import LitAgent
 from .scout import *
 from .zeroart import *
+from .yep_search import *
 agent = LitAgent()
 
 __repo__ = "https://github.com/OE-LUCIFER/Webscout"

webscout/version.py

@@ -1,2 +1,2 @@
-__version__ = "7.2"
+__version__ = "7.3"
 __prog__ = "webscout"

webscout/webscout_search.py

@@ -1,6 +1,8 @@
 from __future__ import annotations
 
 # import logging
+import json
+from urllib.parse import quote
 import warnings
 from concurrent.futures import ThreadPoolExecutor
 from datetime import datetime, timezone
@@ -11,7 +13,7 @@ from random import choice, shuffle
 from threading import Event
 from time import sleep, time
 from types import TracebackType
-from typing import cast
+from typing import Any, cast
 
 import primp  # type: ignore
 
@@ -1140,4 +1142,82 @@ class WEBS:
         except Exception as e:
             raise e
 
-        return results
+        return results
+
+    def weather(
+        self,
+        location: str,
+        language: str = "en",
+    ) -> dict[str, Any]:
+        """Get weather information for a location from DuckDuckGo.
+
+        Args:
+            location: Location to get weather for.
+            language: Language code (e.g. 'en', 'es'). Defaults to "en".
+
+        Returns:
+            Dictionary containing weather data with structure described in docstring.
+
+        Raises:
+            WebscoutE: Base exception for webscout errors.
+            RatelimitE: Inherits from WebscoutE, raised for exceeding API request rate limits.
+            TimeoutE: Inherits from WebscoutE, raised for API request timeouts.
+        """
+        assert location, "location is mandatory"
+        lang = language.split('-')[0]
+        url = f"https://duckduckgo.com/js/spice/forecast/{quote(location)}/{lang}"
+        
+        resp = self._get_url("GET", url)
+        resp_text = resp.decode('utf-8')
+        
+        if "ddg_spice_forecast(" not in resp_text:
+            raise WebscoutE(f"No weather data found for {location}")
+        
+        json_text = resp_text[resp_text.find('(') + 1:resp_text.rfind(')')]
+        try:
+            result = json.loads(json_text)
+        except Exception as e:
+            raise WebscoutE(f"Error parsing weather JSON: {e}")
+        
+        if not result or 'currentWeather' not in result or 'forecastDaily' not in result:
+            raise WebscoutE(f"Invalid weather data format for {location}")
+        
+        formatted_data = {
+            "location": result["currentWeather"]["metadata"].get("ddg-location", "Unknown"),
+            "current": {
+                "condition": result["currentWeather"].get("conditionCode"),
+                "temperature_c": result["currentWeather"].get("temperature"),
+                "feels_like_c": result["currentWeather"].get("temperatureApparent"),
+                "humidity": result["currentWeather"].get("humidity"),
+                "wind_speed_ms": result["currentWeather"].get("windSpeed"),
+                "wind_direction": result["currentWeather"].get("windDirection"),
+                "visibility_m": result["currentWeather"].get("visibility"),
+            },
+            "daily_forecast": [],
+            "hourly_forecast": []
+        }
+
+        for day in result["forecastDaily"]["days"]:
+            formatted_data["daily_forecast"].append({
+                "date": datetime.fromisoformat(day["forecastStart"].replace("Z", "+00:00")).strftime("%Y-%m-%d"),
+                "condition": day["daytimeForecast"].get("conditionCode"),
+                "max_temp_c": day["temperatureMax"],
+                "min_temp_c": day["temperatureMin"],
+                "sunrise": datetime.fromisoformat(day["sunrise"].replace("Z", "+00:00")).strftime("%H:%M"),
+                "sunset": datetime.fromisoformat(day["sunset"].replace("Z", "+00:00")).strftime("%H:%M"),
+            })
+
+        if 'forecastHourly' in result and 'hours' in result['forecastHourly']:
+            for hour in result['forecastHourly']['hours']:
+                formatted_data["hourly_forecast"].append({
+                    "time": datetime.fromisoformat(hour["forecastStart"].replace("Z", "+00:00")).strftime("%H:%M"),
+                    "condition": hour.get("conditionCode"),
+                    "temperature_c": hour.get("temperature"),
+                    "feels_like_c": hour.get("temperatureApparent"),
+                    "humidity": hour.get("humidity"),
+                    "wind_speed_ms": hour.get("windSpeed"),
+                    "wind_direction": hour.get("windDirection"),
+                    "visibility_m": hour.get("visibility"),
+                })
+
+        return formatted_data

webscout/webscout_search_async.py

@@ -633,4 +633,61 @@ class AsyncWEBS:
             from_,
             to,
         )
-        return result
+        return result
+
+    async def aweather(
+        self,
+        location: str,
+        language: str = "en",
+    ) -> dict[str, Any]:
+        """Async version of weather information retrieval from DuckDuckGo.
+
+        Args:
+            location: Location to get weather for.
+            language: Language code (e.g. 'en', 'es'). Defaults to "en".
+
+        Returns:
+            Dictionary containing weather data with the following structure:
+            {
+                "location": str,
+                "current": {
+                    "condition": str,
+                    "temperature_c": float,
+                    "feels_like_c": float,
+                    "humidity": float,
+                    "wind_speed_ms": float,
+                    "wind_direction": float,
+                    "visibility_m": float
+                },
+                "daily_forecast": List[{
+                    "date": str,
+                    "condition": str,
+                    "max_temp_c": float,
+                    "min_temp_c": float,
+                    "sunrise": str,
+                    "sunset": str
+                }],
+                "hourly_forecast": List[{
+                    "time": str,
+                    "condition": str,
+                    "temperature_c": float,
+                    "feels_like_c": float,
+                    "humidity": float,
+                    "wind_speed_ms": float,
+                    "wind_direction": float,
+                    "visibility_m": float
+                }]
+            }
+
+        Raises:
+            WebscoutE: Base exception for webscout errors.
+            RatelimitE: Inherits from WebscoutE, raised for exceeding API request rate limits.
+            TimeoutE: Inherits from WebscoutE, raised for API request timeouts.
+        """
+        result = await self._loop.run_in_executor(
+            self._executor,
+            super().weather,
+            location,
+            language,
+        )
+        return result