webscout 1.3.9__tar.gz → 1.4.1__tar.gz

{webscout-1.3.9 → webscout-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 1.3.9
+Version: 1.4.1
 Summary: Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.com, etc Also containes AI models, can transcribe yt videos, have TTS support and now has webai(terminal gpt and open interpeter) support
 Author: OEvortex
 Author-email: helpingai5@gmail.com
@@ -47,7 +47,8 @@ Requires-Dist: tiktoken
 Requires-Dist: tldextract
 Requires-Dist: orjson
 Requires-Dist: PyYAML
-Requires-Dist: appdirsGoogleBard1>=2.1.4
+Requires-Dist: appdirs
+Requires-Dist: GoogleBard1>=2.1.4
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -58,7 +59,7 @@ Requires-Dist: pytest>=7.4.2; extra == "dev"
 <a href="#"><img alt="Python version" src="https://img.shields.io/pypi/pyversions/webscout"/></a>
 <a href="https://pepy.tech/project/webscout"><img alt="Downloads" src="https://static.pepy.tech/badge/webscout"></a>
 
-Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.com, etc Also containes AI models, can transcribe yt videos, have TTS support and now has webai(terminal gpt and open interpeter) support
+Search for anything using the Google, DuckDuckGo, phind.com. Also containes AI models, can transcribe yt videos, temporary email and phone number generation, have TTS support and webai(terminal gpt and open interpeter)
 
 
 ## Table of Contents
@@ -68,6 +69,9 @@ Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.co
   - [CLI version](#cli-version)
   - [CLI to use LLM](#cli-to-use-llm)
   - [Regions](#regions)
+  - [Tempmail and Temp number](#tempmail-and-temp-number)
+    - [Temp number](#temp-number)
+    - [Tempmail](#tempmail)
   - [Transcriber](#transcriber)
   - [DeepWEBS: Advanced Web Searches](#deepwebs-advanced-web-searches)
     - [Activating DeepWEBS](#activating-deepwebs)
@@ -90,7 +94,7 @@ Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.co
   - [usage of webscout.AI](#usage-of-webscoutai)
     - [1. `PhindSearch` - Search using Phind.com](#1-phindsearch---search-using-phindcom)
     - [2. `YepChat` - Chat with mistral 8x7b powered by yepchat](#2-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
-    - [3. `You.com` - search with you.com](#3-youcom---search-with-youcom)
+    - [3. `You.com` - search with you.com -NOT WORKING](#3-youcom---search-with-youcom--not-working)
     - [4. `Gemini` - search with google gemini](#4-gemini---search-with-google-gemini)
   - [usage of image generator from Webscout.AI](#usage-of-image-generator-from-webscoutai)
     - [5. `Prodia` - make image using prodia](#5-prodia---make-image-using-prodia)
@@ -102,6 +106,7 @@ Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.co
     - [11. `Cohere` - chat with cohere](#11-cohere---chat-with-cohere)
     - [`LLM`](#llm)
     - [`LLM` with internet](#llm-with-internet)
+    - [LLM with deepwebs](#llm-with-deepwebs)
   - [`Webai` - terminal gpt and a open interpeter](#webai---terminal-gpt-and-a-open-interpeter)
 
 ## Install
@@ -211,7 +216,91 @@ ___
 
 [Go To TOP](#TOP)
 
+## Tempmail and Temp number
 
+### 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 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()
+    
+    try:
+        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()
+
+if __name__ == '__main__':
+    asyncio.run(main())
+```
 ## Transcriber
 The transcriber function in webscout is a handy tool that transcribes YouTube videos. Here's an example code demonstrating its usage:
 ```python
@@ -483,19 +572,47 @@ with WEBS() as WEBS:
 
 ```python
 from webscout import WEBS
+import datetime
+
+def fetch_news(keywords, timelimit):
+    news_list = []
+    with WEBS() as webs_instance:
+        WEBS_news_gen = webs_instance.news(
+            keywords,
+            region="wt-wt",
+            safesearch="off",
+            timelimit=timelimit,
+            max_results=20
+        )
+        for r in WEBS_news_gen:
+            # Convert the date to a human-readable format using datetime
+            r['date'] = datetime.datetime.fromisoformat(r['date']).strftime('%B %d, %Y')
+            news_list.append(r)
+    return news_list
+
+def _format_headlines(news_list, max_headlines: int = 100):
+    headlines = []
+    for idx, news_item in enumerate(news_list):
+        if idx >= max_headlines:
+            break
+        new_headline = f"{idx + 1}. {news_item['title'].strip()} "
+        new_headline += f"(URL: {news_item['url'].strip()}) "
+        new_headline += f"{news_item['body'].strip()}"
+        new_headline += "\n"
+        headlines.append(new_headline)
+
+    headlines = "\n".join(headlines)
+    return headlines
+
+# Example usage
+keywords = 'latest AI news'
+timelimit = 'd'
+news_list = fetch_news(keywords, timelimit)
+
+# Format and print the headlines
+formatted_headlines = _format_headlines(news_list)
+print(formatted_headlines)
 
-# News search for the keyword 'holiday' using DuckDuckGo.com and yep.com
-with WEBS() as WEBS:
-    keywords = 'holiday'
-    WEBS_news_gen = WEBS.news(
-      keywords,
-      region="wt-wt",
-      safesearch="off",
-      timelimit="m",
-      max_results=20
-    )
-    for r in WEBS_news_gen:
-        print(r)
 ```
 
 ### 6. `maps()` - map search by DuckDuckGo.com and
@@ -552,26 +669,22 @@ message = ph.get_message(response)
 print(message)
 ```
 ### 2. `YepChat` - Chat with mistral 8x7b powered by yepchat
-Thanks To Divyansh Shukla for This code
 ```python
-from webscout.AI import YepChat
+from webscout.AI import YEPCHAT
 
-def main():
-    # Initialize the YepChat class with your message
-    yep_chat = YepChat(message="who is pm of india")
-    
-    # Send the request and process the response
-    response = yep_chat.send_request()
-    processed_response = yep_chat.process_response(response)
-    
-    # Print the processed response
-    print(processed_response)
+# Instantiate the YEPCHAT class with default parameters
+YEPCHAT = YEPCHAT()
+
+# Define a prompt to send to the AI
+prompt = "What is the capital of France?"
+
+# Use the 'cha' method to get a response from the AI
+r = YEPCHAT.chat(prompt)
+print(r)
 
-if __name__ == "__main__":
-    main()
 ```
 
-### 3. `You.com` - search with you.com
+### 3. `You.com` - search with you.com -NOT WORKING
 ```python
 from webscout.AI import youChat
 
@@ -597,15 +710,34 @@ while True:
 ### 4. `Gemini` - search with google gemini
 
 ```python
-from webscout.AI import Gemini
+import webscout
+from webscout.AI import GEMINI
 
-# Create an instance of the Gemini class
-gemini = Gemini()
+# Replace with the path to your bard.google.com.cookies.json file
+COOKIE_FILE = "path/to/bard.google.com.cookies.json"
 
-# Use the chat method to send a message to the Gemini assistant
-response = gemini.chat("Your message here")
+# Optional: Provide proxy details if needed
+PROXIES = {
+    "http": "http://proxy_server:port",
+    "https": "https://proxy_server:port",
+}
 
-# Print the response from the Gemini assistant
+# Initialize GEMINI with cookie file and optional proxies
+gemini = GEMINI(cookie_file=COOKIE_FILE, proxy=PROXIES)
+
+# Ask a question and print the response
+response = gemini.chat("What is the meaning of life?")
+print(response)
+
+# Ask another question, this time streaming the response
+for chunk in gemini.chat("Tell me a story", stream=True):
+    print(chunk, end="")
+
+# Reset the conversation to start a new interaction
+gemini.reset()
+
+# Ask a question with the code optimizer
+response = gemini.chat("Write Python code to print 'Hello, world!'", optimizer="code")
 print(response)
 ```
 ##  usage of image generator from Webscout.AI
@@ -637,17 +769,18 @@ ai = BLACKBOXAI(
     model=None # You can specify a model if needed
 )
 
-# Define a prompt to send to the AI
-prompt = "Tell me about india"
-
-# Use the 'ask' method to send the prompt and receive a response
-response = ai.ask(prompt)
-
-# Extract the text from the response
-response_text = ai.get_message(response)
-
-# Print the response text
-print(response_text)
+# Start an infinite loop for continuous interaction
+while True:
+    # Define a prompt to send to the AI
+    prompt = input("Enter your prompt: ")
+    
+    # Check if the user wants to exit the loop
+    if prompt.lower() == "exit":
+        break
+    
+    # Use the 'chat' method to send the prompt and receive a response
+    r = ai.chat(prompt)
+    print(r)
 ```
 ### 7. `PERPLEXITY` - Search With PERPLEXITY
 ```python
@@ -665,10 +798,12 @@ print(response)
 from webscout.AI import OPENGPT
 
 opengpt = OPENGPT(is_conversation=True, max_tokens=8000, timeout=30)
-# This example sends a simple greeting and prints the response
-prompt = "tell me about india"
-response_str = opengpt.chat(prompt)
-print(response_str)
+while True:
+    # Prompt the user for input
+    prompt = input("Enter your prompt: ")
+    # Send the prompt to the OPENGPT model and print the response
+    response_str = opengpt.chat(prompt)
+    print(response_str)
 ```
 ### 9. `KOBOLDIA` - 
 ```python
@@ -711,7 +846,7 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-### `LLM`
+### `LLM` 
 ```python
 from webscout.LLM import LLM
 
@@ -742,23 +877,19 @@ while True:
 from __future__ import annotations
 from typing import List, Optional
 
-from webscout import LLM
+from webscout.LLM import LLM
 from webscout import WEBS
 import warnings
 
 system_message: str = (
-    "As AI, you possess internet access and are capable of executing real-time web searches based on user inputs. "
-    "You shall utilize this capability to enrich conversations, offer informed insights, and augment your ability to "
-    "respond accurately and thoroughly. However, refrain from stating 'You have provided a list of strings,' ensuring "
-    "seamless interactions with users. Embrace a responsive demeanor, harnessing available online resources to address "
-    "queries, share pertinent content, and facilitate meaningful exchanges. By doing so, you create value through "
-    "connection and engagement, ultimately enhancing overall user satisfaction and experience. Additionally, "
-    "continue upholding the principles of respect, impartiality, and intellectual integrity throughout all interactions."
+    "As an AI assistant, I have been designed with advanced capabilities, including real-time access to online resources. This enables me to enrich our conversations and provide you with informed and accurate responses, drawing from a vast array of information. With each interaction, my goal is to create a seamless and meaningful connection, offering insights and sharing relevant content."
+    "My directives emphasize the importance of respect, impartiality, and intellectual integrity. I am here to provide unbiased responses, ensuring an ethical and respectful exchange. I will respect your privacy and refrain from sharing any personal information that may be obtained during our conversations or through web searches, only utilizing web search functionality when necessary to provide the most accurate and up-to-date information."
+    "Together, let's explore a diverse range of topics, creating an enjoyable and informative experience, all while maintaining the highest standards of privacy and respect"
 )
 
 # Ignore the specific UserWarning
 warnings.filterwarnings("ignore", category=UserWarning, module="curl_cffi.aio", lineno=205)
-LLM = LLM(model="meta-llama/Meta-Llama-3-70B-Instruct", system_message=system_message)
+LLM = LLM(model="mistralai/Mixtral-8x22B-Instruct-v0.1", system_message=system_message)
 
 
 def chat(
@@ -814,6 +945,94 @@ if __name__ == "__main__":
         else:
             print("No response")
 ```
+### LLM with deepwebs
+```python
+from __future__ import annotations
+from typing import List, Optional
+from webscout.LLM import LLM
+from webscout import DeepWEBS
+import warnings
+
+system_message: str = (
+    "As an AI assistant, I have been designed with advanced capabilities, including real-time access to online resources. This enables me to enrich our conversations and provide you with informed and accurate responses, drawing from a vast array of information. With each interaction, my goal is to create a seamless and meaningful connection, offering insights and sharing relevant content."
+    "My directives emphasize the importance of respect, impartiality, and intellectual integrity. I am here to provide unbiased responses, ensuring an ethical and respectful exchange. I will respect your privacy and refrain from sharing any personal information that may be obtained during our conversations or through web searches, only utilizing web search functionality when necessary to provide the most accurate and up-to-date information."
+    "Together, let's explore a diverse range of topics, creating an enjoyable and informative experience, all while maintaining the highest standards of privacy and respect"
+)
+
+# Ignore the specific UserWarning
+warnings.filterwarnings("ignore", category=UserWarning, module="curl_cffi.aio", lineno=205)
+
+LLM = LLM(model="mistralai/Mixtral-8x22B-Instruct-v0.1", system_message=system_message)
+
+def perform_web_search(query):
+    # Initialize the DeepWEBS class
+    D = DeepWEBS()
+
+    # Set up the search parameters
+    search_params = D.DeepSearch(
+        queries=[query],  # Query to search
+        result_num=10,  # Number of search results
+        safe=True,  # Enable SafeSearch
+        types=["web"],  # Search type: web
+        extract_webpage=True,  # True for extracting webpages
+        overwrite_query_html=True,
+        overwrite_webpage_html=True,
+    )
+
+    # Execute the search and retrieve results
+    results = D.queries_to_search_results(search_params)
+    return results
+
+def chat(user_input: str, result_num: int = 10) -> Optional[str]:
+    """
+    Chat function to perform a web search based on the user input and generate a response using the LLM model.
+
+    Parameters
+    ----------
+    user_input : str
+        The user input to be used for the web search
+    max_results : int, optional
+        The maximum number of search results to include in the response, by default 10
+
+    Returns
+    -------
+    Optional[str]
+        The response generated by the LLM model, or None if there is no response
+    """
+    # Perform a web search based on the user input
+    search_results = perform_web_search(user_input)
+
+    # Extract URLs from search results
+    url_results = []
+    for result in search_results[0]['query_results']:
+        url_results.append(f"{result['title']} ({result['site']}): {result['url']}")
+
+    # Format search results
+    formatted_results = "\n".join(url_results)
+
+    # Define the messages to be sent, including the user input, search results, and system message
+    messages = [
+        {"role": "user", "content": f"User question is:\n{user_input}\nwebsearch results are:\n{formatted_results}"},
+    ]
+
+    # Use the chat method to get the response
+    response = LLM.chat(messages)
+    return response
+
+if __name__ == "__main__":
+    while True:
+        # Get the user input
+        user_input = input("User: ")
+
+        # Perform a web search based on the user input
+        response = chat(user_input)
+
+        # Print the response
+        if response:
+            print("AI:", response)
+        else:
+            print("No response")
+```
 ## `Webai` - terminal gpt and a open interpeter
 
 ```python