webscout 6.3__py3-none-any.whl → 6.4__py3-none-any.whl

webscout/Provider/RoboCoders.py

@@ -0,0 +1,206 @@
+import requests
+import json
+from typing import Any, Dict, Optional, Generator, Union
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+
+
+class RoboCoders(Provider):
+    """
+    A class to interact with the RoboCoders API.
+    """
+
+    api_endpoint = "https://api.robocoders.ai/chat"
+    working = True
+    supports_message_history = True
+    default_model = "GeneralCodingAgent"
+    agent = [default_model, "RepoAgent", "FrontEndAgent"]
+    models = [*agent]
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 600,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = default_model,
+        system_prompt: str = "You are a helpful coding assistant.",
+    ):
+        """Initializes the RoboCoders API client."""
+        if model not in self.models:
+            raise ValueError(f"Invalid model: {model}. Choose from: {', '.join(self.models)}")
+
+        self.session = requests.Session()
+        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.headers = {"Content-Type": "application/json"}
+        self.access_token = self._get_access_token()  # Get token on initialization
+        if not self.access_token:
+            raise exceptions.AuthenticationError("Failed to get access token")
+
+        self.session_id = self._create_session()  # Create session on initialization
+        if not self.session_id:
+            raise exceptions.SessionCreationError("Failed to create session")
+
+        self.headers["Authorization"] = f"Bearer {self.access_token}"
+
+        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.session.proxies = proxies
+
+    def _get_access_token(self) -> Optional[str]:
+        """Get access token for authentication."""
+        url_auth = "https://api.robocoders.ai/auth"
+        headers_auth = {
+            "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+            "accept-language": "en-US,en;q=0.9",
+            "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
+        }
+        try:
+            response = self.session.get(url_auth, headers=headers_auth, timeout=self.timeout)
+            response.raise_for_status() # Raise exception for HTTP errors
+            text = response.text
+            return text.split('id="token">')[1].split("</pre>")[0].strip()
+        except (requests.exceptions.RequestException, IndexError) as e:
+            raise exceptions.APIConnectionError(f"Failed to get access token: {e}")
+
+
+    def _create_session(self) -> Optional[str]:
+        """Create a new chat session."""
+        url_create_session = "https://api.robocoders.ai/create-session"
+        headers_create_session = {"Authorization": f"Bearer {self.access_token}"}
+        try:
+            response = self.session.get(url_create_session, headers=headers_create_session, timeout=self.timeout)
+            response.raise_for_status()
+            data = response.json()
+            return data.get("sid")
+        except requests.exceptions.RequestException as e:
+            raise exceptions.APIConnectionError(f"Failed to create session: {e}")
+
+
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Union[Dict, Generator[str, None, None]]:
+        """
+        Sends a prompt to the RoboCoders API and returns the response.
+        """
+        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 exceptions.FailedToGenerateResponseError(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        data = {
+            "sid": self.session_id,
+            "prompt": conversation_prompt,
+            "agent": self.model,
+        }
+
+        def generate_chunks():
+            response = self._make_request(
+                "POST", self.api_endpoint, headers=self.headers, json=data, stream=True
+            )
+            for line in response.iter_lines():
+                if line:
+                    try:
+                        response_data = json.loads(line)
+                        message = response_data.get("message", "")
+                        if message:
+                            yield message
+                    except json.JSONDecodeError:
+                        pass  # Handle or log the error as needed
+
+        if stream:
+            streaming_text = ""
+            for chunk in generate_chunks():
+                streaming_text += chunk
+                yield chunk if raw else {"text": chunk}
+            self.last_response.update({"text": streaming_text}) #Update last_response
+            self.conversation.update_chat_history(prompt, streaming_text)
+        else:
+            full_response = "".join(generate_chunks())
+            self.last_response.update({"text": full_response})
+            self.conversation.update_chat_history(prompt, full_response)
+            return self.last_response
+
+    def _make_request(self, method: str, url: str, **kwargs) -> requests.Response:
+        try:
+            response = self.session.request(
+                method, url, timeout=self.timeout, **kwargs
+            )
+            response.raise_for_status()
+            return response
+        except requests.exceptions.RequestException as e:
+            raise exceptions.APIConnectionError(f"Failed to make request: {e}") from e
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Union[str, Generator[str, None, None]]:
+        """Generate response string or stream."""
+
+        if stream:
+            gen = self.ask(
+                prompt, stream=True, optimizer=optimizer, conversationally=conversationally
+            )
+            for chunk in gen:
+                yield self.get_message(chunk)
+        else:
+            return self.get_message(
+                self.ask(prompt, stream=False, optimizer=optimizer, conversationally=conversationally)
+            )
+
+    def get_message(self, response: Dict[str, Any]) -> str:
+        """Retrieves message from response."""
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+
+if __name__ == "__main__":
+    from rich import print
+    ai = RoboCoders(model="GeneralCodingAgent")
+    response = ai.chat("Can you help me with Python programming?", stream=True)
+    for chunk in response:
+        print(chunk, end='', flush=True)

webscout/Provider/TTI/AiForce/__init__.py

@@ -0,0 +1,22 @@
+"""
+AiForce - Your go-to provider for generating fire images! 🔥
+
+Examples:
+    >>> # Sync Usage
+    >>> from webscout import AiForceimager
+    >>> provider = AiForceimager()
+    >>> images = provider.generate("Cool art")
+    >>> paths = provider.save(images)
+    >>>
+    >>> # Async Usage
+    >>> from webscout import AsyncAiForceimager
+    >>> async def example():
+    ...     provider = AsyncAiForceimager()
+    ...     images = await provider.generate("Epic dragon")
+    ...     paths = await provider.save(images)
+"""
+
+from .sync_aiforce import AiForceimager
+from .async_aiforce import AsyncAiForceimager
+
+__all__ = ["AiForceimager", "AsyncAiForceimager"]

webscout/Provider/TTI/AiForce/async_aiforce.py

@@ -0,0 +1,257 @@
+import aiohttp
+import asyncio
+import os
+import time
+from typing import List, Optional, Union, AsyncGenerator
+from string import punctuation
+from random import choice
+from aiohttp import ClientError
+from pathlib import Path
+
+from webscout.AIbase import AsyncImageProvider
+from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
+from webscout.litagent import LitAgent
+
+# Initialize our fire logger and agent 🔥
+logger = LitLogger(
+    "AsyncAiForce",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+agent = LitAgent()
+
+class AsyncAiForceimager(AsyncImageProvider):
+    """Your go-to async provider for generating fire images with AiForce! ⚡
+
+    Examples:
+        >>> # Basic usage
+        >>> provider = AsyncAiForceimager()
+        >>> async def example():
+        ...     images = await provider.generate("Cool art")
+        ...     paths = await provider.save(images)
+        >>>
+        >>> # Advanced usage
+        >>> provider = AsyncAiForceimager(timeout=120)
+        >>> async def example():
+        ...     images = await provider.generate(
+        ...         prompt="Epic dragon",
+        ...         amount=3,
+        ...         model="Flux-1.1-Pro",
+        ...         width=1024,
+        ...         height=1024
+        ...     )
+        ...     paths = await provider.save(images, name="dragon", dir="my_art")
+    """
+
+    AVAILABLE_MODELS = [
+        "stable-diffusion-xl-lightning",
+        "stable-diffusion-xl-base",
+        "Flux-1.1-Pro",
+        "ideogram",
+        "flux",
+        "flux-realism",
+        "flux-anime",
+        "flux-3d",
+        "flux-disney",
+        "flux-pixel",
+        "flux-4o",
+        "any-dark"
+    ]
+
+    def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
+        """Initialize your async AiForce provider with custom settings! ⚙️
+
+        Args:
+            timeout (int): Request timeout in seconds (default: 60)
+            proxies (dict): Proxy settings for requests (default: {})
+            logging (bool): Enable fire logging (default: True)
+        """
+        self.api_endpoint = "https://api.airforce/imagine2"
+        self.headers = {
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+            "Accept-Language": "en-US,en;q=0.5",
+            "Accept-Encoding": "gzip, deflate",
+            "User-Agent": agent.random()
+        }
+        self.timeout = timeout
+        self.proxies = proxies
+        self.prompt: str = "AI-generated image - webscout"
+        self.image_extension: str = "png"
+        self.logging = logging
+        if self.logging:
+            logger.info("AsyncAiForce provider initialized! 🚀")
+
+    async def generate(
+        self, 
+        prompt: str, 
+        amount: int = 1, 
+        additives: bool = True,
+        model: str = "Flux-1.1-Pro", 
+        width: int = 768, 
+        height: int = 768, 
+        seed: Optional[int] = None,
+        max_retries: int = 3, 
+        retry_delay: int = 5
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt asynchronously! ⚡
+
+        Examples:
+            >>> provider = AsyncAiForceimager()
+            >>> async def example():
+            ...     # Basic usage
+            ...     images = await provider.generate("Cool art")
+            ...     # Advanced usage
+            ...     images = await provider.generate(
+            ...         prompt="Epic dragon",
+            ...         amount=3,
+            ...         model="Flux-1.1-Pro"
+            ...     )
+
+        Args:
+            prompt (str): Your image description
+            amount (int): How many images you want (default: 1)
+            additives (bool): Make each prompt unique (default: True)
+            model (str): Model to use - check AVAILABLE_MODELS (default: "Flux-1.1-Pro")
+            width (int): Image width (default: 768)
+            height (int): Image height (default: 768)
+            seed (int, optional): Seed for reproducible results
+            max_retries (int): Max retry attempts if something fails (default: 3)
+            retry_delay (int): Seconds to wait between retries (default: 5)
+
+        Returns:
+            List[bytes]: Your generated images
+
+        Raises:
+            ValueError: If the inputs ain't valid
+            ClientError: If the API calls fail after retries
+        """
+        assert bool(prompt), "Prompt cannot be null"
+        assert isinstance(amount, int), f"Amount should be an integer only not {type(amount)}"
+        assert amount > 0, "Amount should be greater than 0"
+        assert model in self.AVAILABLE_MODELS, f"Model should be one of {self.AVAILABLE_MODELS}"
+
+        ads = lambda: (
+            ""
+            if not additives
+            else choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+        )
+
+        self.prompt = prompt
+        response = []
+        
+        if self.logging:
+            logger.info(f"Generating {amount} images with {model}... 🎨")
+        
+        async with aiohttp.ClientSession(headers=self.headers) as session:
+            for i in range(amount):
+                url = f"{self.api_endpoint}?model={model}&prompt={prompt}&size={width}:{height}"
+                if seed:
+                    url += f"&seed={seed}"
+                
+                for attempt in range(max_retries):
+                    try:
+                        async with session.get(url, timeout=self.timeout, proxy=self.proxies.get('http')) as resp:
+                            resp.raise_for_status()
+                            response.append(await resp.read())
+                            if self.logging:
+                                logger.success(f"Generated image {i + 1}/{amount}! 🎨")
+                            break
+                    except ClientError as e:
+                        if attempt == max_retries - 1:
+                            if self.logging:
+                                logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
+                            raise
+                        else:
+                            if self.logging:
+                                logger.warning(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
+                            await asyncio.sleep(retry_delay)
+
+        if self.logging:
+            logger.success("Images generated successfully! 🎉")
+        return response
+
+    async def save(
+        self,
+        response: Union[AsyncGenerator[bytes, None], List[bytes]],
+        name: Optional[str] = None,
+        dir: Optional[Union[str, Path]] = None,
+        filenames_prefix: str = "",
+    ) -> List[str]:
+        """Save your fire generated images asynchronously! 💾
+
+        Examples:
+            >>> provider = AsyncAiForceimager()
+            >>> async def example():
+            ...     images = await provider.generate("Cool art")
+            ...     # Save with default settings
+            ...     paths = await provider.save(images)
+            ...     # Save with custom name and directory
+            ...     paths = await provider.save(
+            ...         images,
+            ...         name="my_art",
+            ...         dir="my_images",
+            ...         filenames_prefix="test_"
+            ...     )
+
+        Args:
+            response (Union[AsyncGenerator[bytes, None], List[bytes]]): Your generated images
+            name (Optional[str]): Custom name for your images
+            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
+            filenames_prefix (str): Prefix for your image files
+
+        Returns:
+            List[str]: Paths to your saved images
+        """
+        save_dir = dir if dir else os.getcwd()
+        if not os.path.exists(save_dir):
+            os.makedirs(save_dir)
+            if self.logging:
+                logger.info(f"Created directory: {save_dir} 📁")
+
+        name = self.prompt if name is None else name
+        saved_paths = []
+        timestamp = int(time.time())
+        
+        if self.logging:
+            logger.info(f"Saving {len(response)} images... 💾")
+        
+        async def save_single_image(image_bytes: bytes, index: int) -> str:
+            filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
+            filepath = os.path.join(save_dir, filename)
+            
+            # Write file using asyncio
+            async with asyncio.Lock():
+                with open(filepath, "wb") as f:
+                    f.write(image_bytes)
+            
+            if self.logging:
+                logger.success(f"Saved image to: {filepath} 💾")
+            return filepath
+
+        # Handle both List[bytes] and AsyncGenerator
+        if isinstance(response, list):
+            image_list = response
+        else:
+            image_list = [chunk async for chunk in response]
+
+        tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
+        saved_paths = await asyncio.gather(*tasks)
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return saved_paths
+
+if __name__ == "__main__":
+    async def main():
+        bot = AsyncAiForceimager()
+        try:
+            resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
+            paths = await bot.save(resp)
+            print(paths)
+        except Exception as e:
+            logger.error(f"An error occurred: {e} 😢")
+
+    asyncio.run(main())