webscout 2025.10.14.1__tar.gz → 2025.10.16__tar.gz

{webscout-2025.10.14.1/webscout.egg-info → webscout-2025.10.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webscout
-Version: 2025.10.14.1
+Version: 2025.10.16
 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-email: OEvortex <helpingai5@gmail.com>
 License: HelpingAI
@@ -70,15 +70,13 @@ Requires-Dist: uvicorn[standard]; extra == "api"
 Requires-Dist: pydantic; extra == "api"
 Requires-Dist: python-multipart; extra == "api"
 Requires-Dist: tiktoken; extra == "api"
-Requires-Dist: motor; extra == "api"
 Requires-Dist: jinja2; extra == "api"
-Requires-Dist: supabase; extra == "api"
 Requires-Dist: websockets>=11.0; extra == "api"
 Requires-Dist: starlette; extra == "api"
 Dynamic: license-file
 
 <div align="center">
-  <a href="https://github.com/OEvortex/Webscout">
+  <a href="https://github.com/pyscout/Webscout">
     <img src="https://img.shields.io/badge/WebScout-Ultimate%20Toolkit-blue?style=for-the-badge&logo=python&logoColor=white" alt="WebScout Logo">
   </a>
  
@@ -96,7 +94,7 @@ Dynamic: license-file
     <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout/month?style=flat-square" alt="Monthly Downloads"></a>
     <a href="https://pepy.tech/project/webscout"><img src="https://static.pepy.tech/badge/webscout?style=flat-square" alt="Total Downloads"></a>
     <a href="#"><img src="https://img.shields.io/pypi/pyversions/webscout?style=flat-square&logo=python" alt="Python Version"></a>
-    <a href="https://deepwiki.com/OEvortex/Webscout"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
+    <a href="https://deepwiki.com/pyscout/Webscout"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   </p>
 </div>
 
@@ -108,9 +106,7 @@ Dynamic: license-file
 - [⚙️ Installation](#️-installation)
 - [🖥️ Command Line Interface](#️-command-line-interface)
 - [🔄 OpenAI-Compatible API Server](docs/openai-api-server.md)
-- [🔍 Search Engines](#-search-engines)
-- [🦆 DuckDuckGo Search](#-duckduckgo-search-with-webs-and-asyncwebs)
-- [💻 WEBS API Reference](#-webs-api-reference)
+- [🕸️ Scout: HTML Parser & Web Crawler](docs/scout.md)
 - [🤖 AI Models and Voices](#-ai-models-and-voices)
 - [💬 AI Chat Providers](#-ai-chat-providers)
 - [👨‍💻 Advanced AI Interfaces](#-advanced-ai-interfaces)
@@ -124,7 +120,7 @@ Dynamic: license-file
 >
 > - **Native Compatibility:** Webscout's own native API for maximum flexibility
 > - **OpenAI Compatibility:** Use providers with OpenAI-compatible interfaces
-> - **Local LLM Compatibility:** Run local models with [Inferno](https://github.com/HelpingAI/inferno), an OpenAI-compatible server (now a standalone package)
+> - **Local LLM Compatibility:** Run local models with OpenAI-compatible servers
 >
 > Choose the approach that best fits your needs! For OpenAI compatibility, check the [OpenAI Providers README](webscout/Provider/OPENAI/README.md) or see the [OpenAI-Compatible API Server](#-openai-compatible-api-server) section below.
 
@@ -151,11 +147,11 @@ Dynamic: license-file
 <summary><b>Search & AI</b></summary>
 <p>
 
-- **Comprehensive Search:** Leverage Google, DuckDuckGo, and Yep for diverse search results
+- **Comprehensive Search:** Access multiple search engines including DuckDuckGo, Yep, Bing, Brave, Yahoo, Yandex, Mojeek, and Wikipedia for diverse search results ([Search Documentation](docs/search.md))
 - **AI Powerhouse:** Access and interact with various AI models through three compatibility options:
   - **Native API:** Use Webscout's native interfaces for providers like OpenAI, Cohere, Gemini, and many more
   - **[OpenAI-Compatible Providers](webscout/Provider/OPENAI/README.md):** Seamlessly integrate with various AI providers using standardized OpenAI-compatible interfaces
-  - **[Local LLMs with Inferno](https://github.com/HelpingAI/inferno):** Run local models with an OpenAI-compatible server (now available as a standalone package)
+  - **Local LLMs:** Run local models with OpenAI-compatible servers (see [Inferno documentation](docs/inferno.md))
 - **[AI Search](webscout/Provider/AISEARCH/README.md):** AI-powered search engines with advanced capabilities
 </p>
 </details>
@@ -180,8 +176,7 @@ Dynamic: license-file
 - **[LitPrinter](webscout/litprinter/Readme.md):** Styled console output with rich formatting and colors
 - **[LitLogger](webscout/litlogger/README.md):** Simplified logging with customizable formats and color schemes
 - **[LitAgent](webscout/litagent/Readme.md):** Modern user agent generator that keeps your requests undetectable
-- **[Scout](webscout/scout/README.md):** Advanced web parsing and crawling library with intelligent HTML/XML parsing
-- **[Inferno](https://github.com/HelpingAI/inferno):** Run local LLMs with an OpenAI-compatible API and interactive CLI (now a standalone package: `pip install inferno-llm`)
+- **[Scout](docs/scout.md):** Advanced web parsing and crawling library with intelligent HTML/XML parsing
 - **[GGUF Conversion](webscout/Extra/gguf.md):** Convert and quantize Hugging Face models to GGUF format
 - **[Utility Decorators](docs/decorators.md):** Easily measure function execution time (`timeIt`) and add retry logic (`retry`) to any function
 - **[Stream Sanitization Utilities](docs/sanitize.md):** Advanced tools for cleaning, decoding, and processing data streams
@@ -248,7 +243,7 @@ webscout-server
 
 ```bash
 # Clone the repository
-git clone https://github.com/OEvortex/Webscout.git
+git clone https://github.com/pyscout/Webscout.git
 cd Webscout
 
 # Install in development mode with UV
@@ -265,8 +260,8 @@ uv pip install -e ".[dev,api]"
 
 ```bash
 # Pull and run the Docker image
-docker pull oevortex/webscout:latest
-docker run -it oevortex/webscout:latest
+docker pull pyscout/webscout:latest
+docker run -it pyscout/webscout:latest
 ```
 
 ### 📱 Quick Start Commands
@@ -325,328 +320,15 @@ python -m webscout-server
 <summary><b>🔍 Web Search Commands</b></summary>
 <p>
 
-| Command                           | Description                 | Example                                   |
-| --------------------------------- | --------------------------- | ----------------------------------------- |
-| `webscout text -k "query"`        | Perform a text search       | `webscout text -k "python programming"`   |
-| `webscout answers -k "query"`     | Get instant answers         | `webscout answers -k "what is AI"`        |
-| `webscout images -k "query"`      | Search for images           | `webscout images -k "nature photography"` |
-| `webscout videos -k "query"`      | Search for videos           | `webscout videos -k "python tutorials"`   |
-| `webscout news -k "query"`        | Search for news articles    | `webscout news -k "technology trends"`    |
-| `webscout maps -k "query"`        | Perform a maps search       | `webscout maps -k "restaurants near me"`  |
-| `webscout translate -k "text"`    | Translate text              | `webscout translate -k "hello world"`     |
-| `webscout suggestions -k "query"` | Get search suggestions      | `webscout suggestions -k "how to"`        |
-| `webscout weather -l "location"`  | Get weather information     | `webscout weather -l "New York"`          |
-| `webscout version`                | Display the current version | `webscout version`                        |
-
-**Google Search Commands:**
-| Command | Description | Example |
-|---------|-------------|---------|
-| `webscout google_text -k "query"` | Google text search | `webscout google_text -k "machine learning"` |
-| `webscout google_news -k "query"` | Google news search | `webscout google_news -k "AI breakthrough"` |
-| `webscout google_suggestions -q "query"` | Google suggestions | `webscout google_suggestions -q "python"` |
-
-**Yep Search Commands:**
-| Command | Description | Example |
-|---------|-------------|---------|
-| `webscout yep_text -k "query"` | Yep text search | `webscout yep_text -k "web development"` |
-| `webscout yep_images -k "query"` | Yep image search | `webscout yep_images -k "landscapes"` |
-| `webscout yep_suggestions -q "query"` | Yep suggestions | `webscout yep_suggestions -q "javascript"` |
+Webscout provides comprehensive CLI commands for all search engines. See the [Search Documentation](docs/search.md#command-line-interface) for detailed command reference.
 
 </p>
 </details>
 
-<details open>
-<summary><b>Inferno LLM Commands</b></summary>
-<p>
-
-Inferno is now a standalone package. Install it separately with:
-
-```bash
-pip install inferno-llm
-```
-
-After installation, you can use its CLI for managing and using local LLMs:
-
-```bash
-inferno --help
-```
-
-| Command                  | Description                                     |
-| ------------------------ | ----------------------------------------------- |
-| `inferno pull <model>`   | Download a model from Hugging Face              |
-| `inferno list`           | List downloaded models                          |
-| `inferno serve <model>`  | Start a model server with OpenAI-compatible API |
-| `inferno run <model>`    | Chat with a model interactively                 |
-| `inferno remove <model>` | Remove a downloaded model                       |
-| `inferno version`        | Show version information                        |
-
-For more information, visit the [Inferno GitHub repository](https://github.com/HelpingAI/inferno) or [PyPI package page](https://pypi.org/project/inferno-llm/).
-
-</p>
-</details>
-
-> [!NOTE]  
-> **Hardware requirements for running models with Inferno:**
->
-> - Around 2 GB of RAM for 1B models
-> - Around 4 GB of RAM for 3B models
-> - At least 8 GB of RAM for 7B models
-> - 16 GB of RAM for 13B models
-> - 32 GB of RAM for 33B models
-> - GPU acceleration is recommended for better performance
-
 For detailed information about the OpenAI-compatible API server, including setup, configuration, and usage examples, see the [OpenAI API Server Documentation](docs/openai-api-server.md).
 
 <hr/>
 
-## 🔍 Search Engines
-
-Webscout provides multiple search engine interfaces for diverse search capabilities.
-
-### YepSearch - Yep.com Interface
-
-```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
-)
-
-# Image Search
-image_results = yep.images(
-    keywords="nature photography",
-    region="all",
-    safesearch="moderate",
-    max_results=10
-)
-
-# Get search suggestions
-suggestions = yep.suggestions("hist")
-```
-
-### GoogleSearch - Google Interface
-
-```python
-from webscout import GoogleSearch
-
-# Initialize GoogleSearch
-google = GoogleSearch(
-    timeout=10,  # Optional: Set custom timeout
-    proxies=None,  # Optional: Use proxies
-    verify=True   # Optional: SSL verification
-)
-
-# Text Search
-text_results = google.text(
-    keywords="artificial intelligence",
-    region="us",           # Optional: Region for results
-    safesearch="moderate",  # Optional: "on", "moderate", "off"
-    max_results=10          # Optional: Limit number of results
-)
-for result in text_results:
-    print(f"Title: {result.title}")
-    print(f"URL: {result.url}")
-    print(f"Description: {result.description}")
-
-# News Search
-news_results = google.news(
-    keywords="technology trends",
-    region="us",
-    safesearch="moderate",
-    max_results=5
-)
-
-# Get search suggestions
-suggestions = google.suggestions("how to")
-
-# Legacy usage is still supported
-from webscout import search
-results = search("Python programming", num_results=5)
-```
-
-<hr/>
-
-## 🦆 DuckDuckGo Search with WEBS
-
-Webscout provides powerful interfaces to DuckDuckGo's search capabilities through the `WEBS` and `AsyncWEBS` classes.
-
-<details open>
-<summary><b>Synchronous Usage with WEBS</b></summary>
-<p>
-
-```python
-from webscout import WEBS
-
-# Use as a context manager for proper resource management
-with WEBS() as webs:
-    # Simple text search
-    results = webs.text("python programming", max_results=5)
-    for result in results:
-        print(f"Title: {result['title']}\nURL: {result['url']}")
-```
-
-</p>
-</details>
-
-<details open>
-<summary><b>Asynchronous Usage with AsyncWEBS</b></summary>
-<p>
-
-```python
-import asyncio
-from webscout import AsyncWEBS
-
-async def search_multiple_terms(search_terms):
-    async with AsyncWEBS() as webs:
-        # Create tasks for each search term
-        tasks = [webs.text(term, max_results=5) for term in search_terms]
-        # Run all searches concurrently
-        results = await asyncio.gather(*tasks)
-        return results
-
-async def main():
-    terms = ["python", "javascript", "machine learning"]
-    all_results = await search_multiple_terms(terms)
-
-    # Process results
-    for i, term_results in enumerate(all_results):
-        print(f"Results for '{terms[i]}':\n")
-        for result in term_results:
-            print(f"- {result['title']}")
-        print("\n")
-
-# Run the async function
-asyncio.run(main())
-```
-
-</p>
-</details>
-
-> [!TIP]
-> Always use these classes with a context manager (`with` statement) to ensure proper resource management and cleanup.
-
-<hr/>
-
-## 💻 WEBS API Reference
-
-The WEBS class provides comprehensive access to DuckDuckGo's search capabilities through a clean, intuitive API.
-
-### Available Search Methods
-
-| Method          | Description         | Example                                      |
-| --------------- | ------------------- | -------------------------------------------- |
-| `text()`        | General web search  | `webs.text('python programming')`            |
-| `answers()`     | Instant answers     | `webs.answers('population of france')`       |
-| `images()`      | Image search        | `webs.images('nature photography')`          |
-| `videos()`      | Video search        | `webs.videos('documentary')`                 |
-| `news()`        | News articles       | `webs.news('technology')`                    |
-| `maps()`        | Location search     | `webs.maps('restaurants', place='new york')` |
-| `translate()`   | Text translation    | `webs.translate('hello', to='es')`           |
-| `suggestions()` | Search suggestions  | `webs.suggestions('how to')`                 |
-| `weather()`     | Weather information | `webs.weather('london')`                     |
-
-<details>
-<summary><b>Example: Text Search</b></summary>
-<p>
-
-```python
-from webscout import WEBS
-
-with WEBS() as webs:
-    results = webs.text(
-        'artificial intelligence',
-        region='wt-wt',        # Optional: Region for results
-        safesearch='off',      # Optional: 'on', 'moderate', 'off'
-        timelimit='y',         # Optional: Time limit ('d'=day, 'w'=week, 'm'=month, 'y'=year)
-        max_results=10         # Optional: Limit number of results
-    )
-
-    for result in results:
-        print(f"Title: {result['title']}")
-        print(f"URL: {result['url']}")
-        print(f"Description: {result['body']}\n")
-```
-
-</p>
-</details>
-
-<details>
-<summary><b>Example: News Search with Formatting</b></summary>
-<p>
-
-```python
-from webscout.search import DuckDuckGoSearch
-
-def fetch_formatted_news(keywords, timelimit='d', max_results=20):
-    """Fetch and format news articles"""
-    with WEBS() as webs:
-        # Get news results
-        news_results = webs.news(
-            keywords,
-            region="wt-wt",
-            safesearch="off",
-            timelimit=timelimit,  # 'd'=day, 'w'=week, 'm'=month
-            max_results=max_results
-        )
-
-        # Format the results
-        formatted_news = []
-        for i, item in enumerate(news_results, 1):
-            # Format the date
-            date = datetime.datetime.fromisoformat(item['date']).strftime('%B %d, %Y')
-
-            # Create formatted entry
-            entry = f"{i}. {item['title']}\n"
-            entry += f"   Published: {date}\n"
-            entry += f"   {item['body']}\n"
-            entry += f"   URL: {item['url']}\n"
-
-            formatted_news.append(entry)
-
-        return formatted_news
-
-# Example usage
-news = fetch_formatted_news('artificial intelligence', timelimit='w', max_results=5)
-print('\n'.join(news))
-```
-
-</p>
-</details>
-
-<details>
-<summary><b>Example: Weather Information</b></summary>
-<p>
-
-```python
-from webscout import WEBS
-
-with WEBS() as webs:
-    # Get weather for a location
-    weather = webs.weather("New York")
-
-    # Access weather data
-    if weather:
-        print(f"Location: {weather.get('location', 'Unknown')}")
-        print(f"Temperature: {weather.get('temperature', 'N/A')}")
-        print(f"Conditions: {weather.get('condition', 'N/A')}")
-```
-
-</p>
-</details>
-
-<hr/>
-
 ## 🤖 AI Models and Voices
 
 Webscout provides easy access to a wide range of AI models and voice options.
@@ -781,7 +463,7 @@ for media in response.get("media", []):
 <p>
 
 ```python
-from webscout import GROQ, WEBS
+from webscout import GROQ, DuckDuckGoSearch
 import json
 
 # Initialize GROQ client
@@ -799,7 +481,8 @@ def calculate(expression):
 def search(query):
     """Perform a web search"""
     try:
-        results = WEBS().text(query, max_results=3)
+        ddg = DuckDuckGoSearch()
+        results = ddg.text(query, max_results=3)
         return json.dumps({"results": results})
     except Exception as e:
         return json.dumps({"error": str(e)})