webscout 1.4.0__tar.gz → 1.4.3__tar.gz

{webscout-1.4.0 → webscout-1.4.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 1.4.0
-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
+Version: 1.4.3
+Summary: 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)
 Author: OEvortex
 Author-email: helpingai5@gmail.com
 License: HelpingAI Simplified Universal License
@@ -49,6 +49,7 @@ Requires-Dist: orjson
 Requires-Dist: PyYAML
 Requires-Dist: appdirs
 Requires-Dist: GoogleBard1>=2.1.4
+Requires-Dist: tls_client
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -59,7 +60,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
@@ -69,6 +70,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)
@@ -91,9 +95,8 @@ 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 -NOT WORKING](#3-youcom---search-with-youcom--not-working)
+    - [3. `You.com` - search/chat with you.com](#3-youcom---searchchat-with-youcom)
     - [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)
     - [6. `BlackBox` - Search/chat With BlackBox](#6-blackbox---searchchat-with-blackbox)
     - [7. `PERPLEXITY` - Search With PERPLEXITY](#7-perplexity---search-with-perplexity)
@@ -101,8 +104,10 @@ Search for anything using the Google, DuckDuckGo.com, yep.com, phind.com, you.co
     - [9. `KOBOLDIA` -](#9-koboldia--)
     - [10. `Reka` - chat with reka](#10-reka---chat-with-reka)
     - [11. `Cohere` - chat with cohere](#11-cohere---chat-with-cohere)
-    - [`LLM` --not working](#llm---not-working)
+    - [12. `Xjai` - chat with free gpt 3.5](#12-xjai---chat-with-free-gpt-35)
+    - [`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
@@ -212,7 +217,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
@@ -484,19 +573,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
@@ -568,27 +685,31 @@ print(r)
 
 ```
 
-### 3. `You.com` - search with you.com -NOT WORKING
+### 3. `You.com` - search/chat with you.com 
 ```python
-from webscout.AI import youChat
 
-# Instantiate the youchat class
-youChat = youChat()
+from webscout.AI import YouChat
+from rich import print
 
-while True:
-    # Ask the user for a prompt
-    prompt = input("💡 Enter a prompt (or type 'exit' to quit): ")
-    
-    # Exit condition
-    if prompt.lower() == 'exit':
-        break
-    
-    # Generate a completion based on the prompt
-    try:
-        completion = youChat.create(prompt)
-        print("💬:", completion)
-    except Exception as e:
-        print("⚠️ An error occurred:", e)
+ai = YouChat(
+    is_conversation=True,
+    max_tokens=800,
+    timeout=30,
+    intro=None,
+    filepath=None,
+    update_file=True,
+    proxies={},
+    history_offset=10250,
+    act=None,
+)
+
+prompt = "what is meaning of life"
+
+response = ai.ask(prompt)
+
+# Extract and print the message from the response
+message = ai.get_message(response)
+print(message)
 ```
 
 ### 4. `Gemini` - search with google gemini
@@ -612,19 +733,7 @@ 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
 ### 5. `Prodia` - make image using prodia
 ```python
 from webscout.AI import Prodia
@@ -730,7 +839,31 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-### `LLM` --not working
+### 12. `Xjai` - chat with free gpt 3.5
+Gratitude to [Devs do Code](http://www.youtube.com/@DevsDoCode) for their assistance.
+```python
+from webscout.AI import Xjai
+from rich import print
+
+ai = Xjai(
+    is_conversation=True,
+    max_tokens=800,
+    timeout=30,
+    intro=None,
+    filepath=None,
+    update_file=True,
+    proxies={},
+    history_offset=10250,
+    act=None,
+)
+
+prompt = "Tell me about india"
+
+response = ai.chat(prompt)
+print(response)
+```
+
+### `LLM` 
 ```python
 from webscout.LLM import LLM
 
@@ -761,23 +894,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(
@@ -833,6 +962,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