webscout 7.6__tar.gz → 7.8__tar.gz

{webscout-7.6/webscout.egg-info → webscout-7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 7.6
+Version: 7.8
 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,23 +21,26 @@ 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
 
-[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/PyscoutAI)
-  [![Instagram](https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white)](https://www.instagram.com/oevortex/)
-  [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/oe-vortex-29a407265/)
-  [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black)](https://buymeacoffee.com/oevortex)
-
 <div align="center">
-  <a href="https://youtube.com/@OEvortex">▶️ Vortex’s YouTube Channel</a> &bull;
-  <a href="https://youtube.com/@devsdocode">▶️ Devs Do Code’s YouTube Channel</a> &bull;
-  <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder’s Telegram</a>
+  <!-- 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://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.
@@ -71,8 +73,10 @@ License-File: LICENSE.md
 * **[Scout](webscout/scout/README.md):** Advanced web parsing and crawling library with intelligent HTML/XML parsing, web crawling, and Markdown conversion
 * **[Awesome Prompts (Act)](webscout/Extra/Act.md):** A curated collection of system prompts designed to transform Webscout into specialized personas, enhancing its ability to assist with specific tasks. Simply prefix your request with the act name or index number to leverage these tailored capabilities.
 * **[Weather Tool kit](webscout/Extra/weather.md)** Webscout provides tools to retrieve weather information.
-## ⚙️ Installation
 * **[AIsearch](webscout/Provider/AISEARCH)** AI Search Providers offer powerful and flexible AI-powered search Search Engine
+
+## ⚙️ Installation
+
 ```python
 pip install -U webscout
 ```
@@ -86,6 +90,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.                                           |
@@ -93,9 +98,8 @@ python -m webscout --help
 | python -m webscout text -k Text           | CLI function to perform a text search using Webscout.                                           |
 | 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 videos -k Text         | CLI function to perform a videos search using DuckDuckGo API.                                   |
+| python -m webscout weather -l qazigund       | CLI function to get weather information for a location using Webscout.                          |
 
 ## ✉️ TempMail and VNEngine
 
@@ -173,15 +177,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
@@ -414,7 +456,6 @@ with WEBS() as webs:
 
 ```
 
-
 #### 📜 List Available LLM Models
 
 Retrieve a comprehensive list of all supported LLMs.
@@ -507,9 +548,6 @@ else:
     print(f"Available voices for {provider_name}: {available_voices}")
 ```
 
-
-
-
 ### 💬 `Duckchat` - Chat with LLM
 
 ```python
@@ -825,7 +863,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`
+### `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`, `VercelAI`, `ExaChat`, `AskSteve`, `Aitopia`, `SearchChatAI`
 
 Code is similar to other providers.
 
@@ -856,7 +894,7 @@ Webscout provides tools to convert and quantize Hugging Face models into the GGU
 **Example:**
 
 ```python
-from webscout.Extra import gguf
+from webscout.Extra.gguf import ModelConverter
 """
 Valid quantization methods:
 "q2_k", "q3_k_l", "q3_k_m", "q3_k_s", 
@@ -864,22 +902,22 @@ Valid quantization methods:
 "q5_0", "q5_1", "q5_k_m", "q5_k_s", 
 "q6_k", "q8_0"
 """
-gguf.convert(
-    model_id="OEvortex/HelpingAI-Lite-1.5T",  # Replace with your model ID
-    username="Abhaykoul",  # Replace with your Hugging Face username
-    token="hf_token_write",  # Replace with your Hugging Face token
-    quantization_methods="q4_k_m"  # Optional, adjust quantization methods
+# Create a converter instance
+converter = ModelConverter(
+    model_id="prithivMLmods/QWQ-500M",
+    quantization_methods="q2_k"
 )
-```
 
+# Run the conversion
+converter.convert()
+```
 
 **Command Line Usage:**
 
 * **GGUF Conversion:**
 
    ```bash
-   python -m webscout.Extra.gguf -m "OEvortex/HelpingAI-Lite-1.5T" -u "your_username" -t "your_hf_token" -q "q4_k_m,q5_k_m" 
-   ```
+    python -m webscout.Extra.gguf convert -m "prithivMLmods/QWQ-500M" -q "q2_k"
    ```
 
 **Note:**
@@ -889,7 +927,7 @@ gguf.convert(
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <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://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>
@@ -899,9 +937,6 @@ gguf.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>
@@ -920,4 +955,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.
-