webscout 7.7__tar.gz → 7.9__tar.gz

{webscout-7.7/webscout.egg-info → webscout-7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 7.7
+Version: 7.9
 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
@@ -13,7 +13,6 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -22,43 +21,45 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Provides-Extra: dev
 License-File: LICENSE.md
 
-<div align="center">
-  <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/PyscoutAI"><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>
-
-<div align="center">
-  <!-- Replace `#` with your actual links -->
-  <a href="https://youtube.com/@OEvortex">▶️ Vortex's YouTube Channel</a>
-</div>
-<div align="center">
-  <a href="https://youtube.com/@devsdocode">▶️ Devs Do Code's YouTube Channel</a>
-</div>
-<div align="center">
-  <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder's Telegram</a>
-</div>
-
-<p align="center">
-  <strong>Webscout</strong> is the all-in-one search and AI toolkit you need.
-  <br>
-  Discover insights with Yep.com, DuckDuckGo, and Phind; access cutting-edge AI models; transcribe YouTube videos; generate temporary emails and phone numbers; perform text-to-speech conversions; and much more!
-</p>
 
 <div align="center">
-  <img src="https://img.shields.io/badge/WebScout-API-blue?style=for-the-badge&logo=WebScout" alt="WebScout API Badge">
-  <a href="#"><img src="https://img.shields.io/pypi/pyversions/webscout" alt="Python Version"></a>
-  <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout" alt="Downloads"></a>
+  <a href="https://github.com/OEvortex/Webscout">
+    <!-- Consider adding a dedicated Webscout logo here if you have one -->
+    <img src="https://img.shields.io/badge/WebScout-Ultimate%20Toolkit-blue?style=for-the-badge&logo=python&logoColor=white" alt="WebScout Logo">
+  </a>
+  <br/>
+  <h1>Webscout</h1>
+  <p><strong>Your All-in-One Python Toolkit for Web Search, AI Interaction, Digital Utilities, and More.</strong></p>
+  <p>
+    Access diverse search engines, cutting-edge AI models, temporary communication tools, media utilities, developer helpers, and powerful CLI interfaces – all through one unified library.
+  </p>
+
+  <!-- Badges -->
+  <p>
+    <a href="https://pypi.org/project/webscout/"><img src="https://img.shields.io/pypi/v/webscout.svg?style=flat-square&logo=pypi&label=PyPI" alt="PyPI Version"></a>
+    <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout/month?style=flat-square" alt="Monthly Downloads"></a>
+    <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout?style=flat-square" alt="Total Downloads"></a>
+    <a href="#"><img src="https://img.shields.io/pypi/pyversions/webscout?style=flat-square&logo=python" alt="Python Version"></a>
+    <!-- Add License Badge if applicable: <a href="LICENSE"><img src="https://img.shields.io/pypi/l/webscout?style=flat-square" alt="License"></a> -->
+    <!-- Add Build Status Badge if applicable -->
+  </p>
+
+  <!-- Social/Support Links -->
+  <div>
+    <a href="https://t.me/PyscoutAI"><img alt="Telegram Group" src="https://img.shields.io/badge/Telegram%20Group-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+    <a href="https://t.me/ANONYMOUS_56788"><img alt="Developer Telegram" src="https://img.shields.io/badge/Developer%20Contact-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+    <a href="https://youtube.com/@OEvortex"><img alt="YouTube" src="https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&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://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://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>
 </div>
 
----
 
 ## 🚀 Features
 
@@ -66,7 +67,7 @@ License-File: LICENSE.md
 * **AI Powerhouse:** Access and interact with various AI models, including OpenAI, Cohere, and more.
 * **[YouTube Toolkit](webscout/Extra/YTToolkit):** Advanced YouTube video and transcript management with multi-language support, versatile downloading, and intelligent data extraction
 * **[GitAPI](webscout/Extra/GitToolkit/gitapi):** Powerful GitHub data extraction toolkit for seamless repository and user information retrieval, featuring commit tracking, issue management, and comprehensive user analytics - all without authentication requirements for public data
-* **Tempmail & Temp Number:** Generate temporary email addresses and phone numbers for enhanced privacy.
+* **[Tempmail](webscout/Extra/tempmail/README.md) & Temp Number:** Generate temporary email addresses and phone numbers for enhanced privacy.
 * **[Text-to-Speech (TTS)](webscout/Provider/TTS/README.md):** Convert text into natural-sounding speech using multiple AI-powered providers like ElevenLabs, StreamElements, and Voicepods.
 * **GGUF Conversion & Quantization:** Convert and quantize Hugging Face models to GGUF format.
 * **[SwiftCLI](webscout/swiftcli/Readme.md):** A powerful and elegant CLI framework that makes it easy to create beautiful command-line interfaces.
@@ -94,6 +95,7 @@ python -m webscout --help
 | Command                                   | Description                                                                                           |
 |-------------------------------------------|-------------------------------------------------------------------------------------------------------|
 | python -m webscout answers -k Text        | CLI function to perform an answers search using Webscout.                                       |
+| python -m webscout chat                   | Interactive AI chat using DuckDuckGo's AI.                                                       |
 | python -m webscout images -k Text         | CLI function to perform an images search using Webscout.                                        |
 | python -m webscout maps -k Text           | CLI function to perform a maps search using Webscout.                                           |
 | python -m webscout news -k Text           | CLI function to perform a news search using Webscout.                                           |
@@ -102,9 +104,7 @@ python -m webscout --help
 | python -m webscout translate -k Text      | CLI function to perform translate using Webscout.                                               |
 | python -m webscout version                | A command-line interface command that prints and returns the version of the program.            |
 | python -m webscout videos -k Text         | CLI function to perform a videos search using DuckDuckGo API.                                   |
-| python -m webscout weather -k Text        | CLI function to get weather information for a location using Webscout.                          |
-
-
+| python -m webscout weather -l qazigund       | CLI function to get weather information for a location using Webscout.                          |
 
 ## ✉️ TempMail and VNEngine
 
@@ -123,13 +123,13 @@ async def main():
         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)
-    
+
     async with TempMail() as client:
         domains = await client.get_domains()
         print("Available Domains:", domains)
@@ -182,15 +182,53 @@ suggestions = yep.suggestions("hist")
 print(suggestions)
 ```
 
-## 🔍 GoogleS (formerly DWEBS)
+## 🔍 GoogleSearch (formerly DWEBS)
 
 ```python
-from webscout import GoogleS
-from rich import print
-searcher = GoogleS()
-results = searcher.search("HelpingAI-9B", max_results=20, extract_text=False, max_text_length=200)
-for result in results:
-    print(result)
+from webscout import GoogleSearch
+
+# Initialize GoogleSearch
+google = GoogleSearch(
+    timeout=10,  # Optional: Set custom timeout
+    proxies=None,  # Optional: Use proxies
+    verify=True   # Optional: SSL verification
+)
+
+# Text Search
+text_results = google.text(
+    keywords="artificial intelligence",
+    region="us",           # Optional: Region for results
+    safesearch="moderate",  # Optional: "on", "moderate", "off"
+    max_results=10          # Optional: Limit number of results
+)
+for result in text_results:
+    print(f"Title: {result.title}")
+    print(f"URL: {result.url}")
+    print(f"Description: {result.description}")
+    print("---")
+
+# News Search
+news_results = google.news(
+    keywords="technology trends",
+    region="us",
+    safesearch="moderate",
+    max_results=5
+)
+for result in news_results:
+    print(f"Title: {result.title}")
+    print(f"URL: {result.url}")
+    print(f"Description: {result.description}")
+    print("---")
+
+# Get search suggestions
+suggestions = google.suggestions("how to")
+print(suggestions)
+
+# Legacy usage is still supported
+from webscout import search
+results = search("Python programming", num_results=5)
+for url in results:
+    print(url)
 ```
 
 ## 🦆 WEBS and AsyncWEBS
@@ -267,7 +305,7 @@ await main()
 ```python
 from webscout import WEBS
 
-# Text search for 'live free or die' using DuckDuckGo.com 
+# Text search for 'live free or die' using DuckDuckGo.com
 with WEBS() as WEBS:
     for r in WEBS.text('live free or die', region='wt-wt', safesearch='off', timelimit='y', max_results=10):
         print(r)
@@ -281,7 +319,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Instant answers for the query "sun" using DuckDuckGo.com 
+# Instant answers for the query "sun" using DuckDuckGo.com
 with WEBS() as WEBS:
     for r in WEBS.answers("sun"):
         print(r)
@@ -292,7 +330,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Image search for the keyword 'butterfly' using DuckDuckGo.com 
+# Image search for the keyword 'butterfly' using DuckDuckGo.com
 with WEBS() as WEBS:
     keywords = 'butterfly'
     WEBS_images_gen = WEBS.images(
@@ -314,7 +352,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Video search for the keyword 'tesla' using DuckDuckGo.com 
+# Video search for the keyword 'tesla' using DuckDuckGo.com
 with WEBS() as WEBS:
     keywords = 'tesla'
     WEBS_videos_gen = WEBS.videos(
@@ -423,7 +461,6 @@ with WEBS() as webs:
 
 ```
 
-
 #### 📜 List Available LLM Models
 
 Retrieve a comprehensive list of all supported LLMs.
@@ -516,9 +553,6 @@ else:
     print(f"Available voices for {provider_name}: {available_voices}")
 ```
 
-
-
-
 ### 💬 `Duckchat` - Chat with LLM
 
 ```python
@@ -649,7 +683,7 @@ print(response["message"]) # Access the text message
 print("Sources:", response["sources"]) # Access sources (if any)
 
 # Image generation
-response = meta_ai.ask("Create an image of a cat wearing a hat.") 
+response = meta_ai.ask("Create an image of a cat wearing a hat.")
 print(response["message"]) # Print the text message from the response
 for media in response["media"]:
     print(media["url"])  # Access image URLs
@@ -834,7 +868,7 @@ a = AndiSearch()
 print(a.chat("HelpingAI-9B"))
 ```
 
-### `LLAMA`, `C4ai`, `Venice`, `Copilot`, `HuggingFaceChat`, `TwoAI`, `HeckAI`, `AllenAI`, `PerplexityLabs`, `AkashGPT`, `DeepSeek`, `WiseCat`, `IBMGranite`, `QwenLM`, `ChatGPTGratis`, `TextPollinationsAI`, `GliderAI`, `Cohere`, `REKA`, `GROQ`, `AsyncGROQ`, `OPENAI`, `AsyncOPENAI`, `KOBOLDAI`, `AsyncKOBOLDAI`, `BLACKBOXAI`, `PhindSearch`, `GEMINI`, `DeepInfra`, `AI4Chat`, `Phindv2`, `OLLAMA`, `AndiSearch`, `PIZZAGPT`, `Sambanova`, `DARKAI`, `KOALA`, `Meta`, `AskMyAI`, `PiAI`, `Julius`, `YouChat`, `YEPCHAT`, `Cloudflare`, `TurboSeek`, `Editee`, `TeachAnything`, `AI21`, `Chatify`, `X0GPT`, `Cerebras`, `Lepton`, `GEMINIAPI`, `Cleeai`, `Elmo`, `Free2GPT`, `GPTWeb`, `Netwrck`, `LlamaTutor`, `PromptRefine`, `TutorAI`, `ChatGPTES`, `Bagoodex`, `AIMathGPT`, `GaurishCerebras`, `GeminiPro`, `LLMChat`, `Talkai`, `Llama3Mitril`, `Marcus`, `TypeGPT`, `Netwrck`, `MultiChatAI`, `JadveOpenAI`, `ChatGLM`, `NousHermes`, `FreeAIChat`, `ElectronHub`, `GithubChat`, `Flowith`, `SonusAI`, `UncovrAI`, `LabyrinthAI`, `WebSim`, `LambdaChat`, `ChatGPTClone`
+### `LLAMA`, `C4ai`, `Venice`, `Copilot`, `HuggingFaceChat`, `TwoAI`, `HeckAI`, `AllenAI`, `PerplexityLabs`, `AkashGPT`, `DeepSeek`, `WiseCat`, `IBMGranite`, `QwenLM`, `ChatGPTGratis`, `TextPollinationsAI`, `GliderAI`, `Cohere`, `REKA`, `GROQ`, `AsyncGROQ`, `OPENAI`, `AsyncOPENAI`, `KOBOLDAI`, `AsyncKOBOLDAI`, `BLACKBOXAI`, `PhindSearch`, `GEMINI`, `DeepInfra`, `AI4Chat`, `Phindv2`, `OLLAMA`, `AndiSearch`, `PIZZAGPT`, `Sambanova`, `KOALA`, `Meta`, `AskMyAI`, `PiAI`, `Julius`, `YouChat`, `YEPCHAT`, `Cloudflare`, `TurboSeek`, `TeachAnything`, `AI21`, `Chatify`, `X0GPT`, `Cerebras`, `Lepton`, `GEMINIAPI`, `Cleeai`, `Elmo`, `Free2GPT`, `GPTWeb`, `Netwrck`, `LlamaTutor`, `PromptRefine`, `TutorAI`, `ChatGPTES`, `Bagoodex`, `AIMathGPT`, `GaurishCerebras`, `GeminiPro`, `LLMChat`, `Talkai`, `Llama3Mitril`, `Marcus`, `TypeGPT`, `Netwrck`, `MultiChatAI`, `JadveOpenAI`, `ChatGLM`, `NousHermes`, `FreeAIChat`, `ElectronHub`, `GithubChat`, `Flowith`, `SonusAI`, `UncovrAI`, `LabyrinthAI`, `WebSim`, `LambdaChat`, `ChatGPTClone`, `VercelAI`, `ExaChat`, `AskSteve`, `Aitopia`, `SearchChatAI`
 
 Code is similar to other providers.
 
@@ -868,9 +902,9 @@ Webscout provides tools to convert and quantize Hugging Face models into the GGU
 from webscout.Extra.gguf import ModelConverter
 """
 Valid quantization methods:
-"q2_k", "q3_k_l", "q3_k_m", "q3_k_s", 
-"q4_0", "q4_1", "q4_k_m", "q4_k_s", 
-"q5_0", "q5_1", "q5_k_m", "q5_k_s", 
+"q2_k", "q3_k_l", "q3_k_m", "q3_k_s",
+"q4_0", "q4_1", "q4_k_m", "q4_k_s",
+"q5_0", "q5_1", "q5_k_m", "q5_k_s",
 "q6_k", "q8_0"
 """
 # Create a converter instance
@@ -883,7 +917,6 @@ converter = ModelConverter(
 converter.convert()
 ```
 
-
 **Command Line Usage:**
 
 * **GGUF Conversion:**
@@ -892,7 +925,6 @@ converter.convert()
     python -m webscout.Extra.gguf convert -m "prithivMLmods/QWQ-500M" -q "q2_k"
    ```
 
-
 **Note:**
 
 * Replace `"your_username"` and `"your_hf_token"` with your actual Hugging Face credentials.
@@ -910,9 +942,6 @@ converter.convert()
   <!-- Replace `#` with your actual links -->
   <a href="https://youtube.com/@OEvortex">▶️ Vortex's YouTube Channel</a>
 </div>
-<div align="center">
-  <a href="https://youtube.com/@devsdocode">▶️ Devs Do Code's YouTube Channel</a>
-</div>
 <div align="center">
   <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder's Telegram</a>
 </div>
@@ -931,4 +960,3 @@ Contributions are welcome! If you'd like to contribute to Webscout, please follo
 
 * All the amazing developers who have contributed to the project!
 * The open-source community for their support and inspiration.
-

{webscout-7.7 → webscout-7.9}/README.md

@@ -1,35 +1,37 @@
-<div align="center">
-  <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/PyscoutAI"><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>
-
-<div align="center">
-  <!-- Replace `#` with your actual links -->
-  <a href="https://youtube.com/@OEvortex">▶️ Vortex's YouTube Channel</a>
-</div>
-<div align="center">
-  <a href="https://youtube.com/@devsdocode">▶️ Devs Do Code's YouTube Channel</a>
-</div>
-<div align="center">
-  <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder's Telegram</a>
-</div>
-
-<p align="center">
-  <strong>Webscout</strong> is the all-in-one search and AI toolkit you need.
-  <br>
-  Discover insights with Yep.com, DuckDuckGo, and Phind; access cutting-edge AI models; transcribe YouTube videos; generate temporary emails and phone numbers; perform text-to-speech conversions; and much more!
-</p>
 
 <div align="center">
-  <img src="https://img.shields.io/badge/WebScout-API-blue?style=for-the-badge&logo=WebScout" alt="WebScout API Badge">
-  <a href="#"><img src="https://img.shields.io/pypi/pyversions/webscout" alt="Python Version"></a>
-  <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout" alt="Downloads"></a>
+  <a href="https://github.com/OEvortex/Webscout">
+    <!-- Consider adding a dedicated Webscout logo here if you have one -->
+    <img src="https://img.shields.io/badge/WebScout-Ultimate%20Toolkit-blue?style=for-the-badge&logo=python&logoColor=white" alt="WebScout Logo">
+  </a>
+  <br/>
+  <h1>Webscout</h1>
+  <p><strong>Your All-in-One Python Toolkit for Web Search, AI Interaction, Digital Utilities, and More.</strong></p>
+  <p>
+    Access diverse search engines, cutting-edge AI models, temporary communication tools, media utilities, developer helpers, and powerful CLI interfaces – all through one unified library.
+  </p>
+
+  <!-- Badges -->
+  <p>
+    <a href="https://pypi.org/project/webscout/"><img src="https://img.shields.io/pypi/v/webscout.svg?style=flat-square&logo=pypi&label=PyPI" alt="PyPI Version"></a>
+    <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout/month?style=flat-square" alt="Monthly Downloads"></a>
+    <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout?style=flat-square" alt="Total Downloads"></a>
+    <a href="#"><img src="https://img.shields.io/pypi/pyversions/webscout?style=flat-square&logo=python" alt="Python Version"></a>
+    <!-- Add License Badge if applicable: <a href="LICENSE"><img src="https://img.shields.io/pypi/l/webscout?style=flat-square" alt="License"></a> -->
+    <!-- Add Build Status Badge if applicable -->
+  </p>
+
+  <!-- Social/Support Links -->
+  <div>
+    <a href="https://t.me/PyscoutAI"><img alt="Telegram Group" src="https://img.shields.io/badge/Telegram%20Group-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+    <a href="https://t.me/ANONYMOUS_56788"><img alt="Developer Telegram" src="https://img.shields.io/badge/Developer%20Contact-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"></a>
+    <a href="https://youtube.com/@OEvortex"><img alt="YouTube" src="https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&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://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://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>
 </div>
 
----
 
 ## 🚀 Features
 
@@ -37,7 +39,7 @@
 * **AI Powerhouse:** Access and interact with various AI models, including OpenAI, Cohere, and more.
 * **[YouTube Toolkit](webscout/Extra/YTToolkit):** Advanced YouTube video and transcript management with multi-language support, versatile downloading, and intelligent data extraction
 * **[GitAPI](webscout/Extra/GitToolkit/gitapi):** Powerful GitHub data extraction toolkit for seamless repository and user information retrieval, featuring commit tracking, issue management, and comprehensive user analytics - all without authentication requirements for public data
-* **Tempmail & Temp Number:** Generate temporary email addresses and phone numbers for enhanced privacy.
+* **[Tempmail](webscout/Extra/tempmail/README.md) & Temp Number:** Generate temporary email addresses and phone numbers for enhanced privacy.
 * **[Text-to-Speech (TTS)](webscout/Provider/TTS/README.md):** Convert text into natural-sounding speech using multiple AI-powered providers like ElevenLabs, StreamElements, and Voicepods.
 * **GGUF Conversion & Quantization:** Convert and quantize Hugging Face models to GGUF format.
 * **[SwiftCLI](webscout/swiftcli/Readme.md):** A powerful and elegant CLI framework that makes it easy to create beautiful command-line interfaces.
@@ -65,6 +67,7 @@ python -m webscout --help
 | Command                                   | Description                                                                                           |
 |-------------------------------------------|-------------------------------------------------------------------------------------------------------|
 | python -m webscout answers -k Text        | CLI function to perform an answers search using Webscout.                                       |
+| python -m webscout chat                   | Interactive AI chat using DuckDuckGo's AI.                                                       |
 | python -m webscout images -k Text         | CLI function to perform an images search using Webscout.                                        |
 | python -m webscout maps -k Text           | CLI function to perform a maps search using Webscout.                                           |
 | python -m webscout news -k Text           | CLI function to perform a news search using Webscout.                                           |
@@ -73,9 +76,7 @@ python -m webscout --help
 | python -m webscout translate -k Text      | CLI function to perform translate using Webscout.                                               |
 | python -m webscout version                | A command-line interface command that prints and returns the version of the program.            |
 | python -m webscout videos -k Text         | CLI function to perform a videos search using DuckDuckGo API.                                   |
-| python -m webscout weather -k Text        | CLI function to get weather information for a location using Webscout.                          |
-
-
+| python -m webscout weather -l qazigund       | CLI function to get weather information for a location using Webscout.                          |
 
 ## ✉️ TempMail and VNEngine
 
@@ -94,13 +95,13 @@ async def main():
         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)
-    
+
     async with TempMail() as client:
         domains = await client.get_domains()
         print("Available Domains:", domains)
@@ -153,15 +154,53 @@ suggestions = yep.suggestions("hist")
 print(suggestions)
 ```
 
-## 🔍 GoogleS (formerly DWEBS)
+## 🔍 GoogleSearch (formerly DWEBS)
 
 ```python
-from webscout import GoogleS
-from rich import print
-searcher = GoogleS()
-results = searcher.search("HelpingAI-9B", max_results=20, extract_text=False, max_text_length=200)
-for result in results:
-    print(result)
+from webscout import GoogleSearch
+
+# Initialize GoogleSearch
+google = GoogleSearch(
+    timeout=10,  # Optional: Set custom timeout
+    proxies=None,  # Optional: Use proxies
+    verify=True   # Optional: SSL verification
+)
+
+# Text Search
+text_results = google.text(
+    keywords="artificial intelligence",
+    region="us",           # Optional: Region for results
+    safesearch="moderate",  # Optional: "on", "moderate", "off"
+    max_results=10          # Optional: Limit number of results
+)
+for result in text_results:
+    print(f"Title: {result.title}")
+    print(f"URL: {result.url}")
+    print(f"Description: {result.description}")
+    print("---")
+
+# News Search
+news_results = google.news(
+    keywords="technology trends",
+    region="us",
+    safesearch="moderate",
+    max_results=5
+)
+for result in news_results:
+    print(f"Title: {result.title}")
+    print(f"URL: {result.url}")
+    print(f"Description: {result.description}")
+    print("---")
+
+# Get search suggestions
+suggestions = google.suggestions("how to")
+print(suggestions)
+
+# Legacy usage is still supported
+from webscout import search
+results = search("Python programming", num_results=5)
+for url in results:
+    print(url)
 ```
 
 ## 🦆 WEBS and AsyncWEBS
@@ -238,7 +277,7 @@ await main()
 ```python
 from webscout import WEBS
 
-# Text search for 'live free or die' using DuckDuckGo.com 
+# Text search for 'live free or die' using DuckDuckGo.com
 with WEBS() as WEBS:
     for r in WEBS.text('live free or die', region='wt-wt', safesearch='off', timelimit='y', max_results=10):
         print(r)
@@ -252,7 +291,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Instant answers for the query "sun" using DuckDuckGo.com 
+# Instant answers for the query "sun" using DuckDuckGo.com
 with WEBS() as WEBS:
     for r in WEBS.answers("sun"):
         print(r)
@@ -263,7 +302,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Image search for the keyword 'butterfly' using DuckDuckGo.com 
+# Image search for the keyword 'butterfly' using DuckDuckGo.com
 with WEBS() as WEBS:
     keywords = 'butterfly'
     WEBS_images_gen = WEBS.images(
@@ -285,7 +324,7 @@ with WEBS() as WEBS:
 ```python
 from webscout import WEBS
 
-# Video search for the keyword 'tesla' using DuckDuckGo.com 
+# Video search for the keyword 'tesla' using DuckDuckGo.com
 with WEBS() as WEBS:
     keywords = 'tesla'
     WEBS_videos_gen = WEBS.videos(
@@ -394,7 +433,6 @@ with WEBS() as webs:
 
 ```
 
-
 #### 📜 List Available LLM Models
 
 Retrieve a comprehensive list of all supported LLMs.
@@ -487,9 +525,6 @@ else:
     print(f"Available voices for {provider_name}: {available_voices}")
 ```
 
-
-
-
 ### 💬 `Duckchat` - Chat with LLM
 
 ```python
@@ -620,7 +655,7 @@ print(response["message"]) # Access the text message
 print("Sources:", response["sources"]) # Access sources (if any)
 
 # Image generation
-response = meta_ai.ask("Create an image of a cat wearing a hat.") 
+response = meta_ai.ask("Create an image of a cat wearing a hat.")
 print(response["message"]) # Print the text message from the response
 for media in response["media"]:
     print(media["url"])  # Access image URLs
@@ -805,7 +840,7 @@ a = AndiSearch()
 print(a.chat("HelpingAI-9B"))
 ```
 
-### `LLAMA`, `C4ai`, `Venice`, `Copilot`, `HuggingFaceChat`, `TwoAI`, `HeckAI`, `AllenAI`, `PerplexityLabs`, `AkashGPT`, `DeepSeek`, `WiseCat`, `IBMGranite`, `QwenLM`, `ChatGPTGratis`, `TextPollinationsAI`, `GliderAI`, `Cohere`, `REKA`, `GROQ`, `AsyncGROQ`, `OPENAI`, `AsyncOPENAI`, `KOBOLDAI`, `AsyncKOBOLDAI`, `BLACKBOXAI`, `PhindSearch`, `GEMINI`, `DeepInfra`, `AI4Chat`, `Phindv2`, `OLLAMA`, `AndiSearch`, `PIZZAGPT`, `Sambanova`, `DARKAI`, `KOALA`, `Meta`, `AskMyAI`, `PiAI`, `Julius`, `YouChat`, `YEPCHAT`, `Cloudflare`, `TurboSeek`, `Editee`, `TeachAnything`, `AI21`, `Chatify`, `X0GPT`, `Cerebras`, `Lepton`, `GEMINIAPI`, `Cleeai`, `Elmo`, `Free2GPT`, `GPTWeb`, `Netwrck`, `LlamaTutor`, `PromptRefine`, `TutorAI`, `ChatGPTES`, `Bagoodex`, `AIMathGPT`, `GaurishCerebras`, `GeminiPro`, `LLMChat`, `Talkai`, `Llama3Mitril`, `Marcus`, `TypeGPT`, `Netwrck`, `MultiChatAI`, `JadveOpenAI`, `ChatGLM`, `NousHermes`, `FreeAIChat`, `ElectronHub`, `GithubChat`, `Flowith`, `SonusAI`, `UncovrAI`, `LabyrinthAI`, `WebSim`, `LambdaChat`, `ChatGPTClone`
+### `LLAMA`, `C4ai`, `Venice`, `Copilot`, `HuggingFaceChat`, `TwoAI`, `HeckAI`, `AllenAI`, `PerplexityLabs`, `AkashGPT`, `DeepSeek`, `WiseCat`, `IBMGranite`, `QwenLM`, `ChatGPTGratis`, `TextPollinationsAI`, `GliderAI`, `Cohere`, `REKA`, `GROQ`, `AsyncGROQ`, `OPENAI`, `AsyncOPENAI`, `KOBOLDAI`, `AsyncKOBOLDAI`, `BLACKBOXAI`, `PhindSearch`, `GEMINI`, `DeepInfra`, `AI4Chat`, `Phindv2`, `OLLAMA`, `AndiSearch`, `PIZZAGPT`, `Sambanova`, `KOALA`, `Meta`, `AskMyAI`, `PiAI`, `Julius`, `YouChat`, `YEPCHAT`, `Cloudflare`, `TurboSeek`, `TeachAnything`, `AI21`, `Chatify`, `X0GPT`, `Cerebras`, `Lepton`, `GEMINIAPI`, `Cleeai`, `Elmo`, `Free2GPT`, `GPTWeb`, `Netwrck`, `LlamaTutor`, `PromptRefine`, `TutorAI`, `ChatGPTES`, `Bagoodex`, `AIMathGPT`, `GaurishCerebras`, `GeminiPro`, `LLMChat`, `Talkai`, `Llama3Mitril`, `Marcus`, `TypeGPT`, `Netwrck`, `MultiChatAI`, `JadveOpenAI`, `ChatGLM`, `NousHermes`, `FreeAIChat`, `ElectronHub`, `GithubChat`, `Flowith`, `SonusAI`, `UncovrAI`, `LabyrinthAI`, `WebSim`, `LambdaChat`, `ChatGPTClone`, `VercelAI`, `ExaChat`, `AskSteve`, `Aitopia`, `SearchChatAI`
 
 Code is similar to other providers.
 
@@ -839,9 +874,9 @@ Webscout provides tools to convert and quantize Hugging Face models into the GGU
 from webscout.Extra.gguf import ModelConverter
 """
 Valid quantization methods:
-"q2_k", "q3_k_l", "q3_k_m", "q3_k_s", 
-"q4_0", "q4_1", "q4_k_m", "q4_k_s", 
-"q5_0", "q5_1", "q5_k_m", "q5_k_s", 
+"q2_k", "q3_k_l", "q3_k_m", "q3_k_s",
+"q4_0", "q4_1", "q4_k_m", "q4_k_s",
+"q5_0", "q5_1", "q5_k_m", "q5_k_s",
 "q6_k", "q8_0"
 """
 # Create a converter instance
@@ -854,7 +889,6 @@ converter = ModelConverter(
 converter.convert()
 ```
 
-
 **Command Line Usage:**
 
 * **GGUF Conversion:**
@@ -863,7 +897,6 @@ converter.convert()
     python -m webscout.Extra.gguf convert -m "prithivMLmods/QWQ-500M" -q "q2_k"
    ```
 
-
 **Note:**
 
 * Replace `"your_username"` and `"your_hf_token"` with your actual Hugging Face credentials.
@@ -881,9 +914,6 @@ converter.convert()
   <!-- Replace `#` with your actual links -->
   <a href="https://youtube.com/@OEvortex">▶️ Vortex's YouTube Channel</a>
 </div>
-<div align="center">
-  <a href="https://youtube.com/@devsdocode">▶️ Devs Do Code's YouTube Channel</a>
-</div>
 <div align="center">
   <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder's Telegram</a>
 </div>
@@ -902,4 +932,3 @@ Contributions are welcome! If you'd like to contribute to Webscout, please follo
 
 * All the amazing developers who have contributed to the project!
 * The open-source community for their support and inspiration.
-

{webscout-7.7 → webscout-7.9}/setup.py

@@ -13,14 +13,13 @@ setup(
     author="OEvortex",
     author_email="helpingai5@gmail.com",
     packages=find_packages(),
-    python_requires=">=3.7",
+    python_requires=">=3.9",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "License :: Other/Proprietary License",
         "Operating System :: OS Independent",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
@@ -49,21 +48,18 @@ setup(
             "termcolor",
             "orjson",
             "PyYAML",
-            "tls_client",
             "ollama",
             "pillow",
             "bson",
             "cloudscraper",
             "html5lib",
             "aiofiles",
-            "emoji",
             "openai",
             "prompt-toolkit",
             "primp",
             "pyreqwest_impersonate",
             "gradio_client",
             "psutil",
-            # "pygetwindow",
             "aiohttp",
         ],
 

{webscout-7.7 → webscout-7.9}/webscout/AIutel.py

@@ -1,12 +1,13 @@
 import json
 import platform
 import subprocess
+from typing import Union
 
 
 
 def sanitize_stream(
     chunk: str, intro_value: str = "data:", to_json: bool = True
-) -> str | dict:
+) -> Union[str, dict]:
     """Remove streaming flags
 
     Args: