webscout 7.2__tar.gz → 7.4__tar.gz

{webscout-7.2/webscout.egg-info → webscout-7.4}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.1
 Name: webscout
-Version: 7.2
+Version: 7.4
 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
@@ -23,68 +23,15 @@ Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
-License-File: LICENSE.md
-Requires-Dist: setuptools
-Requires-Dist: wheel
-Requires-Dist: pip
-Requires-Dist: mistune
-Requires-Dist: tenacity
-Requires-Dist: curl_cffi
-Requires-Dist: nest-asyncio
-Requires-Dist: rich
-Requires-Dist: markdownify
-Requires-Dist: requests
-Requires-Dist: google-generativeai
-Requires-Dist: lxml>=5.2.2
-Requires-Dist: termcolor
-Requires-Dist: orjson
-Requires-Dist: PyYAML
-Requires-Dist: tls_client
-Requires-Dist: clipman
-Requires-Dist: playsound==1.2.2
-Requires-Dist: ollama
-Requires-Dist: pillow
-Requires-Dist: bson
-Requires-Dist: cloudscraper
-Requires-Dist: html5lib
-Requires-Dist: aiofiles
-Requires-Dist: emoji
-Requires-Dist: openai
-Requires-Dist: prompt-toolkit
-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"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: license
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-
-  [![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/official_helpingai)
+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;
@@ -96,7 +43,7 @@ Dynamic: summary
 <p align="center">
   <strong>Webscout</strong> is the all-in-one search and AI toolkit you need.
   <br>
-  Discover insights with Google, 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; run offline language models; and much more!
 </p>
 
 <div align="center">
@@ -108,9 +55,11 @@ Dynamic: summary
 ---
 
 ## 🚀 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.
@@ -124,8 +73,10 @@ Dynamic: summary
 * **[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
 ```
@@ -145,12 +96,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>
 
@@ -223,17 +175,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")
@@ -241,6 +190,7 @@ print(weather)
 ```
 
 ### 2. Weather ASCII
+
 ```python
 from webscout import weather_ascii as w
 weather = w.get("Qazigund")
@@ -285,8 +235,44 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+...
+
+### 🔍 `YepSearch` - Search using Yep.com
+
+```python
+from webscout import YepSearch
+
+# Initialize YepSearch
+yep = YepSearch(
+    timeout=20,  # Optional: Set custom timeout
+    proxies=None,  # Optional: Use proxies
+    verify=True   # Optional: SSL verification
+)
+
+# Text Search
+text_results = yep.text(
+    keywords="artificial intelligence",
+    region="all",           # Optional: Region for results
+    safesearch="moderate",  # Optional: "on", "moderate", "off"
+    max_results=10          # Optional: Limit number of results
+)
+print(text_results)
+
+# Image Search
+image_results = yep.images(
+    keywords="nature photography",
+    region="all",
+    safesearch="moderate",
+    max_results=10
+)
+print(image_results)
 
 
+# Suggestions
+suggestions = yep.suggestions("hist")
+print(suggestions)
+```
+
 ## 🔍 GoogleS (formerly DWEBS)
 
 ```python
@@ -298,7 +284,6 @@ for result in results:
     print(result)
 ```
 
-
 ## 🦆 WEBS and AsyncWEBS
 
 The `WEBS` and `AsyncWEBS` classes are used to retrieve search results from DuckDuckGo.com.
@@ -368,7 +353,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
@@ -382,7 +367,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
@@ -393,7 +378,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
@@ -415,7 +400,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
@@ -436,7 +421,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
@@ -517,18 +502,29 @@ with WEBS() as WEBS:
         print(r)
 ```
 
+### 9. `weather()` - Weather Information by DuckDuckGo.com
 
-## 🎭 ALL Acts
+```python
+from webscout import WEBS
+
+# Get weather information for a location using DuckDuckGo.com
+with WEBS() as webs:
+    weather_data = webs.weather("New York")
+    print(weather_data)
+
+```
+
+## 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
@@ -686,7 +682,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
@@ -711,7 +707,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
@@ -760,19 +756,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>
 
@@ -866,7 +862,7 @@ for chunk in response:
 
 ```
 
-###  ⬛ `BlackBox` - Search/Chat with BlackBox
+### ⬛ `BlackBox` - Search/Chat with BlackBox
 
 ```python
 from webscout import BLACKBOXAI
@@ -893,8 +889,7 @@ r = ai.chat(prompt)
 print(r)
 ```
 
-
-###  🤖 `Meta AI` - Chat with Meta AI
+### 🤖 `Meta AI` - Chat with Meta AI
 
 ```python
 from webscout import Meta
@@ -928,7 +923,7 @@ for media in response["media"]:
 
 ```
 
-###  `KOBOLDAI` 
+### `KOBOLDAI`
 
 ```python
 from webscout import KOBOLDAI
@@ -948,7 +943,7 @@ print(message)
 
 ```
 
-###  `Reka` - Chat with Reka
+### `Reka` - Chat with Reka
 
 ```python
 from webscout import REKA
@@ -960,7 +955,7 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `Cohere` - Chat with Cohere
+### `Cohere` - Chat with Cohere
 
 ```python
 from webscout import Cohere
@@ -972,7 +967,7 @@ response_str = a.chat(prompt)
 print(response_str)
 ```
 
-###  `Deepinfra`
+### `Deepinfra`
 
 ```python
 from webscout import DeepInfra
@@ -999,8 +994,7 @@ message = ai.get_message(response)
 print(message)
 ```
 
-
-###  `GROQ`
+### `GROQ`
 
 ```python
 from webscout import GROQ
@@ -1087,7 +1081,7 @@ print(response_search)
 
 ```
 
-###  `LLama 70b` - Chat with Meta's Llama 3 70b
+### `LLama 70b` - Chat with Meta's Llama 3 70b
 
 ```python
 
@@ -1099,7 +1093,7 @@ r = llama.chat("What is the meaning of life?")
 print(r)
 ```
 
-###  `AndiSearch`
+### `AndiSearch`
 
 ```python
 from webscout import AndiSearch
@@ -1107,8 +1101,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
+### 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, FreeAIChat, AkashGPT, PerplexityLabs, AllenAI, HeckAI, TwoAI, Venice
 
 Code is similar to other providers.
 
@@ -1132,7 +1125,7 @@ response = vlm.chat([{
 }])
 ```
 
-##  💻 Local-LLM
+## 💻 Local-LLM
 
 Webscout can now run GGUF models locally. You can download and run your favorite models with minimal configuration.
 
@@ -1244,7 +1237,7 @@ while True:
 
 ```
 
-##  GGUF 
+## GGUF
 
 Webscout provides tools to convert and quantize Hugging Face models into the GGUF format for use with offline LLMs.
 
@@ -1283,21 +1276,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>
@@ -1308,13 +1302,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
@@ -1327,7 +1321,6 @@ 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!