webscout 6.0__py3-none-any.whl → 6.2__py3-none-any.whl

{webscout-6.0.dist-info → webscout-6.2.dist-info}/METADATA

@@ -1,13 +1,12 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.0
+Version: 6.2
 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
 License: HelpingAI
-Project-URL: Documentation, https://github.com/OE-LUCIFER/Webscout/wiki
-Project-URL: Source, https://github.com/OE-LUCIFER/Webscout
-Project-URL: Tracker, https://github.com/OE-LUCIFER/Webscout/issues
+Project-URL: Source, https://github.com/HelpingAI/Webscout
+Project-URL: Tracker, https://github.com/HelpingAI/Webscout/issues
 Project-URL: YouTube, https://youtube.com/@OEvortex
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -22,6 +21,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
@@ -53,6 +53,14 @@ Requires-Dist: emoji
 Requires-Dist: openai
 Requires-Dist: prompt-toolkit
 Requires-Dist: fake-useragent
+Requires-Dist: primp
+Requires-Dist: pyreqwest-impersonate
+Requires-Dist: lxml-html-clean
+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"
@@ -61,12 +69,13 @@ Requires-Dist: llama-cpp-python; extra == "local"
 Requires-Dist: colorama; extra == "local"
 Requires-Dist: numpy; extra == "local"
 Requires-Dist: huggingface-hub[cli]; extra == "local"
+Requires-Dist: unicorn; extra == "local"
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/devsdocode"><img alt="Telegram" src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
-  <a href="https://www.instagram.com/sree.shades_/"><img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"></a>
-  <a href="https://www.linkedin.com/in/developer-sreejan/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
+  <a href="https://t.me/official_helpingai"><img alt="Telegram" src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  <a href="https://www.instagram.com/oevortex/"><img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"></a>
+  <a href="https://www.linkedin.com/in/oe-vortex-29a407265/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
   <a href="https://buymeacoffee.com/oevortex"><img alt="Buy Me A Coffee" src="https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black"></a>
 </div>
 
@@ -257,90 +266,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())
 ```
 
@@ -599,16 +559,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
 
@@ -868,7 +818,7 @@ print(result)
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimagger, NexraImager, HFimager, ArtbitImager
+### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager, TalkaiImager
 
 **Every TTI provider has the same usage code, you just need to change the import.**
 
@@ -897,7 +847,7 @@ voicepods.play_audio(audio_file)
 
 ```python
 from webscout import WEBS as w
-R = w().chat("Who are you", model='gpt-4o-mini') # GPT-3.5 Turbo, mixtral-8x7b, llama-3-70b, claude-3-haiku, gpt-4o-mini
+R = w().chat("Who are you", model='gpt-4o-mini') # mixtral-8x7b, llama-3.1-70b, claude-3-haiku, gpt-4o-mini
 print(R)
 ```
 
@@ -1125,29 +1075,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
@@ -1316,117 +1243,120 @@ print(a.chat("HelpingAI-9B"))
 ```python
 import json
 import logging
-from webscout import LLAMA3, WEBS
+from webscout import Julius, WEBS
 from webscout.Agents.functioncall import FunctionCallingAgent
+from rich import print
 
-# Define tools that the agent can use
-tools = [
-    {
-        "type": "function",
-        "function": {
-            "name": "UserDetail",
-            "parameters": {
-                "type": "object",
-                "title": "UserDetail",
-                "properties": {
-                    "name": {
-                        "title": "Name",
-                        "type": "string"
+class FunctionExecutor:
+    def __init__(self, llama):
+        self.llama = llama
+
+    def execute_web_search(self, arguments):
+        query = arguments.get("query")
+        if not query:
+            return "Please provide a search query."
+        with WEBS() as webs:
+            search_results = webs.text(query, max_results=5)
+        prompt = (
+            f"Based on the following search results:\n\n{search_results}\n\n"
+            f"Question: {query}\n\n"
+            "Please provide a comprehensive answer to the question based on the search results above. "
+            "Include relevant webpage URLs in your answer when appropriate. "
+            "If the search results don't contain relevant information, please state that and provide the best answer you can based on your general knowledge."
+        )
+        return self.llama.chat(prompt)
+
+    def execute_general_ai(self, arguments):
+        question = arguments.get("question")
+        if not question:
+            return "Please provide a question."
+        return self.llama.chat(question)
+
+    def execute_UserDetail(self, arguments):
+        name = arguments.get("name")
+        age = arguments.get("age")
+        return f"User details - Name: {name}, Age: {age}"
+
+def main():
+    tools = [
+        {
+            "type": "function",
+            "function": {
+                "name": "UserDetail",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "age": {"title": "Age", "type": "integer"}
                     },
-                    "age": {
-                        "title": "Age",
-                        "type": "integer"
-                    }
-                },
-                "required": ["name", "age"]
+                    "required": ["name", "age"]
+                }
             }
-        }
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "web_search",
-            "description": "Search query on google",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "query": {
-                        "type": "string",
-                        "description": "web search query"
-                    }
-                },
-                "required": ["query"]
+        },
+        {
+            "type": "function",
+            "function": {
+                "name": "web_search",
+                "description": "Search the web for information using Google Search.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "query": {
+                            "type": "string",
+                            "description": "The search query to be executed."
+                        }
+                    },
+                    "required": ["query"]
+                }
             }
-        }
-    },
-    {  # New general AI tool
-        "type": "function",
-        "function": {
-            "name": "general_ai",
-            "description": "Use general AI knowledge to answer the question",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "question": {
-                        "type": "string",
-                        "description": "The question to answer"
-                    }
-                },
-                "required": ["question"]
+        },
+        {
+            "type": "function",
+            "function": {
+                "name": "general_ai",
+                "description": "Use general AI knowledge to answer the question",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "question": {"type": "string", "description": "The question to answer"}
+                    },
+                    "required": ["question"]
+                }
             }
         }
-    }
-]
+    ]
 
-# Initialize the FunctionCallingAgent with the specified tools
-agent = FunctionCallingAgent(tools=tools)
-llama = LLAMA3()
-from rich import print
-# Input message from the user
-user = input(">>> ")
-message = user
-function_call_data = agent.function_call_handler(message)
-print(f"Function Call Data: {function_call_data}")
-
-# Check for errors in the function call data
-if "error" not in function_call_data:
-    function_name = function_call_data.get("tool_name")  # Use 'tool_name' instead of 'name'
-    if function_name == "web_search":
-        arguments = function_call_data.get("tool_input", {})  # Get tool input arguments
-        query = arguments.get("query")
-        if query:
-            with WEBS() as webs:
-                search_results = webs.text(query, max_results=5) 
-            prompt = (
-                f"Based on the following search results:\n\n{search_results}\n\n"
-                f"Question: {user}\n\n"
-                "Please provide a comprehensive answer to the question based on the search results above. "
-                "Include relevant webpage URLs in your answer when appropriate. "
-                "If the search results don't contain relevant information, please state that and provide the best answer you can based on your general knowledge."
-            )
-            response = llama.chat(prompt)
-            for c in response:
-                print(c, end="", flush=True)
+    agent = FunctionCallingAgent(tools=tools)
+    llama = Julius()
+    function_executor = FunctionExecutor(llama)
 
+    user_input = input(">>> ")
+    function_call_data = agent.function_call_handler(user_input)
+    print(f"Function Call Data: {function_call_data}")
+
+    try:
+        if "error" not in function_call_data:
+            function_name = function_call_data.get("tool_name")
+            arguments = function_call_data.get("tool_input", {})
+
+            execute_function = getattr(function_executor, f"execute_{function_name}", None)
+            if execute_function:
+                result = execute_function(arguments)
+                print("Function Execution Result:")
+                for c in result:
+                    print(c, end="", flush=True)
+            else:
+                print(f"Unknown function: {function_name}")
         else:
-            print("Please provide a search query.")
-    elif function_name == "general_ai":  # Handle general AI tool
-        arguments = function_call_data.get("tool_input", {})
-        question = arguments.get("question")
-        if question:
-            response = llama.chat(question)  # Use LLM directly
-            for c in response:
-                print(c, end="", flush=True)
-        else:
-            print("Please provide a question.")
-    else:
-        result = agent.execute_function(function_call_data)
-        print(f"Function Execution Result: {result}") 
-else:
-    print(f"Error: {function_call_data['error']}")
+            print(f"Error: {function_call_data['error']}")
+    except Exception as e:
+        print(f"An error occurred: {str(e)}")
+
+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
+###  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, Talkai, LLMChat
 
 Code is similar to other providers.
 
@@ -1465,24 +1395,16 @@ Webscout can now run GGUF models locally. You can download and run your favorite
 **Example:**
 
 ```python
-from webscout.Local.utils import download_model
-from webscout.Local.model import Model
-from webscout.Local.thread import Thread
-from webscout.Local import formats
-
-# 1. Download the model
-repo_id = "microsoft/Phi-3-mini-4k-instruct-gguf"  # Replace with the desired Hugging Face repo
-filename = "Phi-3-mini-4k-instruct-q4.gguf" # Replace with the correct filename
-model_path = download_model(repo_id, filename, token="")
-
-# 2. Load the model 
-model = Model(model_path, n_gpu_layers=4)  
-
-# 3. Create a Thread for conversation
-thread = Thread(model, formats.phi3)
-
-# 4. Start interacting with the model
-thread.interact()
+from webscout.Local import *
+model_path = download_model("Qwen/Qwen2.5-0.5B-Instruct-GGUF", "qwen2.5-0.5b-instruct-q2_k.gguf", token=None)
+model = Model(model_path, n_gpu_layers=0, context_length=2048)
+thread = Thread(model, format=chatml)
+# print(thread.send("hi")) #send a single msg to ai
+
+# thread.interact() # interact with the model in terminal
+# start webui
+# webui = WebUI(thread)
+# webui.start(host="0.0.0.0", port=8080, ssl=True) #Use ssl=True and make cert and key for https
 ```
 
 ## 🐶 Local-rawdog
@@ -1585,7 +1507,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", 
@@ -1606,7 +1528,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"
@@ -1640,9 +1562,9 @@ python -m webscout.webai webai --provider "phind" --rawdog
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/devsdocode"><img alt="Telegram" src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
-  <a href="https://www.instagram.com/sree.shades_/"><img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"></a>
-  <a href="https://www.linkedin.com/in/developer-sreejan/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
+  <a href="https://t.me/official_helpingai"><img alt="Telegram" src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  <a href="https://www.instagram.com/oevortex/"><img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white"></a>
+  <a href="https://www.linkedin.com/in/oe-vortex-29a407265/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
   <a href="https://buymeacoffee.com/oevortex"><img alt="Buy Me A Coffee" src="https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black"></a>
 </div>
 
@@ -1667,9 +1589,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