webscout 6.2b0__py3-none-any.whl → 6.4__py3-none-any.whl

webscout/update_checker.py

@@ -0,0 +1,125 @@
+"""
+Webscout Update Checker
+A utility to check and compare Webscout versions
+"""
+
+import requests
+import re
+import subprocess
+import sys
+import os
+from packaging import version
+from typing import Optional
+
+from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
+
+# Initialize logger with custom format
+CUSTOM_FORMAT = """{message}"""
+
+logger = LitLogger(
+    name="WebscoutUpdate",
+    format=CUSTOM_FORMAT,
+    color_scheme=ColorScheme.OCEAN,
+    level_styles={
+        "TRACE": "DIM",
+        "DEBUG": "NORMAL",
+        "INFO": "BOLD",
+        "SUCCESS": "BOLD",
+        "WARNING": "BOLD",
+        "ERROR": "BOLD",
+        "CRITICAL": "BOLD"
+    }
+)
+
+def get_installed_version() -> Optional[str]:
+    """Get the installed version of webscout"""
+    try:
+        import importlib.metadata
+        return importlib.metadata.version('webscout')
+    except ImportError:
+        try:
+            import pkg_resources
+            return pkg_resources.get_distribution('webscout').version
+        except Exception:
+            logger.error("Could not determine installed version using pkg_resources")
+            return None
+    except Exception:
+        logger.error("Could not determine installed version using importlib.metadata")
+        return None
+
+def get_webscout_version() -> Optional[str]:
+    """Get the current webscout version from CLI"""
+    try:
+        result = subprocess.run(['webscout', '--version'], 
+                              capture_output=True, 
+                              text=True, 
+                              timeout=5)
+        if result.returncode == 0:
+            version_match = re.search(r'\d+\.\d+\.\d+', result.stdout)
+            if version_match:
+                return version_match.group(0)
+    except (subprocess.TimeoutExpired, subprocess.SubprocessError, FileNotFoundError) as e:
+        logger.error(f"Failed to get version from CLI: {str(e)}")
+    return None
+
+def get_pypi_version() -> Optional[str]:
+    """Get the latest version from PyPI"""
+    try:
+        response = requests.get(
+            "https://pypi.org/pypi/webscout/json",
+            timeout=10
+        )
+        response.raise_for_status()
+        return response.json()['info']['version']
+    except requests.RequestException as e:
+        logger.error(f"Failed to fetch PyPI version: {str(e)}")
+    except (KeyError, ValueError) as e:
+        logger.error(f"Failed to parse PyPI response: {str(e)}")
+    return None
+
+def version_compare(v1: str, v2: str) -> int:
+    """Compare two version strings"""
+    try:
+        return -1 if version.parse(v1) < version.parse(v2) else 1
+    except version.InvalidVersion:
+        return 0
+
+def display_version_info(installed: Optional[str], current: Optional[str], latest: Optional[str]) -> None:
+    """Display version information"""
+    if installed:
+        logger.info(f"Currently using Webscout version {installed}")
+    
+    if latest and installed:
+        if version_compare(installed, latest) < 0:
+            logger.warning(
+                f"A new version of Webscout is available: {latest}\n"
+                f"To update, run: pip install --upgrade webscout"
+            )
+        else:
+            logger.success("You're running the latest version!")
+
+def check_for_updates() -> None:
+    """Check for Webscout updates"""
+    logger.info("Checking for Webscout updates...")
+    
+    installed_version = get_installed_version()
+    current_version = get_webscout_version()
+    latest_version = get_pypi_version()
+    
+    if not installed_version:
+        logger.error("Could not determine installed Webscout version")
+        return
+        
+    if not latest_version:
+        logger.error("Could not determine latest Webscout version from PyPI")
+        return
+    
+    display_version_info(installed_version, current_version, latest_version)
+
+if __name__ == "__main__":
+    try:
+        check_for_updates()
+    except KeyboardInterrupt:
+        logger.warning("Update check cancelled by user")
+    except Exception as e:
+        logger.error(f"An unexpected error occurred: {str(e)}")

webscout/version.py

@@ -1,2 +1,2 @@
-__version__ = "6.2b"
+__version__ = "6.4"
 __prog__ = "webscout"

webscout-6.4.dist-info/LICENSE.md

@@ -0,0 +1,211 @@
+# HelpingAI License
+Version 3.0
+Copyright (c) 2024 HelpingAI
+All Rights Reserved.
+
+## PREAMBLE
+The HelpingAI License (the "License") is designed to govern the use, modification, and distribution of HelpingAI's proprietary assets, including but not limited to artificial intelligence models, software, algorithms, weights, documentation, datasets, and associated materials (collectively, the "Content"). This License aims to balance open innovation with the protection of HelpingAI's intellectual property rights while ensuring responsible and ethical use of AI technology.
+
+## 1. DEFINITIONS
+1.1. "Model" means any machine learning model, artificial intelligence system, neural network architecture, or AI-powered solution developed by HelpingAI.
+
+1.2. "Weights" refers to the trained parameters, embeddings, model checkpoints, and other numerical values that define the behavior and capabilities of the Model.
+
+1.3. "Source Code" means the human-readable form of software, documentation, configuration files, and associated resources.
+
+1.4. "Derivative Work" means any work that is based upon or derived from the Content, including but not limited to:
+   a) Fine-tuned or adapted versions of the Model
+   b) Modified or enhanced versions of the Source Code
+   c) Products, services, or applications that incorporate the Content
+   d) Adaptations, transformations, or improvements of the Content
+   e) Any output generated using the Model or Content
+
+1.5. "Commercial Use" means any use of the Content intended for or directed toward:
+   a) Commercial advantage or monetary compensation
+   b) Revenue generation, either directly or indirectly
+   c) Business operations or commercial services
+   d) Integration into commercial products or offerings
+
+1.6. "End User" means any individual or entity that uses the Content or Derivative Works.
+
+## 2. GRANT OF RIGHTS
+Subject to the terms and conditions of this License, HelpingAI hereby grants you a limited, non-exclusive, non-transferable, revocable license to:
+
+2.1. Access and use the Content for:
+   a) Research and evaluation purposes
+   b) Educational and academic use
+   c) Personal, non-commercial projects
+   d) Open-source contributions (subject to Section 3)
+
+2.2. Create and use Derivative Works for non-commercial purposes, provided that:
+   a) You comply with all restrictions in Section 3
+   b) You maintain appropriate attribution
+   c) You ensure responsible and ethical use
+
+2.3. Distribute the Content or Derivative Works to third parties, provided that:
+   a) You maintain all copyright notices and attributions
+   b) You include a complete, unmodified copy of this License
+   c) You clearly document any modifications made
+   d) You comply with all restrictions in Section 3
+   e) You ensure recipients agree to this License
+
+## 3. RESTRICTIONS AND LIMITATIONS
+3.1. **Commercial Use Restrictions**
+You may not use the Content or any Derivative Works for Commercial Use without:
+   a) Obtaining a separate commercial license from HelpingAI
+   b) Paying applicable fees and royalties
+   c) Receiving written authorization
+
+3.2. **Model Usage Restrictions**
+You may not:
+   a) Use the Model to train or develop competing AI models or services
+   b) Extract, reverse engineer, or decompile the Model's architecture or weights
+   c) Remove, disable, or circumvent any access controls or security measures
+   d) Use the Model for military purposes, weapons development, or harmful applications
+   e) Use the Model to generate harmful, discriminatory, or illegal content
+   f) Use the Model in safety-critical applications without explicit written permission
+   g) Use the Model in ways that violate privacy or data protection laws
+   h) Create autonomous systems that could cause harm to individuals or society
+
+3.3. **Distribution Restrictions**
+You may not:
+   a) Redistribute the Model's weights or checkpoints without explicit permission
+   b) Create hosted APIs or services that provide direct access to the Model
+   c) Bundle or integrate the Content with commercial products or services
+   d) Sublicense or transfer rights to the Content to third parties
+   e) Distribute the Content in ways that could harm HelpingAI's interests
+
+3.4. **Branding and Attribution**
+You must:
+   a) Maintain all HelpingAI branding, logos, notices, and watermarks
+   b) Include the following attribution in all Derivative Works:
+      "Powered by HelpingAI technology, licensed under the HelpingAI License v3.0"
+   c) Not use HelpingAI's name, logos, or trademarks to endorse or promote products
+   d) Not suggest any official association with HelpingAI without permission
+
+## 4. INTELLECTUAL PROPERTY
+4.1. HelpingAI retains all rights, title, and interest in and to the Content, including:
+   a) All intellectual property rights
+   b) Patents, trademarks, and trade secrets
+   c) Proprietary methods and algorithms
+   d) Future improvements and modifications
+
+4.2. This License does not grant you any rights to HelpingAI's:
+   a) Patents or patent applications
+   b) Trademarks or service marks
+   c) Trade secrets or proprietary information
+   d) Other intellectual property except as expressly stated
+
+4.3. Derivative Works:
+   a) You retain ownership of original portions of Derivative Works you create
+   b) HelpingAI retains all rights to the underlying Content
+   c) You grant HelpingAI a perpetual license to any improvements or feedback
+
+## 5. DATA COLLECTION AND PRIVACY
+5.1. Data Collection:
+   a) HelpingAI may collect usage data and performance metrics
+   b) Analytics may be used to improve the Content
+   c) Collection will comply with applicable privacy laws
+
+5.2. Privacy Requirements:
+   a) You must comply with all applicable privacy laws and regulations
+   b) You must provide appropriate privacy notices to End Users
+   c) You must obtain necessary consents for data collection
+   d) You must implement appropriate data security measures
+
+## 6. WARRANTY DISCLAIMER
+THE CONTENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO:
+a) WARRANTIES OF MERCHANTABILITY
+b) FITNESS FOR A PARTICULAR PURPOSE
+c) NON-INFRINGEMENT
+d) ACCURACY OR COMPLETENESS
+e) ABSENCE OF ERRORS OR DEFECTS
+f) COMPATIBILITY WITH OTHER SOFTWARE
+g) SECURITY OR PERFORMANCE
+
+## 7. LIMITATION OF LIABILITY
+7.1. IN NO EVENT SHALL HELPINGAI BE LIABLE FOR ANY:
+   a) DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES
+   b) LOSS OF PROFITS OR BUSINESS OPPORTUNITIES
+   c) BUSINESS INTERRUPTION OR LOST DATA
+   d) PERSONAL INJURY OR PROPERTY DAMAGE
+   e) ANY OTHER DAMAGES OR LOSSES
+
+7.2. THIS LIMITATION APPLIES TO:
+   a) CONTRACT OR TORT CLAIMS
+   b) BREACH OF WARRANTY
+   c) ANY OTHER LEGAL THEORY
+   d) ALL USES OF THE CONTENT
+
+## 8. TERMINATION
+8.1. Automatic Termination:
+   a) This License terminates automatically upon any breach
+   b) No notice is required for termination
+   c) All rights granted immediately cease
+
+8.2. Upon Termination:
+   a) Cease all use of the Content
+   b) Destroy all copies and installations
+   c) Stop distribution of Derivative Works
+   d) Certify compliance with termination terms
+
+8.3. Survival:
+   a) Sections 4, 6, 7, 9, and 10 survive termination
+   b) Obligations to protect intellectual property continue
+   c) Liability limitations remain in effect
+
+## 9. GOVERNING LAW AND JURISDICTION
+9.1. This License shall be governed by and construed in accordance with:
+   a) The laws of the United States of America
+   b) The State of California
+   c) Without regard to conflicts of law principles
+
+9.2. Dispute Resolution:
+   a) Exclusive jurisdiction in Santa Clara County, California
+   b) Agreement to personal jurisdiction
+   c) Waiver of jury trial
+   d) Prevailing party entitled to attorney fees
+
+## 10. EXPORT COMPLIANCE
+10.1. You must comply with all applicable:
+   a) Export control laws and regulations
+   b) Trade sanctions and embargoes
+   c) International trade restrictions
+   d) Anti-boycott regulations
+
+10.2. You may not export the Content to:
+   a) Prohibited countries or regions
+   b) Restricted end users
+   c) Prohibited end uses
+
+## 11. MODIFICATIONS TO LICENSE
+11.1. License Updates:
+   a) HelpingAI may modify this License at any time
+   b) Changes effective upon posting
+   c) Continued use constitutes acceptance
+
+11.2. Notification:
+   a) Material changes will be announced
+   b) Users should regularly review terms
+   c) Opt-out requires discontinuing use
+
+## 12. SUPPORT AND UPDATES
+12.1. No Obligation:
+   a) HelpingAI has no obligation to provide support
+   b) Updates and maintenance are discretionary
+   c) Services may be modified or discontinued
+
+12.2. Available Support:
+   a) Documentation and resources provided "as is"
+   b) Community forums may be available
+   c) Commercial support requires separate agreement
+
+<!-- ## 13. CONTACT INFORMATION
+For licensing inquiries, permissions, or compliance:
+- Website: https://helpingai.co
+- Email: license@helpingai.co
+- Address: [Company Address] -->
+
+---
+Last Updated: NOVEMBER 2024
+END OF LICENSE

{webscout-6.2b0.dist-info → webscout-6.4.dist-info}/METADATA

@@ -1,13 +1,12 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.2b0
+Version: 6.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
 License: HelpingAI
-Project-URL: Documentation, https://github.com/OE-LUCIFER/Webscout/wiki
-Project-URL: Source, https://github.com/OE-LUCIFER/Webscout
-Project-URL: Tracker, https://github.com/OE-LUCIFER/Webscout/issues
+Project-URL: Source, https://github.com/HelpingAI/Webscout
+Project-URL: Tracker, https://github.com/HelpingAI/Webscout/issues
 Project-URL: YouTube, https://youtube.com/@OEvortex
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -25,8 +24,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: docstring-inheritance
-Requires-Dist: click
+Requires-Dist: mistune
+Requires-Dist: tenacity
 Requires-Dist: curl-cffi
 Requires-Dist: nest-asyncio
 Requires-Dist: g4f>=0.2.2.3
@@ -47,21 +46,17 @@ Requires-Dist: playsound
 Requires-Dist: ollama
 Requires-Dist: pyfiglet
 Requires-Dist: pillow
-Requires-Dist: requests-html
 Requires-Dist: bson
 Requires-Dist: cloudscraper
 Requires-Dist: emoji
 Requires-Dist: openai
 Requires-Dist: prompt-toolkit
-Requires-Dist: fake-useragent
 Requires-Dist: primp
 Requires-Dist: pyreqwest-impersonate
 Requires-Dist: lxml-html-clean
 Requires-Dist: gradio-client
 Requires-Dist: psutil
-Requires-Dist: colorlog
 Requires-Dist: yaspin
-Requires-Dist: cerebras-cloud-sdk
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
@@ -74,9 +69,9 @@ Requires-Dist: unicorn; extra == "local"
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/devsdocode"><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/sree.shades_/"><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/developer-sreejan/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
+  <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://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>
 
@@ -121,7 +116,11 @@ Requires-Dist: unicorn; extra == "local"
 * **GGUF Conversion & Quantization:** Convert and quantize Hugging Face models to GGUF format.
 * **Autollama:** Download Hugging Face models and automatically convert them for Ollama compatibility.
 * **Function Calling (Beta):** Experiment with function calling capabilities for enhanced AI interactions.
-
+* **[SwiftCLI](webscout/swiftcli/Readme.md):** A powerful and elegant CLI framework that makes it easy to create beautiful command-line interfaces.
+* **[LitPrinter](webscout/litprinter/Readme.md):** Provides beautiful, styled console output with rich formatting and colors
+* **[LitLogger](webscout/litlogger/Readme.md):** Simplifies logging with customizable formats and color schemes
+* **[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
 
 ## ⚙️ Installation
 ```python
@@ -819,17 +818,6 @@ with WEBS() as WEBS:
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager
-
-**Every TTI provider has the same usage code, you just need to change the import.**
-
-```python
-from webscout import DeepInfraImager
-bot = DeepInfraImager()
-resp = bot.generate("AI-generated image - webscout", 1)
-print(bot.save(resp))
-```
-
 ### 🗣️ Text to Speech - Voicepods, StreamElements
 
 ```python
@@ -938,9 +926,9 @@ ai.tool_registry.register_tool(
     parameters={
         "type": "object",
         "properties": {
-            "location": {"type": "string", "description": "The city and state, or zip code"}
+            "location": {"title": "Location", "type": "string"}
         },
-        "required": ["location"],
+        "required": ["location"]
     },
 )
 
@@ -1021,8 +1009,7 @@ meta_ai = Meta(fb_email=fb_email, fb_password=fb_password)
 # Text prompt with web search
 response = meta_ai.ask("what is currently happning in bangladesh in aug 2024")
 print(response["message"]) # Access the text message
-print("Sources:", response["sources"]) # Access sources (if ```python
-any)
+print("Sources:", response["sources"]) # Access sources (if any)
 
 # Image generation
 response = meta_ai.ask("Create an image of a cat wearing a hat.") 
@@ -1357,36 +1344,28 @@ if __name__ == "__main__":
     main()
 ```
 
-###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, AIUncensored, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro
+###  LLAMA3, pizzagpt, RUBIKSAI, Koala, Darkai, AI4Chat, Farfalle, PIAI, Felo, Julius, YouChat, YEPCHAT, Cloudflare, TurboSeek, Editee, AI21, Chatify, Cerebras, X0GPT, Lepton, GEMINIAPI, Cleeai, Elmo, Genspark, Upstage, Free2GPT, Bing, DiscordRocks, GPTWeb, LlamaTutor, PromptRefine, AIUncensored, TutorAI, ChatGPTES, Bagoodex, ChatHub, AmigoChat, AIMathGPT, GaurishCerebras, NinjaChat, GeminiPro, Talkai, LLMChat, AskMyAI, Llama3Mitril, Marcus, PerplexityLabs, TypeGPT, Mhystical
 
 Code is similar to other providers.
 
 ### `LLM`
 
 ```python
-from webscout.LLM import LLM
-
-# Read the system message from the file
-with open('system.txt', 'r') as file:
-    system_message = file.read()
-
-# Initialize the LLM class with the model name and system message
-llm = LLM(model="microsoft/WizardLM-2-8x22B", system_message=system_message)
-
-while True:
-    # Get the user input
-    user_input = input("User: ")
-
-    # Define the messages to be sent
-    messages = [
-        {"role": "user", "content": user_input}
+from webscout.LLM import LLM, VLM
+
+# Chat with text
+llm = LLM("meta-llama/Meta-Llama-3-70B-Instruct")
+response = llm.chat([{"role": "user", "content": "What's good?"}])
+
+# Chat with images
+vlm = VLM("cogvlm-grounding-generalist")
+response = vlm.chat([{
+    "role": "user",
+    "content": [
+        {"type": "image", "image_url": "cool_pic.jpg"},
+        {"type": "text", "text": "What's in this image?"}
     ]
-
-    # Use the mistral_chat method to get the response
-    response = llm.chat(messages)
-
-    # Print the response
-    print("AI: ", response)
+}])
 ```
 
 ##  💻 Local-LLM
@@ -1563,9 +1542,9 @@ python -m webscout.webai webai --provider "phind" --rawdog
 
 <div align="center">
   <!-- Replace `#` with your actual links -->
-  <a href="https://t.me/devsdocode"><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/sree.shades_/"><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/developer-sreejan/"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
+  <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://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>