webscout 1.0.8__tar.gz → 1.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: webscout
3
- Version: 1.0.8
3
+ Version: 1.1.1
4
4
  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
5
5
  Author: OEvortex
6
6
  Author-email: helpingai5@gmail.com
@@ -44,11 +44,12 @@ Also containes AI models that you can use
44
44
  - [Table of Contents](#table-of-contents)
45
45
  - [Install](#install)
46
46
  - [CLI version](#cli-version)
47
- - [CLI version of AI](#cli-version-of-ai)
47
+ - [CLI version of webscout.AI](#cli-version-of-webscoutai)
48
+ - [CLI to use LLM](#cli-to-use-llm)
48
49
  - [Regions](#regions)
49
50
  - [WEBS and AsyncWEBS classes](#webs-and-asyncwebs-classes)
50
51
  - [Exceptions](#exceptions)
51
- - [usage](#usage)
52
+ - [usage of webscout](#usage-of-webscout)
52
53
  - [1. `text()` - text search by DuckDuckGo.com and Yep.com](#1-text---text-search-by-duckduckgocom-and-yepcom)
53
54
  - [2. `answers()` - instant answers by DuckDuckGo.com and Yep.com](#2-answers---instant-answers-by-duckduckgocom-and-yepcom)
54
55
  - [3. `images()` - image search by DuckDuckGo.com and Yep.com](#3-images---image-search-by-duckduckgocom-and-yepcom)
@@ -57,11 +58,19 @@ Also containes AI models that you can use
57
58
  - [6. `maps()` - map search by DuckDuckGo.com and](#6-maps---map-search-by-duckduckgocom-and)
58
59
  - [7. `translate()` - translation by DuckDuckGo.com and Yep.com](#7-translate---translation-by-duckduckgocom-and-yepcom)
59
60
  - [8. `suggestions()` - suggestions by DuckDuckGo.com and Yep.com](#8-suggestions---suggestions-by-duckduckgocom-and-yepcom)
60
- - [9. `PhindSearch` - Search using Phind.com](#9-phindsearch---search-using-phindcom)
61
- - [10. `YepChat` - Chat with mistral 8x7b powered by yepchat](#10-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
62
- - [11. `You.com` - search with you.com](#11-youcom---search-with-youcom)
63
- - [12. `Gemini` - search with google gemini](#12-gemini---search-with-google-gemini)
61
+ - [usage of webscout.AI](#usage-of-webscoutai)
62
+ - [1. `PhindSearch` - Search using Phind.com](#1-phindsearch---search-using-phindcom)
63
+ - [2. `YepChat` - Chat with mistral 8x7b powered by yepchat](#2-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
64
+ - [3. `You.com` - search with you.com](#3-youcom---search-with-youcom)
65
+ - [4. `Gemini` - search with google gemini](#4-gemini---search-with-google-gemini)
66
+ - [usage of image generator from Webscout.AI](#usage-of-image-generator-from-webscoutai)
67
+ - [5. `Prodia` - make image using prodia](#5-prodia---make-image-using-prodia)
68
+ - [usage of special .LLM file from webscout (webscout.LLM)](#usage-of-special-llm-file-from-webscout-webscoutllm)
69
+ - [`LLM`](#llm)
64
70
  - [Version History](#version-history)
71
+ - [v1.1.0](#v110)
72
+ - [v1.0.9](#v109)
73
+ - [v1.0.8](#v108)
65
74
  - [v1.0.7](#v107)
66
75
  - [v1.0.6](#v106)
67
76
 
@@ -75,24 +84,36 @@ pip install -U webscout
75
84
  ```python3
76
85
  python -m webscout --help
77
86
  ```
78
- ## CLI version of AI
79
87
 
80
- ```python3
81
- python -m webscout.AI phindsearch --query "your_query_here"
82
- ```
88
+ | Command | Description |
89
+ |-------------------------------------------|-------------------------------------------------------------------------------------------------------|
90
+ | python -m webscout answers -k Text | CLI function to perform an answers search using Webscout. |
91
+ | python -m webscout images -k Text | CLI function to perform an images search using Webscout. |
92
+ | python -m webscout maps -k Text | CLI function to perform a maps search using Webscout. |
93
+ | python -m webscout news -k Text | CLI function to perform a news search using Webscout. |
94
+ | python -m webscout suggestions -k Text | CLI function to perform a suggestions search using Webscout. |
95
+ | python -m webscout text -k Text | CLI function to perform a text search using Webscout. |
96
+ | python -m webscout translate -k Text | CLI function to perform translate using Webscout. |
97
+ | python -m webscout version | A command-line interface command that prints and returns the version of the program. |
98
+ | python -m webscout videos -k Text | CLI function to perform a videos search using DuckDuckGo API. |
83
99
 
84
- ```python
85
- python -m webscout.AI yepchat --message "your_message_here"
86
- ```
100
+ ## CLI version of webscout.AI
87
101
 
88
- ```python
89
- python -m webscout.AI youchat --prompt "your_prompt_here"
90
- ```
91
102
 
103
+ | Command | Description |
104
+ |--------------------------------------------|--------------------------------------------------------------------------------------------------------|
105
+ | `python -m webscout.AI phindsearch --query "your_query_here"` | CLI function to perform a search query using Webscout.AI's Phindsearch feature. |
106
+ | `python -m webscout.AI yepchat --message "your_message_here"` | CLI function to send a message using Webscout.AI's Yepchat feature. |
107
+ | `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. |
108
+ | `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. |
109
+ | `python -m webscout.AI prodia --prompt "car"` | CLI function to generate content related to a prompt using Webscout.AI's Prodia feature. |
110
+
111
+
112
+
113
+ ## CLI to use LLM
92
114
  ```python
93
- python -m webscout.AI gemini --message "tell me about gemma 7b"
115
+ python -m webscout.LLM model_name
94
116
  ```
95
-
96
117
  [Go To TOP](#TOP)
97
118
 
98
119
  ## Regions
@@ -242,8 +263,7 @@ This ensures proper resource management and cleanup, as the context manager will
242
263
  Exceptions:
243
264
  - `WebscoutE`: Raised when there is a generic exception during the API request.
244
265
 
245
- ## usage
246
- 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:
266
+ ## usage of webscout
247
267
 
248
268
  ### 1. `text()` - text search by DuckDuckGo.com and Yep.com
249
269
 
@@ -283,11 +303,10 @@ with WEBS() as WEBS:
283
303
  region="wt-wt",
284
304
  safesearch="off",
285
305
  size=None,
286
- color="Monochrome",
287
306
  type_image=None,
288
307
  layout=None,
289
308
  license_image=None,
290
- max_results=100,
309
+ max_results=10,
291
310
  )
292
311
  for r in WEBS_images_gen:
293
312
  print(r)
@@ -308,7 +327,7 @@ with WEBS() as WEBS:
308
327
  timelimit="w",
309
328
  resolution="high",
310
329
  duration="medium",
311
- max_results=100,
330
+ max_results=10,
312
331
  )
313
332
  for r in WEBS_videos_gen:
314
333
  print(r)
@@ -362,15 +381,13 @@ with WEBS() as WEBS:
362
381
  from webscout import WEBS
363
382
 
364
383
  # Suggestions for the keyword 'fly' using DuckDuckGo.com and Yep
365
- #
366
-
367
- .com
368
384
  with WEBS() as WEBS:
369
385
  for r in WEBS.suggestions("fly"):
370
386
  print(r)
371
387
  ```
388
+ ## usage of webscout.AI
372
389
 
373
- ### 9. `PhindSearch` - Search using Phind.com
390
+ ### 1. `PhindSearch` - Search using Phind.com
374
391
  Thanks to Empyros for PhindSearch function
375
392
  ```python
376
393
  from webscout.AI import PhindSearch
@@ -382,7 +399,7 @@ WEBSAI = PhindSearch(query)
382
399
 
383
400
  WEBSAI.search()
384
401
  ```
385
- ### 10. `YepChat` - Chat with mistral 8x7b powered by yepchat
402
+ ### 2. `YepChat` - Chat with mistral 8x7b powered by yepchat
386
403
  Thanks To Divyansh Shukla for This code
387
404
  ```python
388
405
  from webscout.AI import YepChat
@@ -402,7 +419,7 @@ if __name__ == "__main__":
402
419
  main()
403
420
  ```
404
421
 
405
- ### 11. `You.com` - search with you.com
422
+ ### 3. `You.com` - search with you.com
406
423
  ```python
407
424
  from webscout.AI import youChat
408
425
 
@@ -425,7 +442,7 @@ while True:
425
442
  print("⚠️ An error occurred:", e)
426
443
  ```
427
444
 
428
- ### 12. `Gemini` - search with google gemini
445
+ ### 4. `Gemini` - search with google gemini
429
446
 
430
447
  ```python
431
448
  from webscout.AI import Gemini
@@ -439,15 +456,51 @@ response = gemini.chat("Your message here")
439
456
  # Print the response from the Gemini assistant
440
457
  print(response)
441
458
  ```
459
+ ## usage of image generator from Webscout.AI
460
+ ### 5. `Prodia` - make image using prodia
461
+ ```python
462
+ from webscout.AI import Prodia
463
+
464
+ # Define a prompt for the image generation
465
+ prompt = "A beautiful sunset over the ocean"
466
+
467
+ # Use the prodia_cli method to generate an image based on the prompt
468
+ Prodia.prodia_cli(prompt)
469
+ ```
470
+ ## usage of special .LLM file from webscout (webscout.LLM)
471
+
472
+ ### `LLM`
473
+ ```python
474
+ from webscout.LLM import LLM
475
+
476
+ def chat(model_name):
477
+ AI = LLM(model_name)
478
+ AI.chat()
479
+
480
+ if __name__ == "__main__":
481
+ 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.
482
+ chat(model_name)
483
+ ```
442
484
 
443
485
  ## Version History
486
+ ### v1.1.0
487
+ 🌟 Added LLMs as webscout.LLM
488
+ 🔧 Resolved issue related to Prodia functionality
489
+
490
+ ### v1.0.9
491
+ 🌌 Added Prodia as an image generator in webscout.AI
492
+
493
+ ### v1.0.8
494
+ 🚀 Solved issues related to Gemini and Yep Chat functions within the Webscout package.
495
+ 🌟 Gemini function now provides correct outputs without duplication.
496
+ 🌟 Yep Chat function delivers accurate responses without repeating them multiple times.
444
497
 
445
498
  ### v1.0.7
446
- - Added gemini as webscout.AI
499
+ 🌟 Added Gemini as part of webscout.AI
447
500
 
448
501
  ### v1.0.6
449
- - Added yep.com as a search engine
450
- - Fixed an error related to translation functionality
451
- - Introduced Phind AI as webscout.AI
452
- - Included YepChat as webscout.AI
453
- - Integrated You.com as webscout.AI
502
+ 🌟 Integrated yep.com as a search engine
503
+ 🔧 Resolved error associated with the translation feature
504
+ 🌟 Introduced Phind AI within webscout.AI
505
+ 🌟 Included YepChat as part of webscout.AI
506
+ 🌟 Integrated You.com as part of webscout.AI
@@ -6,11 +6,12 @@ Also containes AI models that you can use
6
6
  - [Table of Contents](#table-of-contents)
7
7
  - [Install](#install)
8
8
  - [CLI version](#cli-version)
9
- - [CLI version of AI](#cli-version-of-ai)
9
+ - [CLI version of webscout.AI](#cli-version-of-webscoutai)
10
+ - [CLI to use LLM](#cli-to-use-llm)
10
11
  - [Regions](#regions)
11
12
  - [WEBS and AsyncWEBS classes](#webs-and-asyncwebs-classes)
12
13
  - [Exceptions](#exceptions)
13
- - [usage](#usage)
14
+ - [usage of webscout](#usage-of-webscout)
14
15
  - [1. `text()` - text search by DuckDuckGo.com and Yep.com](#1-text---text-search-by-duckduckgocom-and-yepcom)
15
16
  - [2. `answers()` - instant answers by DuckDuckGo.com and Yep.com](#2-answers---instant-answers-by-duckduckgocom-and-yepcom)
16
17
  - [3. `images()` - image search by DuckDuckGo.com and Yep.com](#3-images---image-search-by-duckduckgocom-and-yepcom)
@@ -19,11 +20,19 @@ Also containes AI models that you can use
19
20
  - [6. `maps()` - map search by DuckDuckGo.com and](#6-maps---map-search-by-duckduckgocom-and)
20
21
  - [7. `translate()` - translation by DuckDuckGo.com and Yep.com](#7-translate---translation-by-duckduckgocom-and-yepcom)
21
22
  - [8. `suggestions()` - suggestions by DuckDuckGo.com and Yep.com](#8-suggestions---suggestions-by-duckduckgocom-and-yepcom)
22
- - [9. `PhindSearch` - Search using Phind.com](#9-phindsearch---search-using-phindcom)
23
- - [10. `YepChat` - Chat with mistral 8x7b powered by yepchat](#10-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
24
- - [11. `You.com` - search with you.com](#11-youcom---search-with-youcom)
25
- - [12. `Gemini` - search with google gemini](#12-gemini---search-with-google-gemini)
23
+ - [usage of webscout.AI](#usage-of-webscoutai)
24
+ - [1. `PhindSearch` - Search using Phind.com](#1-phindsearch---search-using-phindcom)
25
+ - [2. `YepChat` - Chat with mistral 8x7b powered by yepchat](#2-yepchat---chat-with-mistral-8x7b-powered-by-yepchat)
26
+ - [3. `You.com` - search with you.com](#3-youcom---search-with-youcom)
27
+ - [4. `Gemini` - search with google gemini](#4-gemini---search-with-google-gemini)
28
+ - [usage of image generator from Webscout.AI](#usage-of-image-generator-from-webscoutai)
29
+ - [5. `Prodia` - make image using prodia](#5-prodia---make-image-using-prodia)
30
+ - [usage of special .LLM file from webscout (webscout.LLM)](#usage-of-special-llm-file-from-webscout-webscoutllm)
31
+ - [`LLM`](#llm)
26
32
  - [Version History](#version-history)
33
+ - [v1.1.0](#v110)
34
+ - [v1.0.9](#v109)
35
+ - [v1.0.8](#v108)
27
36
  - [v1.0.7](#v107)
28
37
  - [v1.0.6](#v106)
29
38
 
@@ -37,24 +46,36 @@ pip install -U webscout
37
46
  ```python3
38
47
  python -m webscout --help
39
48
  ```
40
- ## CLI version of AI
41
49
 
42
- ```python3
43
- python -m webscout.AI phindsearch --query "your_query_here"
44
- ```
50
+ | Command | Description |
51
+ |-------------------------------------------|-------------------------------------------------------------------------------------------------------|
52
+ | python -m webscout answers -k Text | CLI function to perform an answers search using Webscout. |
53
+ | python -m webscout images -k Text | CLI function to perform an images search using Webscout. |
54
+ | python -m webscout maps -k Text | CLI function to perform a maps search using Webscout. |
55
+ | python -m webscout news -k Text | CLI function to perform a news search using Webscout. |
56
+ | python -m webscout suggestions -k Text | CLI function to perform a suggestions search using Webscout. |
57
+ | python -m webscout text -k Text | CLI function to perform a text search using Webscout. |
58
+ | python -m webscout translate -k Text | CLI function to perform translate using Webscout. |
59
+ | python -m webscout version | A command-line interface command that prints and returns the version of the program. |
60
+ | python -m webscout videos -k Text | CLI function to perform a videos search using DuckDuckGo API. |
45
61
 
46
- ```python
47
- python -m webscout.AI yepchat --message "your_message_here"
48
- ```
62
+ ## CLI version of webscout.AI
49
63
 
50
- ```python
51
- python -m webscout.AI youchat --prompt "your_prompt_here"
52
- ```
53
64
 
65
+ | Command | Description |
66
+ |--------------------------------------------|--------------------------------------------------------------------------------------------------------|
67
+ | `python -m webscout.AI phindsearch --query "your_query_here"` | CLI function to perform a search query using Webscout.AI's Phindsearch feature. |
68
+ | `python -m webscout.AI yepchat --message "your_message_here"` | CLI function to send a message using Webscout.AI's Yepchat feature. |
69
+ | `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. |
70
+ | `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. |
71
+ | `python -m webscout.AI prodia --prompt "car"` | CLI function to generate content related to a prompt using Webscout.AI's Prodia feature. |
72
+
73
+
74
+
75
+ ## CLI to use LLM
54
76
  ```python
55
- python -m webscout.AI gemini --message "tell me about gemma 7b"
77
+ python -m webscout.LLM model_name
56
78
  ```
57
-
58
79
  [Go To TOP](#TOP)
59
80
 
60
81
  ## Regions
@@ -204,8 +225,7 @@ This ensures proper resource management and cleanup, as the context manager will
204
225
  Exceptions:
205
226
  - `WebscoutE`: Raised when there is a generic exception during the API request.
206
227
 
207
- ## usage
208
- 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:
228
+ ## usage of webscout
209
229
 
210
230
  ### 1. `text()` - text search by DuckDuckGo.com and Yep.com
211
231
 
@@ -245,11 +265,10 @@ with WEBS() as WEBS:
245
265
  region="wt-wt",
246
266
  safesearch="off",
247
267
  size=None,
248
- color="Monochrome",
249
268
  type_image=None,
250
269
  layout=None,
251
270
  license_image=None,
252
- max_results=100,
271
+ max_results=10,
253
272
  )
254
273
  for r in WEBS_images_gen:
255
274
  print(r)
@@ -270,7 +289,7 @@ with WEBS() as WEBS:
270
289
  timelimit="w",
271
290
  resolution="high",
272
291
  duration="medium",
273
- max_results=100,
292
+ max_results=10,
274
293
  )
275
294
  for r in WEBS_videos_gen:
276
295
  print(r)
@@ -324,15 +343,13 @@ with WEBS() as WEBS:
324
343
  from webscout import WEBS
325
344
 
326
345
  # Suggestions for the keyword 'fly' using DuckDuckGo.com and Yep
327
- #
328
-
329
- .com
330
346
  with WEBS() as WEBS:
331
347
  for r in WEBS.suggestions("fly"):
332
348
  print(r)
333
349
  ```
350
+ ## usage of webscout.AI
334
351
 
335
- ### 9. `PhindSearch` - Search using Phind.com
352
+ ### 1. `PhindSearch` - Search using Phind.com
336
353
  Thanks to Empyros for PhindSearch function
337
354
  ```python
338
355
  from webscout.AI import PhindSearch
@@ -344,7 +361,7 @@ WEBSAI = PhindSearch(query)
344
361
 
345
362
  WEBSAI.search()
346
363
  ```
347
- ### 10. `YepChat` - Chat with mistral 8x7b powered by yepchat
364
+ ### 2. `YepChat` - Chat with mistral 8x7b powered by yepchat
348
365
  Thanks To Divyansh Shukla for This code
349
366
  ```python
350
367
  from webscout.AI import YepChat
@@ -364,7 +381,7 @@ if __name__ == "__main__":
364
381
  main()
365
382
  ```
366
383
 
367
- ### 11. `You.com` - search with you.com
384
+ ### 3. `You.com` - search with you.com
368
385
  ```python
369
386
  from webscout.AI import youChat
370
387
 
@@ -387,7 +404,7 @@ while True:
387
404
  print("⚠️ An error occurred:", e)
388
405
  ```
389
406
 
390
- ### 12. `Gemini` - search with google gemini
407
+ ### 4. `Gemini` - search with google gemini
391
408
 
392
409
  ```python
393
410
  from webscout.AI import Gemini
@@ -401,15 +418,51 @@ response = gemini.chat("Your message here")
401
418
  # Print the response from the Gemini assistant
402
419
  print(response)
403
420
  ```
421
+ ## usage of image generator from Webscout.AI
422
+ ### 5. `Prodia` - make image using prodia
423
+ ```python
424
+ from webscout.AI import Prodia
425
+
426
+ # Define a prompt for the image generation
427
+ prompt = "A beautiful sunset over the ocean"
428
+
429
+ # Use the prodia_cli method to generate an image based on the prompt
430
+ Prodia.prodia_cli(prompt)
431
+ ```
432
+ ## usage of special .LLM file from webscout (webscout.LLM)
433
+
434
+ ### `LLM`
435
+ ```python
436
+ from webscout.LLM import LLM
437
+
438
+ def chat(model_name):
439
+ AI = LLM(model_name)
440
+ AI.chat()
441
+
442
+ if __name__ == "__main__":
443
+ 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.
444
+ chat(model_name)
445
+ ```
404
446
 
405
447
  ## Version History
448
+ ### v1.1.0
449
+ 🌟 Added LLMs as webscout.LLM
450
+ 🔧 Resolved issue related to Prodia functionality
451
+
452
+ ### v1.0.9
453
+ 🌌 Added Prodia as an image generator in webscout.AI
454
+
455
+ ### v1.0.8
456
+ 🚀 Solved issues related to Gemini and Yep Chat functions within the Webscout package.
457
+ 🌟 Gemini function now provides correct outputs without duplication.
458
+ 🌟 Yep Chat function delivers accurate responses without repeating them multiple times.
406
459
 
407
460
  ### v1.0.7
408
- - Added gemini as webscout.AI
461
+ 🌟 Added Gemini as part of webscout.AI
409
462
 
410
463
  ### v1.0.6
411
- - Added yep.com as a search engine
412
- - Fixed an error related to translation functionality
413
- - Introduced Phind AI as webscout.AI
414
- - Included YepChat as webscout.AI
415
- - Integrated You.com as webscout.AI
464
+ 🌟 Integrated yep.com as a search engine
465
+ 🔧 Resolved error associated with the translation feature
466
+ 🌟 Introduced Phind AI within webscout.AI
467
+ 🌟 Included YepChat as part of webscout.AI
468
+ 🌟 Integrated You.com as part of webscout.AI
@@ -10,7 +10,7 @@ with open("README.md", encoding="utf-8") as f:
10
10
 
11
11
  setup(
12
12
  name="webscout",
13
- version="1.0.8", # Use the version variable from the version.py file
13
+ version="1.1.1", # Use the version variable from the version.py file
14
14
  description="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",
15
15
  long_description=README,
16
16
  long_description_content_type="text/markdown",
@@ -48,6 +48,7 @@ setup(
48
48
  "webscout-ai-phindsearch = webscout.AI:phindsearch",
49
49
  "webscout-ai-yepchat = webscout.AI:yepchat",
50
50
  "webscout-ai = webscout.AI:cli",
51
+ "webscout-llm = webscout.LLM:chat",
51
52
  ],
52
53
  },
53
54
  extras_require={
@@ -63,4 +64,4 @@ setup(
63
64
  'Tracker': 'https://github.com/OE-LUCIFER/Webscout/issues',
64
65
  'YouTube': 'https://youtube.com/@OEvortex',
65
66
  },
66
- )
67
+ )