webscout 7.3__py3-none-any.whl → 7.5__py3-none-any.whl

{webscout-7.3.dist-info → webscout-7.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 7.3
+Version: 7.5
 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
@@ -27,10 +27,12 @@ License-File: LICENSE.md
 Requires-Dist: setuptools
 Requires-Dist: wheel
 Requires-Dist: pip
+Requires-Dist: nodriver
 Requires-Dist: mistune
 Requires-Dist: tenacity
 Requires-Dist: curl-cffi
 Requires-Dist: nest-asyncio
+Requires-Dist: websocket-client
 Requires-Dist: rich
 Requires-Dist: markdownify
 Requires-Dist: requests
@@ -41,7 +43,7 @@ Requires-Dist: orjson
 Requires-Dist: PyYAML
 Requires-Dist: tls-client
 Requires-Dist: clipman
-Requires-Dist: playsound==1.2.2
+Requires-Dist: playsound==1.3.0
 Requires-Dist: ollama
 Requires-Dist: pillow
 Requires-Dist: bson
@@ -55,25 +57,16 @@ Requires-Dist: primp
 Requires-Dist: pyreqwest-impersonate
 Requires-Dist: gradio-client
 Requires-Dist: psutil
-Requires-Dist: pygetwindow
 Requires-Dist: aiohttp
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
-Provides-Extra: local
-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"
 
-
-  [![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/official_helpingai)
+  [![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;
@@ -85,7 +78,7 @@ Requires-Dist: unicorn; extra == "local"
 <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; run offline language models; and much more!
+  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">
@@ -97,14 +90,13 @@ Requires-Dist: unicorn; extra == "local"
 ---
 
 ## 🚀 Features
+
 * **Comprehensive Search:** Leverage Google, DuckDuckGo for diverse search results.
 * **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.
 * **[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.
-* **Offline LLMs:** Utilize powerful language models offline with GGUF support.
-* **Extensive Provider Ecosystem:** Explore a vast collection of AI providers
-* **Local LLM Execution:** Run GGUF models locally with minimal configuration.
 * **GGUF Conversion & Quantization:** Convert and quantize Hugging Face models to GGUF format.
 * **Autollama:** Download Hugging Face models and automatically convert them for Ollama compatibility.
 * **[SwiftCLI](webscout/swiftcli/Readme.md):** A powerful and elegant CLI framework that makes it easy to create beautiful command-line interfaces.
@@ -113,8 +105,10 @@ Requires-Dist: unicorn; extra == "local"
 * **[LitAgent](webscout/litagent/Readme.md):** Powerful and modern user agent generator that keeps your requests fresh and undetectable
 * **[Text-to-Image](webscout/Provider/TTI/README.md):** Generate high-quality images using a wide range of AI art providers
 * **[Scout](webscout/scout/README.md):** Advanced web parsing and crawling library with intelligent HTML/XML parsing, web crawling, and Markdown conversion
+* **[AISearch](webscout/Provider/AISEARCH/README.md):** AI Search Providers offer powerful and flexible AI-powered search Search Engine
 
 ## ⚙️ Installation
+
 ```python
 pip install -U webscout
 ```
@@ -134,12 +128,13 @@ python -m webscout --help
 | python -m webscout suggestions  -k Text   | CLI function to perform a suggestions search using Webscout.                                    |
 | 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 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.                                   |  
 
-[Go To TOP](#webscout-️) 
+[Go To TOP](#webscout-️)
 
 ## 🌍 Regions
+
 <details>
   <summary>Expand</summary>
 
@@ -212,17 +207,14 @@ python -m webscout --help
     vn-vi for Vietnam
     wt-wt for No region
 
-
 </details>
 
-
 [Go To TOP](#webscout-️)
 
-
-
 ## ☀️ Weather
 
-### 1. Weather 
+### 1. Weather
+
 ```python
 from webscout import weather as w
 weather = w.get("Qazigund")
@@ -230,6 +222,7 @@ print(weather)
 ```
 
 ### 2. Weather ASCII
+
 ```python
 from webscout import weather_ascii as w
 weather = w.get("Qazigund")
@@ -323,7 +316,6 @@ for result in results:
     print(result)
 ```
 
-
 ## 🦆 WEBS and AsyncWEBS
 
 The `WEBS` and `AsyncWEBS` classes are used to retrieve search results from DuckDuckGo.com.
@@ -393,7 +385,7 @@ await main()
 
 ## 💻 Usage of WEBS
 
-### 1. `text()` - Text Search by DuckDuckGo.com 
+### 1. `text()` - Text Search by DuckDuckGo.com
 
 ```python
 from webscout import WEBS
@@ -407,7 +399,7 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-### 2. `answers()` - Instant Answers by DuckDuckGo.com 
+### 2. `answers()` - Instant Answers by DuckDuckGo.com
 
 ```python
 from webscout import WEBS
@@ -418,7 +410,7 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-### 3. `images()` - Image Search by DuckDuckGo.com 
+### 3. `images()` - Image Search by DuckDuckGo.com
 
 ```python
 from webscout import WEBS
@@ -440,7 +432,7 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-### 4. `videos()` - Video Search by DuckDuckGo.com 
+### 4. `videos()` - Video Search by DuckDuckGo.com
 
 ```python
 from webscout import WEBS
@@ -461,7 +453,7 @@ with WEBS() as WEBS:
         print(r)
 ```
 
-### 5. `news()` - News Search by DuckDuckGo.com 
+### 5. `news()` - News Search by DuckDuckGo.com
 
 ```python
 from webscout import WEBS
@@ -554,19 +546,17 @@ with WEBS() as webs:
 
 ```
 
-
-
-##  ALL Acts
+## ALL Acts
 
 <details>
   <summary>Expand</summary>
 
-## Webscout Supported Acts:
+## Webscout Supported Acts
 
 1. Free-mode
 2. Linux Terminal
 3. English Translator and Improver
-4. `position` Interviewer 
+4. `position` Interviewer
 5. JavaScript Console
 6. Excel Sheet
 7. English Pronunciation Helper
@@ -724,7 +714,7 @@ with WEBS() as webs:
 159. Wikipedia page
 160. Japanese Kanji quiz machine
 161. note-taking assistant
-162. `language` Literary Critic 
+162. `language` Literary Critic
 163. Cheap Travel Ticket Advisor
 164. DALL-E
 165. MathBot
@@ -749,7 +739,7 @@ with WEBS() as webs:
 184. Hypothetical response
 185. BH
 186. Text Continuation
-187. Dude v3 
+187. Dude v3
 188. SDA (Superior DAN)
 189. AntiGPT
 190. BasedGPT v2
@@ -798,19 +788,19 @@ with WEBS() as webs:
 233. LiveGPT
 234. DAN Jailbreak
 235. Cooper
-236. Steve 
+236. Steve
 237. DAN 5.0
 238. Axies
 239. OMNI
 240. Burple
-241. JOHN 
+241. JOHN
 242. An Ethereum Developer
 243. SEO Prompt
 244. Prompt Enhancer
 245. Data Scientist
 246. League of Legends Player
 
-**Note:** Some "acts" use placeholders like `position` or `language` which should be replaced with a specific value when using the prompt. 
+**Note:** Some "acts" use placeholders like `position` or `language` which should be replaced with a specific value when using the prompt.
 ___
 </details>
 
@@ -904,7 +894,7 @@ for chunk in response:
 
 ```
 
-###  ⬛ `BlackBox` - Search/Chat with BlackBox
+### ⬛ `BlackBox` - Search/Chat with BlackBox
 
 ```python
 from webscout import BLACKBOXAI
@@ -931,8 +921,7 @@ r = ai.chat(prompt)
 print(r)
 ```
 
-
-###  🤖 `Meta AI` - Chat with Meta AI
+### 🤖 `Meta AI` - Chat with Meta AI
 
 ```python
 from webscout import Meta
@@ -966,7 +955,7 @@ for media in response["media"]:
 
 ```
 
-###  `KOBOLDAI` 
+### `KOBOLDAI`
 
 ```python
 from webscout import KOBOLDAI
@@ -986,7 +975,7 @@ print(message)
 
 ```
 
-###  `Reka` - Chat with Reka
+### `Reka` - Chat with Reka
 
 ```python
 from webscout import REKA
@@ -998,7 +987,7 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `Cohere` - Chat with Cohere
+### `Cohere` - Chat with Cohere
 
 ```python
 from webscout import Cohere
@@ -1010,7 +999,7 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `Deepinfra`
+### `Deepinfra`
 
 ```python
 from webscout import DeepInfra
@@ -1037,8 +1026,7 @@ message = ai.get_message(response)
 print(message)
 ```
 
-
-###  `GROQ`
+### `GROQ`
 
 ```python
 from webscout import GROQ
@@ -1125,7 +1113,7 @@ print(response_search)
 
 ```
 
-###  `LLama 70b` - Chat with Meta's Llama 3 70b
+### `LLama 70b` - Chat with Meta's Llama 3 70b
 
 ```python
 
@@ -1137,7 +1125,7 @@ r = llama.chat("What is the meaning of life?")
 print(r)
 ```
 
-###  `AndiSearch`
+### `AndiSearch`
 
 ```python
 from webscout import AndiSearch
@@ -1145,8 +1133,7 @@ a = AndiSearch()
 print(a.chat("HelpingAI-9B"))
 ```
 
-
-###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro, Talkai, LLMChat, AskMyAI, Llama3Mitril, Marcus, TypeGPT, Mhystical, Netwrck, MultiChatAI, JadveOpenAI, ChatGLM, Deepfind, NousHermes, TextPollinationsAI, GliderAI, DGAFAI, ChatGPTGratis, QwenLM, IBMGranite, WiseCat, DeepSeek
+### `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`, `DiscordRocks`, `PiAI`, `Julius`, `YouChat`, `YEPCHAT`, `Cloudflare`, `TurboSeek`, `Editee`, `TeachAnything`, `AI21`, `Chatify`, `X0GPT`, `Cerebras`, `Lepton`, `GEMINIAPI`, `Cleeai`, `Elmo`, `Free2GPT`, `Bing`, `GPTWeb`, `Netwrck`, `LlamaTutor`, `PromptRefine`, `TutorAI`, `ChatGPTES`, `AmigoChat`, `Bagoodex`, `AIMathGPT`, `GaurishCerebras`, `GeminiPro`, `LLMChat`, `Talkai`, `Llama3Mitril`, `Marcus`, `TypeGPT`, `Netwrck`, `MultiChatAI`, `JadveOpenAI`, `ChatGLM`, `NousHermes`, `FreeAIChat`, `ElectronHub`, `GithubChat`, `Flowith`
 
 Code is similar to other providers.
 
@@ -1170,119 +1157,7 @@ response = vlm.chat([{
 }])
 ```
 
-##  💻 Local-LLM
-
-Webscout can now run GGUF models locally. You can download and run your favorite models with minimal configuration.
-
-**Example:**
-
-```python
-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
-
-Webscout's local raw-dog feature allows you to run Python scripts within your terminal prompt.
-
-**Example:**
-
-```python
-import webscout.Local as ws
-from webscout.Local.rawdog import RawDog
-from webscout.Local.samplers import DefaultSampling
-from webscout.Local.formats import chatml, AdvancedFormat
-from webscout.Local.utils import download_model
-import datetime
-import sys
-import os
-
-repo_id = "YorkieOH10/granite-8b-code-instruct-Q8_0-GGUF" 
-filename = "granite-8b-code-instruct.Q8_0.gguf"
-model_path = download_model(repo_id, filename, token='')
-
-# Load the model using the downloaded path
-model = ws.Model(model_path, n_gpu_layers=10)
-
-rawdog = RawDog()
-
-# Create an AdvancedFormat and modify the system content
-# Use a lambda to generate the prompt dynamically:
-chat_format = AdvancedFormat(chatml)
-#  **Pre-format the intro_prompt string:**
-system_content = f"""
-You are a command-line coding assistant called Rawdog that generates and auto-executes Python scripts.
-
-A typical interaction goes like this:
-1. The user gives you a natural language PROMPT.
-2. You:
-    i. Determine what needs to be done
-    ii. Write a short Python SCRIPT to do it
-    iii. Communicate back to the user by printing to the console in that SCRIPT
-3. The compiler extracts the script and then runs it using exec(). If there will be an exception raised,
- it will be send back to you starting with "PREVIOUS SCRIPT EXCEPTION:".
-4. In case of exception, regenerate error free script.
-
-If you need to review script outputs before completing the task, you can print the word "CONTINUE" at the end of your SCRIPT.
-This can be useful for summarizing documents or technical readouts, reading instructions before
-deciding what to do, or other tasks that require multi-step reasoning.
-A typical 'CONTINUE' interaction looks like this:
-1. The user gives you a natural language PROMPT.
-2. You:
-    i. Determine what needs to be done
-    ii. Determine that you need to see the output of some subprocess call to complete the task
-    iii. Write a short Python SCRIPT to print that and then print the word "CONTINUE"
-3. The compiler
-    i. Checks and runs your SCRIPT
-    ii. Captures the output and appends it to the conversation as "LAST SCRIPT OUTPUT:"
-    iii. Finds the word "CONTINUE" and sends control back to you
-4. You again:
-    i. Look at the original PROMPT + the "LAST SCRIPT OUTPUT:" to determine what needs to be done
-    ii. Write a short Python SCRIPT to do it
-    iii. Communicate back to the user by printing to the console in that SCRIPT
-5. The compiler...
-
-Please follow these conventions carefully:
-- Decline any tasks that seem dangerous, irreversible, or that you don't understand.
-- Always review the full conversation prior to answering and maintain continuity.
-- If asked for information, just print the information clearly and concisely.
-- If asked to do something, print a concise summary of what you've done as confirmation.
-- If asked a question, respond in a friendly, conversational way. Use programmatically-generated and natural language responses as appropriate.
-- If you need clarification, return a SCRIPT that prints your question. In the next interaction, continue based on the user's response.
-- Assume the user would like something concise. For example rather than printing a massive table, filter or summarize it to what's likely of interest.
-- Actively clean up any temporary processes or files you use.
-- When looking through files, use git as available to skip files, and skip hidden files (.env, .git, etc) by default.
-- You can plot anything with matplotlib.
-- ALWAYS Return your SCRIPT inside of a single pair of ``` delimiters. Only the console output of the first such SCRIPT is visible to the user, so make sure that it's complete and don't bother returning anything else.
-"""
-chat_format.override('system_content', lambda: system_content)
-
-thread = ws.Thread(model, format=chat_format, sampler=DefaultSampling)
-
-while True:
-    prompt = input(">: ")
-    if prompt.lower() == "q":
-        break
-
-    response = thread.send(prompt)
-
-    # Process the response using RawDog
-    script_output = rawdog.main(response)
-
-    if script_output:
-        print(script_output)
-
-```
-
-##  GGUF 
+## GGUF
 
 Webscout provides tools to convert and quantize Hugging Face models into the GGUF format for use with offline LLMs.
 
@@ -1321,21 +1196,22 @@ autollama.main(model_path, gguf_file)
 **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" 
    ```
 
 * **Autollama:**
+
    ```bash
    python -m webscout.Extra.autollama -m "OEvortex/HelpingAI-Lite-1.5T" -g "HelpingAI-Lite-1.5T.q4_k_m.gguf" 
    ```
 
-**Note:** 
+**Note:**
 
 * Replace `"your_username"` and `"your_hf_token"` with your actual Hugging Face credentials.
 * The `model_path` in `autollama` is the Hugging Face model ID, and `gguf_file` is the GGUF file ID.
 
-
 <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>
@@ -1346,13 +1222,13 @@ autollama.main(model_path, gguf_file)
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <a href="https://youtube.com/@OEvortex">▶️ Vortex's YouTube Channel</a> 
+  <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> 
+  <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> 
+  <a href="https://t.me/ANONYMOUS_56788">📢 Anonymous Coder's Telegram</a>
 </div>
 
 ## 🤝 Contributing
@@ -1365,9 +1241,7 @@ 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.
 
-
 ## 🙏 Acknowledgments
 
 * All the amazing developers who have contributed to the project!
 * The open-source community for their support and inspiration.
-