webscout 1.0.9__py3-none-any.whl → 1.1.0__py3-none-any.whl

webscout/AI.py

@@ -267,7 +267,7 @@ class Prodia:
             image.show()
         except Exception as e:
             print(f"An error occurred: {e}")
-            
+#-------------------------------------------------------Pollination--------------------------------------------------------------------------------------
 class Pollinations:
     """
     This class provides methods for generating images based on prompts.

webscout/LLM.py

@@ -0,0 +1,67 @@
+import argparse
+import requests
+import json
+from typing import List, Dict, Union
+
+class LLM:
+    def __init__(self, model: str):
+        self.model = model
+        self.conversation_history = [{"role": "system", "content": "You are a Helpful AI."}]
+
+    def mistral_chat(self, messages: List[Dict[str, str]]) -> Union[str, None]:
+        url = "https://api.deepinfra.com/v1/openai/chat/completions"
+        headers = {
+            'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
+            'Accept-Language': 'en,fr-FR;q=0.9,fr;q=0.8,es-ES;q=0.7,es;q=0.6,en-US;q=0.5,am;q=0.4,de;q=0.3',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+            'Content-Type': 'application/json',
+            'Origin': 'https://deepinfra.com',
+            'Pragma': 'no-cache',
+            'Referer': 'https://deepinfra.com/',
+            'Sec-Fetch-Dest': 'empty',
+            'Sec-Fetch-Mode': 'cors',
+            'Sec-Fetch-Site': 'same-site',
+            'X-Deepinfra-Source': 'web-embed',
+            'accept': 'text/event-stream',
+            'sec-ch-ua': '"Google Chrome";v="119", "Chromium";v="119", "Not?A_Brand";v="24"',
+            'sec-ch-ua-mobile': '?0',
+            'sec-ch-ua-platform': '"macOS"'
+        }
+        data = json.dumps(
+            {
+                'model': self.model,
+                'messages': messages,
+                'temperature': 0.7,
+                'max_tokens': 4028,
+                'stop': [],
+                'stream': False
+            }, separators=(',', ':')
+        )
+        try:
+            result = requests.post(url=url, data=data, headers=headers)
+            return result.json()['choices'][0]['message']['content']
+        except:
+            return None
+
+    def chat(self):
+        while True:
+            prompt = input("👦: ")
+            user_message = {"role": "user", "content": prompt}
+            self.conversation_history.append(user_message)
+            try:
+                resp = self.mistral_chat(self.conversation_history)
+                print(f"🤖: {resp}")
+                self.conversation_history.append({"role": "assistant", "content": resp})
+            except Exception as e:
+                print(f"🤖: Oops, something went wrong: {e}! Looks like even AI needs some oiling sometimes.")
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description='LLM CLI', epilog='To use a specific model, run:\n'
+                                                                     'python -m webscout.LLM model_name\n'
+                                                                     'Replace "model_name" with the name of the model you wish to use It supports ALL text generation models on deepinfra.com.')
+    parser.add_argument('model', type=str, help='Model to use for text generation. Specify the full model name, e.g., "mistralai/Mistral-7B-Instruct-v0.1".')
+    args = parser.parse_args()
+
+    LLM = LLM(args.model)
+    LLM.chat()

webscout/version.py

@@ -1 +1,2 @@
-__version__ = "1.0.9"
+__version__ = "1.1.0"
+

{webscout-1.0.9.dist-info → webscout-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 1.0.9
+Version: 1.1.0
 Summary: Search for words, documents, images, videos, news, maps and text translation using the DuckDuckGo.com, yep.com, phind.com and you.com Also containes AI models
 Author: OEvortex
 Author-email: helpingai5@gmail.com
@@ -44,11 +44,12 @@ Also containes AI models that you can use
 - [Table of Contents](#table-of-contents)
 - [Install](#install)
 - [CLI version](#cli-version)
-- [CLI version of AI](#cli-version-of-ai)
+- [CLI version of webscout.AI](#cli-version-of-webscoutai)
+- [CLI to use LLM](#cli-to-use-llm)
 - [Regions](#regions)
 - [WEBS and AsyncWEBS classes](#webs-and-asyncwebs-classes)
 - [Exceptions](#exceptions)
-- [usage](#usage)
+- [usage of webscout](#usage-of-webscout)
   - [1. `text()` - text search by DuckDuckGo.com and Yep.com](#1-text---text-search-by-duckduckgocom-and-yepcom)
   - [2. `answers()` - instant answers by DuckDuckGo.com and Yep.com](#2-answers---instant-answers-by-duckduckgocom-and-yepcom)
   - [3. `images()` - image search by DuckDuckGo.com and Yep.com](#3-images---image-search-by-duckduckgocom-and-yepcom)
@@ -57,12 +58,17 @@ Also containes AI models that you can use
   - [6. `maps()` - map search by DuckDuckGo.com and](#6-maps---map-search-by-duckduckgocom-and)
   - [7. `translate()` - translation by DuckDuckGo.com and Yep.com](#7-translate---translation-by-duckduckgocom-and-yepcom)
   - [8. `suggestions()` - suggestions by DuckDuckGo.com and Yep.com](#8-suggestions---suggestions-by-duckduckgocom-and-yepcom)
-  - [9. `PhindSearch` - Search using Phind.com](#9-phindsearch---search-using-phindcom)
-  - [10. `YepChat` - Chat with mistral 8x7b powered by yepchat](#10-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
-  - [11. `You.com` - search with you.com](#11-youcom---search-with-youcom)
-  - [12. `Gemini` - search with google gemini](#12-gemini---search-with-google-gemini)
-  - [13. `Prodia` - make image using prodia](#13-prodia---make-image-using-prodia)
+- [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](#3-youcom---search-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)
+- [usage of special .LLM file from webscout (webscout.LLM)](#usage-of-special-llm-file-from-webscout-webscoutllm)
+  - [`LLM`](#llm)
 - [Version History](#version-history)
+  - [v1.1.0](#v110)
   - [v1.0.9](#v109)
   - [v1.0.8](#v108)
   - [v1.0.7](#v107)
@@ -91,26 +97,22 @@ python -m webscout --help
 | 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.                                   |  
 
-## CLI version of AI
+## CLI version of webscout.AI
 
-```python3
-python -m webscout.AI phindsearch --query "your_query_here"
-```
 
-```python
-python -m webscout.AI yepchat --message "your_message_here"
-```
+| Command                                    | Description                                                                                            |
+|--------------------------------------------|--------------------------------------------------------------------------------------------------------|
+| `python -m webscout.AI phindsearch --query "your_query_here"` | CLI function to perform a search query using Webscout.AI's Phindsearch feature.              |
+| `python -m webscout.AI yepchat --message "your_message_here"`   | CLI function to send a message using Webscout.AI's Yepchat feature.                             |
+| `python -m webscout.AI youchat --prompt "your_prompt_here"`     | CLI function to generate a response based on a prompt using Webscout.AI's Youchat feature.      |
+| `python -m webscout.AI gemini --message "tell me about gemma 7b"` | CLI function to get information about a specific topic using Webscout.AI's Gemini feature.    |
+| `python -m webscout.AI prodia --prompt "car"`                   | CLI function to generate content related to a prompt using Webscout.AI's Prodia feature.        |
 
-```python
-python -m webscout.AI youchat --prompt "your_prompt_here"
-```
 
-```python
-python -m  webscout.AI gemini --message "tell me about gemma 7b"
-```
 
+## CLI to use LLM 
 ```python
-python -m webscout.AI prodia --prompt "car"
+python -m webscout.LLM model_name
 ```
 [Go To TOP](#TOP)
 
@@ -261,8 +263,7 @@ This ensures proper resource management and cleanup, as the context manager will
 Exceptions:
 - `WebscoutE`: Raised when there is a generic exception during the API request.
 
-## usage
-Here are the rewritten Python scripts for accessing various functionalities using the WEBS class from the webscout module, in HelpingAI style, for DuckDuckGo.com and Yep.com without explicitly specifying the search engine:
+## usage of webscout
 
 ### 1. `text()` - text search by DuckDuckGo.com and Yep.com
 
@@ -302,11 +303,10 @@ with WEBS() as WEBS:
       region="wt-wt",
       safesearch="off",
       size=None,
-      color="Monochrome",
       type_image=None,
       layout=None,
       license_image=None,
-      max_results=100,
+      max_results=10,
     )
     for r in WEBS_images_gen:
         print(r)
@@ -327,7 +327,7 @@ with WEBS() as WEBS:
       timelimit="w",
       resolution="high",
       duration="medium",
-      max_results=100,
+      max_results=10,
     )
     for r in WEBS_videos_gen:
         print(r)
@@ -381,15 +381,13 @@ with WEBS() as WEBS:
 from webscout import WEBS
 
 # Suggestions for the keyword 'fly' using DuckDuckGo.com and Yep
-# 
-
-.com
 with WEBS() as WEBS:
     for r in WEBS.suggestions("fly"):
         print(r)
 ```
+## usage of webscout.AI
 
-### 9. `PhindSearch` - Search using Phind.com 
+### 1. `PhindSearch` - Search using Phind.com 
 Thanks to Empyros for PhindSearch function
 ```python
 from webscout.AI import PhindSearch
@@ -401,7 +399,7 @@ WEBSAI = PhindSearch(query)
 
 WEBSAI.search()
 ```
-### 10. `YepChat` - Chat with mistral 8x7b powered by yepchat
+### 2. `YepChat` - Chat with mistral 8x7b powered by yepchat
 Thanks To Divyansh Shukla for This code
 ```python
 from webscout.AI import YepChat
@@ -421,7 +419,7 @@ if __name__ == "__main__":
     main()
 ```
 
-### 11. `You.com` - search with you.com
+### 3. `You.com` - search with you.com
 ```python
 from webscout.AI import youChat
 
@@ -444,7 +442,7 @@ while True:
         print("⚠️ An error occurred:", e)
 ```
 
-### 12. `Gemini` - search with google gemini
+### 4. `Gemini` - search with google gemini
 
 ```python
 from webscout.AI import Gemini
@@ -458,7 +456,8 @@ response = gemini.chat("Your message here")
 # Print the response from the Gemini assistant
 print(response)
 ```
-### 13. `Prodia` - make image using prodia
+##  usage of image generator from Webscout.AI
+### 5. `Prodia` - make image using prodia
 ```python
 from webscout.AI import Prodia
 
@@ -468,23 +467,40 @@ prompt = "A beautiful sunset over the ocean"
 # Use the prodia_cli method to generate an image based on the prompt
 Prodia.prodia_cli(prompt)
 ```
+## usage of special .LLM file from webscout (webscout.LLM)
+
+### `LLM`
+```python
+from webscout.LLM import LLM
+
+def chat(model_name):
+    AI = LLM(model_name)
+    AI.chat()
+
+if __name__ == "__main__":
+    model_name = "mistralai/Mistral-7B-Instruct-v0.1" # name of the model you wish to use It supports ALL text generation models on deepinfra.com.
+    chat(model_name)
+```
 
 ## Version History
+### v1.1.0
+🌟 Added LLMs as webscout.LLM  
+🔧 Resolved issue related to Prodia functionality
 
 ### v1.0.9
-- Added Prodia as image generator in webscout.AI
-  
+🌌 Added Prodia as an image generator in webscout.AI
+
 ### v1.0.8
-- Solved issue related to Gemini and Yep Chat functions in the Webscout package. 🌟
-   Now, Gemini function returns correct outputs without duplication.
-   Yep Chat function provides accurate responses without repeating them multiple times. 🚀
+🚀 Solved issues related to Gemini and Yep Chat functions within the Webscout package.  
+🌟 Gemini function now provides correct outputs without duplication.  
+🌟 Yep Chat function delivers accurate responses without repeating them multiple times.
 
 ### v1.0.7
-- Added gemini as webscout.AI
+🌟 Added Gemini as part of webscout.AI
 
 ### v1.0.6
-- Added yep.com as a search engine
-- Fixed an error related to translation functionality
-- Introduced Phind AI as webscout.AI
-- Included YepChat as webscout.AI
-- Integrated You.com as webscout.AI
+🌟 Integrated yep.com as a search engine  
+🔧 Resolved error associated with the translation feature  
+🌟 Introduced Phind AI within webscout.AI  
+🌟 Included YepChat as part of webscout.AI  
+🌟 Integrated You.com as part of webscout.AI

{webscout-1.0.9.dist-info → webscout-1.1.0.dist-info}/RECORD

@@ -1,16 +1,17 @@
-webscout/AI.py,sha256=jb-EzkgZVDxKv6x1wadhTol5P88FHO63fayrC0cQbbU,13889
+webscout/AI.py,sha256=HUolkJnL_ZPHzp2itGA9lgORLqspjq_79LUPGM-JT70,14030
+webscout/LLM.py,sha256=uyS8BmkFJcWEnfUzOgzcqIw96mF1p-oFqQjJntYn85U,3105
 webscout/__init__.py,sha256=vHJGZexYIaWDTHfMimqA7enct9b7zPDf6jLsS7NDBiA,536
 webscout/__main__.py,sha256=ZtTRgsRjUi2JOvYFLF1ZCh55Sdoz94I-BS-TlJC7WDU,126
 webscout/cli.py,sha256=9opO5KynQ3LA5gPW2czlmy7-ZdfUae6ccrny3vibqzQ,17757
 webscout/exceptions.py,sha256=7u52Mt5iyEUCZvaZuEYwQVV8HL8IdZBv1r5s5Ss_xU0,75
 webscout/models.py,sha256=5iQIdtedT18YuTZ3npoG7kLMwcrKwhQ7928dl_7qZW0,692
 webscout/utils.py,sha256=M2ocDpYOVd9lTZA3VGdK_p80Xsr-VPeAoUUCFaMWCqk,1610
-webscout/version.py,sha256=5fdKqtSBBDvdwuTWCGoh62x6-wR269e8DEQnOPkCHWg,23
+webscout/version.py,sha256=n_RJkcUU1vhYJL1FcReI98Gdzz-G65pYUOJu9K9rJco,25
 webscout/webscout_search.py,sha256=_kuNpRhbgge6MubxlsRe9kzBKlHoPEH6-93ILMpycfg,2351
 webscout/webscout_search_async.py,sha256=lNdR18-y8O9HqFsHvlzBYg18qeI12uLEXIzFMP3D_XU,35070
-webscout-1.0.9.dist-info/LICENSE.md,sha256=mRVwJuT4SXC5O93BFdsfWBjlXjGn2Np90Zm5SocUzM0,3150
-webscout-1.0.9.dist-info/METADATA,sha256=MK_v_e2natl5tA7Rcz7TnCgG_RYEK4CAJi3DFCx2TbA,15915
-webscout-1.0.9.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-webscout-1.0.9.dist-info/entry_points.txt,sha256=1naMz1lm0onX0Rn0RRBeGaQJIUKT8V6KASIcGJJHz0M,164
-webscout-1.0.9.dist-info/top_level.txt,sha256=nYIw7OKBQDr_Z33IzZUKidRD3zQEo8jOJYkMVMeN334,9
-webscout-1.0.9.dist-info/RECORD,,
+webscout-1.1.0.dist-info/LICENSE.md,sha256=mRVwJuT4SXC5O93BFdsfWBjlXjGn2Np90Zm5SocUzM0,3150
+webscout-1.1.0.dist-info/METADATA,sha256=YUGyziqnSd0kqR0yMFGtg7LYbqp8WJZJ5cHPunHKQxw,17493
+webscout-1.1.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+webscout-1.1.0.dist-info/entry_points.txt,sha256=8-93eRslYrzTHs5E-6yFRJrve00C9q-SkXJD113jzRY,197
+webscout-1.1.0.dist-info/top_level.txt,sha256=nYIw7OKBQDr_Z33IzZUKidRD3zQEo8jOJYkMVMeN334,9
+webscout-1.1.0.dist-info/RECORD,,

{webscout-1.0.9.dist-info → webscout-1.1.0.dist-info}/entry_points.txt

@@ -3,3 +3,4 @@ WEBS = webscout.cli:cli
 webscout-ai = webscout.AI:cli
 webscout-ai-phindsearch = webscout.AI:phindsearch
 webscout-ai-yepchat = webscout.AI:yepchat
+webscout-llm = webscout.LLM:chat