webscout 6.1__tar.gz → 6.2b0__tar.gz

{webscout-6.1/webscout.egg-info → webscout-6.2b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.1
+Version: 6.2b0
 Summary: Search for anything using Google, DuckDuckGo, phind.com, Contains AI models, can transcribe yt videos, temporary email and phone number generation, has TTS support, webai (terminal gpt and open interpreter) and offline LLMs and more
 Author: OEvortex
 Author-email: helpingai5@gmail.com
@@ -22,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: docstring_inheritance
@@ -60,6 +61,7 @@ Requires-Dist: gradio_client
 Requires-Dist: psutil
 Requires-Dist: colorlog
 Requires-Dist: yaspin
+Requires-Dist: cerebras-cloud-sdk
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -265,90 +267,41 @@ weather = w.get("Qazigund")
 print(weather)
 ```
 
-## ✉️ Tempmail and 📞 Temp Number
+## ✉️ TempMail and VNEngine
 
-### Temp Number
-```python
-from rich.console import Console
-from webscout import tempid
-
-def main():
-    console = Console()
-    phone = tempid.TemporaryPhoneNumber()
-
-    try:
-        # Get a temporary phone number for a specific country (or random)
-        number = phone.get_number(country="Finland")
-        console.print(f"Your temporary phone number: [bold cyan]{number}[/bold cyan]")
-
-        # Pause execution briefly (replace with your actual logic)
-        # import time module
-        import time
-        time.sleep(30)  # Adjust the waiting time as needed
-
-        # Retrieve and print messages
-        messages = phone.get_messages(number)
-        if messages:
-            # Access individual messages using indexing:
-            console.print(f"[bold green]{messages[0].frm}:[/] {messages[0].content}")
-            # (Add more lines if you expect multiple messages)
-        else:
-            console.print("No messages received.")
-
-    except Exception as e:
-        console.print(f"[bold red]An error occurred: {e}")
-
-if __name__ == "__main__":
-    main()
-
-```
-
-### Tempmail
 ```python
+import json
 import asyncio
-from rich.console import Console
-from rich.table import Table
-from rich.text import Text
-from webscout import tempid
-
-async def main() -> None:
-    console = Console()
-    client = tempid.Client()
+from webscout import VNEngine
+from webscout import TempMail
+
+async def main():
+    vn = VNEngine()
+    countries = vn.get_online_countries()
+    if countries:
+        country = countries[0]['country']
+        numbers = vn.get_country_numbers(country)
+        if numbers:
+            number = numbers[0]['full_number']
+            inbox = vn.get_number_inbox(country, number)
+            
+            # Serialize inbox data to JSON string
+            json_data = json.dumps(inbox, ensure_ascii=False, indent=4)
+            
+            # Print with UTF-8 encoding
+            print(json_data)
     
-    try:
+    async with TempMail() as client:
         domains = await client.get_domains()
-        if not domains:
-            console.print("[bold red]No domains available. Please try again later.")
-            return
-
-        email = await client.create_email(domain=domains[0].name)
-        console.print(f"Your temporary email: [bold cyan]{email.email}[/bold cyan]")
-        console.print(f"Token for accessing the email: [bold cyan]{email.token}[/bold cyan]")
-
-        while True:
-            messages = await client.get_messages(email.email)
-            if messages is not None:
-                break
-
-        if messages:
-            table = Table(show_header=True, header_style="bold magenta")
-            table.add_column("From", style="bold cyan")
-            table.add_column("Subject", style="bold yellow")
-            table.add_column("Body", style="bold green")
-            for message in messages:
-                body_preview = Text(message.body_text if message.body_text else "No body")
-                table.add_row(message.email_from or "Unknown", message.subject or "No Subject", body_preview)
-            console.print(table)
-        else:
-            console.print("No messages found.")
-    
-    except Exception as e:
-        console.print(f"[bold red]An error occurred: {e}")
-    
-    finally:
-        await client.close()
+        print("Available Domains:", domains)
+        email_response = await client.create_email(alias="testuser")
+        print("Created Email:", email_response)
+        messages = await client.get_messages(email_response.email)
+        print("Messages:", messages)
+        await client.delete_email(email_response.email, email_response.token)
+        print("Email Deleted")
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     asyncio.run(main())
 ```
 
@@ -607,16 +560,6 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-## 🌐 WEBSX - Another Web Search Tool
-
-```python
-from webscout import WEBSX
-s = "Python development tools"
-
-result = WEBSX(s)
-
-print(result)
-```
 
 ## 🎭 ALL Acts
 
@@ -876,7 +819,7 @@ print(result)
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AmigoImager
+### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager
 
 **Every TTI provider has the same usage code, you just need to change the import.**
 
@@ -1133,29 +1076,6 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `BasedGPT` - Chat with GPT
-
-```python
-from webscout import BasedGPT
-
-# Initialize the BasedGPT provider
-basedgpt = BasedGPT(
-    is_conversation=True,  # Chat conversationally
-    max_tokens=600,  # Maximum tokens to generate
-    timeout=30,  # HTTP request timeout
-    intro="You are a helpful and friendly AI.",  # Introductory prompt
-    filepath="chat_history.txt",  # File to store conversation history
-    update_file=True,  # Update the chat history file
-)
-
-# Send a prompt to the AI
-prompt = "What is the meaning of life?"
-response = basedgpt.chat(prompt)
-
-# Print the AI's response
-print(response)
-```
-
 ###  `DeepSeek` - Chat with DeepSeek
 
 ```python
@@ -1437,7 +1357,7 @@ if __name__ == "__main__":
     main()
 ```
 
-###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, XDASH, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, AIGameIO, LlamaTutor, PromptRefine, AIUncensored, TutorAI, Bixin, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro
+###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, AIUncensored, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro
 
 Code is similar to other providers.
 
@@ -1588,7 +1508,7 @@ Webscout provides tools to convert and quantize Hugging Face models into the GGU
 **Example:**
 
 ```python
-from webscout import gguf
+from webscout.Extra import gguf
 """
 Valid quantization methods:
 "q2_k", "q3_k_l", "q3_k_m", "q3_k_s", 
@@ -1609,7 +1529,7 @@ gguf.convert(
 Webscout's `autollama` utility downloads a model from Hugging Face and then automatically makes it Ollama-ready.
 
 ```python
-from webscout import autollama
+from webscout.Extra import autollama
 
 model_path = "Vortex4ai/Jarvis-0.5B"
 gguf_file = "test2-q4_k_m.gguf"
@@ -1670,9 +1590,6 @@ Contributions are welcome! If you'd like to contribute to Webscout, please follo
 4. Push your branch to your forked repository.
 5. Submit a pull request to the main repository.
 
-## 📜 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 🙏 Acknowledgments
 

{webscout-6.1 → webscout-6.2b0}/README.md

@@ -193,90 +193,41 @@ weather = w.get("Qazigund")
 print(weather)
 ```
 
-## ✉️ Tempmail and 📞 Temp Number
+## ✉️ TempMail and VNEngine
 
-### Temp Number
-```python
-from rich.console import Console
-from webscout import tempid
-
-def main():
-    console = Console()
-    phone = tempid.TemporaryPhoneNumber()
-
-    try:
-        # Get a temporary phone number for a specific country (or random)
-        number = phone.get_number(country="Finland")
-        console.print(f"Your temporary phone number: [bold cyan]{number}[/bold cyan]")
-
-        # Pause execution briefly (replace with your actual logic)
-        # import time module
-        import time
-        time.sleep(30)  # Adjust the waiting time as needed
-
-        # Retrieve and print messages
-        messages = phone.get_messages(number)
-        if messages:
-            # Access individual messages using indexing:
-            console.print(f"[bold green]{messages[0].frm}:[/] {messages[0].content}")
-            # (Add more lines if you expect multiple messages)
-        else:
-            console.print("No messages received.")
-
-    except Exception as e:
-        console.print(f"[bold red]An error occurred: {e}")
-
-if __name__ == "__main__":
-    main()
-
-```
-
-### Tempmail
 ```python
+import json
 import asyncio
-from rich.console import Console
-from rich.table import Table
-from rich.text import Text
-from webscout import tempid
-
-async def main() -> None:
-    console = Console()
-    client = tempid.Client()
+from webscout import VNEngine
+from webscout import TempMail
+
+async def main():
+    vn = VNEngine()
+    countries = vn.get_online_countries()
+    if countries:
+        country = countries[0]['country']
+        numbers = vn.get_country_numbers(country)
+        if numbers:
+            number = numbers[0]['full_number']
+            inbox = vn.get_number_inbox(country, number)
+            
+            # Serialize inbox data to JSON string
+            json_data = json.dumps(inbox, ensure_ascii=False, indent=4)
+            
+            # Print with UTF-8 encoding
+            print(json_data)
     
-    try:
+    async with TempMail() as client:
         domains = await client.get_domains()
-        if not domains:
-            console.print("[bold red]No domains available. Please try again later.")
-            return
-
-        email = await client.create_email(domain=domains[0].name)
-        console.print(f"Your temporary email: [bold cyan]{email.email}[/bold cyan]")
-        console.print(f"Token for accessing the email: [bold cyan]{email.token}[/bold cyan]")
-
-        while True:
-            messages = await client.get_messages(email.email)
-            if messages is not None:
-                break
-
-        if messages:
-            table = Table(show_header=True, header_style="bold magenta")
-            table.add_column("From", style="bold cyan")
-            table.add_column("Subject", style="bold yellow")
-            table.add_column("Body", style="bold green")
-            for message in messages:
-                body_preview = Text(message.body_text if message.body_text else "No body")
-                table.add_row(message.email_from or "Unknown", message.subject or "No Subject", body_preview)
-            console.print(table)
-        else:
-            console.print("No messages found.")
-    
-    except Exception as e:
-        console.print(f"[bold red]An error occurred: {e}")
-    
-    finally:
-        await client.close()
+        print("Available Domains:", domains)
+        email_response = await client.create_email(alias="testuser")
+        print("Created Email:", email_response)
+        messages = await client.get_messages(email_response.email)
+        print("Messages:", messages)
+        await client.delete_email(email_response.email, email_response.token)
+        print("Email Deleted")
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     asyncio.run(main())
 ```
 
@@ -535,16 +486,6 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-## 🌐 WEBSX - Another Web Search Tool
-
-```python
-from webscout import WEBSX
-s = "Python development tools"
-
-result = WEBSX(s)
-
-print(result)
-```
 
 ## 🎭 ALL Acts
 
@@ -804,7 +745,7 @@ print(result)
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AmigoImager
+### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager
 
 **Every TTI provider has the same usage code, you just need to change the import.**
 
@@ -1061,29 +1002,6 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `BasedGPT` - Chat with GPT
-
-```python
-from webscout import BasedGPT
-
-# Initialize the BasedGPT provider
-basedgpt = BasedGPT(
-    is_conversation=True,  # Chat conversationally
-    max_tokens=600,  # Maximum tokens to generate
-    timeout=30,  # HTTP request timeout
-    intro="You are a helpful and friendly AI.",  # Introductory prompt
-    filepath="chat_history.txt",  # File to store conversation history
-    update_file=True,  # Update the chat history file
-)
-
-# Send a prompt to the AI
-prompt = "What is the meaning of life?"
-response = basedgpt.chat(prompt)
-
-# Print the AI's response
-print(response)
-```
-
 ###  `DeepSeek` - Chat with DeepSeek
 
 ```python
@@ -1365,7 +1283,7 @@ if __name__ == "__main__":
     main()
 ```
 
-###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, XDASH, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, AIGameIO, LlamaTutor, PromptRefine, AIUncensored, TutorAI, Bixin, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro
+###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, AIUncensored, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro
 
 Code is similar to other providers.
 
@@ -1516,7 +1434,7 @@ Webscout provides tools to convert and quantize Hugging Face models into the GGU
 **Example:**
 
 ```python
-from webscout import gguf
+from webscout.Extra import gguf
 """
 Valid quantization methods:
 "q2_k", "q3_k_l", "q3_k_m", "q3_k_s", 
@@ -1537,7 +1455,7 @@ gguf.convert(
 Webscout's `autollama` utility downloads a model from Hugging Face and then automatically makes it Ollama-ready.
 
 ```python
-from webscout import autollama
+from webscout.Extra import autollama
 
 model_path = "Vortex4ai/Jarvis-0.5B"
 gguf_file = "test2-q4_k_m.gguf"
@@ -1598,9 +1516,6 @@ Contributions are welcome! If you'd like to contribute to Webscout, please follo
 4. Push your branch to your forked repository.
 5. Submit a pull request to the main repository.
 
-## 📜 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 🙏 Acknowledgments
 

{webscout-6.1 → webscout-6.2b0}/setup.py

@@ -1,5 +1,6 @@
 from setuptools import setup, find_packages
 from webscout.version import __prog__, __version__
+
 with open("README.md", encoding="utf-8") as f:
     README = f.read()
 
@@ -12,6 +13,7 @@ setup(
     author="OEvortex",
     author_email="helpingai5@gmail.com",
     packages=find_packages(),
+    python_requires=">=3.7",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
@@ -63,7 +65,8 @@ setup(
         "gradio_client",
         "psutil",
         "colorlog",
-        "yaspin"
+        "yaspin",
+        "cerebras-cloud-sdk",
     ],
     entry_points={
         "console_scripts": [

webscout-6.2b0/webscout/AIauto.py

@@ -0,0 +1,176 @@
+from webscout.AIbase import Provider
+from webscout.g4f import GPT4FREE, TestProviders
+from webscout.exceptions import AllProvidersFailure
+from typing import Union, Any, Dict, Generator
+import importlib
+import pkgutil
+import logging
+import random
+import inspect
+
+def load_providers():
+    provider_map = {}
+    api_key_providers = set()
+    provider_package = importlib.import_module("webscout.Provider")
+    
+    for _, module_name, _ in pkgutil.iter_modules(provider_package.__path__):
+        try:
+            module = importlib.import_module(f"webscout.Provider.{module_name}")
+            for attr_name in dir(module):
+                attr = getattr(module, attr_name)
+                if isinstance(attr, type) and issubclass(attr, Provider) and attr != Provider:
+                    provider_map[attr_name.upper()] = attr
+                    # Check if the provider needs an API key
+                    if 'api_key' in inspect.signature(attr.__init__).parameters:
+                        api_key_providers.add(attr_name.upper())
+        except Exception as e:
+            logging.warning(f"Failed to load provider {module_name}: {e}")
+    
+    return provider_map, api_key_providers
+
+provider_map, api_key_providers = load_providers()
+
+class AUTO(Provider):
+    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,
+        exclude: list[str] = [],
+    ):
+        self.provider = None
+        self.provider_name = None
+        self.is_conversation = is_conversation
+        self.max_tokens = max_tokens
+        self.timeout = timeout
+        self.intro = intro
+        self.filepath = filepath
+        self.update_file = update_file
+        self.proxies = proxies
+        self.history_offset = history_offset
+        self.act = act
+        self.exclude = [e.upper() for e in exclude]
+
+    @property
+    def last_response(self) -> dict[str, Any]:
+        return self.provider.last_response if self.provider else {}
+
+    @property
+    def conversation(self) -> object:
+        return self.provider.conversation if self.provider else None
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+        run_new_test: bool = False,
+    ) -> Union[Dict, Generator]:
+        ask_kwargs = {
+            "prompt": prompt,
+            "stream": stream,
+            "raw": raw,
+            "optimizer": optimizer,
+            "conversationally": conversationally,
+        }
+
+        # Filter out API key required providers and excluded providers
+        available_providers = [
+            (name, cls) for name, cls in provider_map.items()
+            if name not in api_key_providers and name not in self.exclude
+        ]
+
+        # Shuffle the list of available providers
+        random.shuffle(available_providers)
+
+        # Try webscout-based providers
+        for provider_name, provider_class in available_providers:
+            try:
+                self.provider_name = f"webscout-{provider_name}"
+                self.provider = provider_class(
+                    is_conversation=self.is_conversation,
+                    max_tokens=self.max_tokens,
+                    timeout=self.timeout,
+                    intro=self.intro,
+                    filepath=self.filepath,
+                    update_file=self.update_file,
+                    proxies=self.proxies,
+                    history_offset=self.history_offset,
+                    act=self.act,
+                )
+
+                return self.provider.ask(**ask_kwargs)
+
+            except Exception as e:
+                logging.debug(
+                    f"Failed to generate response using provider {provider_name} - {e}"
+                )
+
+        # Try GPT4FREE providers
+        gpt4free_providers = TestProviders(timeout=self.timeout).get_results(run=run_new_test)
+        random.shuffle(gpt4free_providers)
+        
+        for provider_info in gpt4free_providers:
+            if provider_info["name"].upper() in self.exclude:
+                continue
+            try:
+                self.provider_name = f"g4f-{provider_info['name']}"
+                self.provider = GPT4FREE(
+                    provider=provider_info["name"],
+                    is_conversation=self.is_conversation,
+                    max_tokens=self.max_tokens,
+                    intro=self.intro,
+                    filepath=self.filepath,
+                    update_file=self.update_file,
+                    proxies=self.proxies,
+                    history_offset=self.history_offset,
+                    act=self.act,
+                )
+
+                print(f"Using provider: {self.provider_name}")
+                return self.provider.ask(**ask_kwargs)
+
+            except Exception as e:
+                logging.debug(
+                    f"Failed to generate response using GPT4FREE-based provider {provider_info['name']} - {e}"
+                )
+
+        raise AllProvidersFailure("None of the providers generated response successfully.")
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+        run_new_test: bool = False,
+    ) -> Union[str, Generator[str, None, None]]:
+        response = self.ask(
+            prompt,
+            stream,
+            optimizer=optimizer,
+            conversationally=conversationally,
+            run_new_test=run_new_test,
+        )
+        
+        if stream:
+            return (self.get_message(chunk) for chunk in response)
+        else:
+            return self.get_message(response)
+
+    def get_message(self, response: dict) -> str:
+        assert self.provider is not None, "Chat with AI first"
+        return self.provider.get_message(response)
+if __name__ == "__main__":
+    auto = AUTO()
+
+    response = auto.chat("Hello, how are you?")
+    print(response)

{webscout-6.1 → webscout-6.2b0}/webscout/Agents/functioncall.py

@@ -4,12 +4,12 @@ import json
 import time
 from typing import Any, Dict, Optional
 import requests
-from webscout import WEBS, Julius
+from webscout import WEBS, GEMINIAPI
 
 class FunctionCallingAgent:
     def __init__(self, 
                  tools: list = None):
-        self.ai = Julius(timeout=300, intro=None)
+        self.ai = GEMINIAPI(api_key="Gemini api key", timeout=300, intro=None)
         self.tools = tools if tools is not None else []
         self.knowledge_cutoff = "September 2022"