webscout 8.2.7__tar.gz → 8.2.8__tar.gz

webscout-8.2.8/LEGAL_NOTICE.md

@@ -0,0 +1,152 @@
+# Legal Notice
+
+> [!IMPORTANT]
+> This repository is **not associated with or endorsed** by the providers of the APIs contained herein. This project is intended **for educational purposes only**. It is a personal project aimed at learning and exploration.
+
+## Affiliation Disclaimer
+
+This repository is not associated with or endorsed by any of the API providers mentioned herein, including but not limited to:
+
+- DuckDuckGo
+- Google
+- Meta
+- OpenAI
+- Anthropic
+- Cohere
+- Perplexity
+- Yep.com
+- HuggingFace
+- And others
+
+All trademarks, API services, and other intellectual property referenced are the property of their respective owners. No claim of ownership or affiliation is made by this project.
+
+Owners of any included sites or services may contact the maintainers to improve their security or request the removal of their content from this repository.
+
+---
+
+## License
+
+This repository is licensed under the Apache License, Version 2.0 with additional terms specific to Webscout's API usage and third-party services.
+
+> 📄 The full text of this license is available in the [LICENSE.md](./LICENSE.md) file.
+
+---
+
+## Liability Limitation
+
+In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, consequential, or exemplary damages of any character arising as a result of this License or out of the use or inability to use the Work.
+
+---
+
+## No Warranties
+
+> [!WARNING]
+> The Work is provided on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of:
+> - TITLE
+> - NON-INFRINGEMENT
+> - MERCHANTABILITY
+> - FITNESS FOR A PARTICULAR PURPOSE
+
+You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+---
+
+## User Responsibility
+
+> [!IMPORTANT]
+> Users assume all risks associated with the use of this repository. They are responsible for ensuring their use complies with all terms of service for the APIs accessed through this toolkit and must obtain any necessary permissions or licenses for third-party services.
+
+---
+
+## Legal Compliance
+
+Users are responsible for ensuring that their use of the repository and its contents complies with all applicable:
+
+- Local laws and regulations
+- State laws and regulations
+- National laws and regulations
+- International laws and regulations
+
+Including but not limited to:
+* Privacy laws
+* Data protection regulations
+* Export control laws
+
+---
+
+## Redistribution Requirements
+
+When redistributing copies of the Work or Derivative Works thereof:
+
+1. You **must** give recipients a copy of the License
+2. You **must** cause any modified files to carry prominent notices stating that You changed the files
+3. You **must** retain all copyright, patent, trademark, and attribution notices from the Source form of the Work
+4. You **must** include any NOTICE file as part of its distribution
+
+---
+
+## Third-Party Services
+
+> [!NOTE]
+> When using the APIs and services accessed through this Work, you must:
+>
+> 1. Comply with all terms of service of the respective API providers
+> 2. Maintain appropriate attribution and licenses for third-party services
+> 3. Be responsible for obtaining any necessary permissions or licenses
+> 4. Not use the Work in any way that could damage or overload third-party services
+
+---
+
+## Trademarks
+
+This License does not grant permission to use trade names, trademarks, service marks, or product names of the contributors, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+---
+
+## Privacy Notice
+
+> [!NOTE]
+> Webscout may collect usage data and performance metrics. By using this repository, you acknowledge that:
+>
+> 1. Such data collection will comply with applicable privacy laws
+> 2. You must provide appropriate privacy notices to end users
+> 3. You must obtain necessary consents for data collection
+> 4. You must implement appropriate data security measures
+
+---
+
+## Contributions
+
+Unless explicitly stated otherwise, any Contribution intentionally submitted for inclusion in the Work shall be under the terms and conditions of this License, without any additional terms or conditions.
+
+**FOR CONTRIBUTORS**: By submitting content to this project, you agree to the terms outlined in this document.
+
+---
+
+## Export Compliance
+
+The Work and its use may be subject to export laws and regulations. Users agree to comply with all such laws and regulations that may apply to the Work after distribution.
+
+---
+
+## Severability
+
+If any provision of this notice is found to be unlawful, void, or unenforceable, that provision shall be deemed severable from this notice and shall not affect the validity and enforceability of the remaining provisions.
+
+---
+
+## Updates and Changes
+
+> [!NOTE]
+> The author reserves the right to modify, update, or remove any content, information, or features in this repository at any time without prior notice. Users are responsible for regularly reviewing the content and any changes made to this repository.
+
+---
+
+<details>
+<summary><strong>Document Version Information</strong></summary>
+
+- **Last Updated**: April 14, 2025
+- **Version**: 1.2
+- **Document Owner**: Webscout Team
+</details>
+

webscout-8.2.8/MANIFEST.in

@@ -0,0 +1,12 @@
+include LICENSE.md
+include README.md
+include LEGAL_NOTICE.md
+include changelog.md
+
+recursive-include webscout *
+
+# Exclude common unwanted files and directories
+recursive-exclude webscout __pycache__
+recursive-exclude webscout *.pyc
+recursive-exclude webscout *.pyo
+recursive-exclude webscout *.pyd

{webscout-8.2.7/webscout.egg-info → webscout-8.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webscout
-Version: 8.2.7
+Version: 8.2.8
 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
@@ -39,7 +39,6 @@ Requires-Dist: wheel
 Requires-Dist: pip
 Requires-Dist: nodriver
 Requires-Dist: mistune
-Requires-Dist: tenacity
 Requires-Dist: curl_cffi
 Requires-Dist: nest-asyncio
 Requires-Dist: websocket-client
@@ -49,7 +48,6 @@ 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: ollama
@@ -59,14 +57,17 @@ Requires-Dist: cloudscraper
 Requires-Dist: html5lib
 Requires-Dist: aiofiles
 Requires-Dist: openai
-Requires-Dist: prompt-toolkit
-Requires-Dist: pyreqwest_impersonate
 Requires-Dist: gradio_client
 Requires-Dist: psutil
 Requires-Dist: aiohttp
 Provides-Extra: dev
 Requires-Dist: ruff>=0.1.6; extra == "dev"
 Requires-Dist: pytest>=7.4.2; extra == "dev"
+Provides-Extra: api
+Requires-Dist: fastapi; extra == "api"
+Requires-Dist: uvicorn[standard]; extra == "api"
+Requires-Dist: pydantic; extra == "api"
+Requires-Dist: python-multipart; extra == "api"
 Dynamic: license-file
 
 <div align="center">
@@ -88,6 +89,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>
   </p>
 </div>
 
@@ -98,6 +100,7 @@ Dynamic: license-file
 - [🌟 Key Features](#-features)
 - [⚙️ Installation](#️-installation)
 - [🖥️ Command Line Interface](#️-command-line-interface)
+- [🔄 OpenAI-Compatible API Server](#-openai-compatible-api-server)
 - [🔍 Search Engines](#-search-engines)
 - [🦆 DuckDuckGo Search](#-duckduckgo-search-with-webs-and-asyncwebs)
 - [💻 WEBS API Reference](#-webs-api-reference)
@@ -115,7 +118,7 @@ Dynamic: license-file
 > - **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)
 >
-> Choose the approach that best fits your needs! For OpenAI compatibility, check the [OpenAI Providers README](webscout/Provider/OPENAI/README.md).
+> 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.
 
 > [!NOTE]
 > Webscout supports over 90 AI providers including: LLAMA, C4ai, Venice, Copilot, HuggingFaceChat, PerplexityLabs, DeepSeek, WiseCat, GROQ, OPENAI, GEMINI, DeepInfra, Meta, YEPCHAT, TypeGPT, ChatGPTClone, ExaAI, Claude, Anthropic, Cloudflare, AI21, Cerebras, and many more. All providers follow similar usage patterns with consistent interfaces.
@@ -212,7 +215,6 @@ python -m webscout --help
 | Command | Description |
 |---------|-------------|
 | `python -m webscout answers -k "query"` | Perform an answers search |
-| `python -m webscout chat` | Start an interactive AI chat session |
 | `python -m webscout images -k "query"` | Search for images |
 | `python -m webscout maps -k "query"` | Perform a maps search |
 | `python -m webscout news -k "query"` | Search for news articles |
@@ -269,6 +271,111 @@ For more information, visit the [Inferno GitHub repository](https://github.com/H
 > - 32 GB of RAM for 33B models
 > - GPU acceleration is recommended for better performance
 
+<details open>
+<summary><b>🔄 OpenAI-Compatible API Server</b></summary>
+<p>
+
+Webscout includes an OpenAI-compatible API server that allows you to use any supported provider with tools and applications designed for OpenAI's API.
+
+### Starting the API Server
+
+#### From Command Line
+
+```bash
+# Start with default settings (port 8000)
+python -m webscout.Provider.OPENAI.api
+
+# Start with custom port
+python -m webscout.Provider.OPENAI.api --port 8080
+
+# Start with API key authentication
+python -m webscout.Provider.OPENAI.api --api-key "your-secret-key"
+
+# Specify a default provider
+python -m webscout.Provider.OPENAI.api --default-provider "Claude"
+
+# Run in debug mode
+python -m webscout.Provider.OPENAI.api --debug
+```
+
+#### From Python Code
+
+```python
+# Method 1: Using the helper function
+from webscout.Provider.OPENAI.api import start_server
+
+# Start with default settings
+start_server()
+
+# Start with custom settings
+start_server(port=8080, api_key="your-secret-key", default_provider="Claude")
+
+# Method 2: Using the run_api function for more control
+from webscout.Provider.OPENAI.api import run_api
+
+run_api(
+    host="0.0.0.0",
+    port=8080,
+    api_key="your-secret-key",
+    default_provider="Claude",
+    debug=True
+)
+```
+
+### Using the API
+
+Once the server is running, you can use it with any OpenAI client library or tool:
+
+```python
+# Using the OpenAI Python client
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-secret-key",  # Only needed if you set an API key
+    base_url="http://localhost:8000/v1"  # Point to your local server
+)
+
+# Chat completion
+response = client.chat.completions.create(
+    model="gpt-4",  # This can be any model name registered with Webscout
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Hello, how are you?"}
+    ]
+)
+
+print(response.choices[0].message.content)
+```
+
+### Using with cURL
+
+```bash
+# Basic chat completion request
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your-secret-key" \
+  -d '{
+    "model": "gpt-4",
+    "messages": [
+      {"role": "system", "content": "You are a helpful assistant."},
+      {"role": "user", "content": "Hello, how are you?"}
+    ]
+  }'
+
+# List available models
+curl http://localhost:8000/v1/models \
+  -H "Authorization: Bearer your-secret-key"
+```
+
+### Available Endpoints
+
+- `GET /v1/models` - List all available models
+- `GET /v1/models/{model_name}` - Get information about a specific model
+- `POST /v1/chat/completions` - Create a chat completion
+
+</p>
+</details>
+
 <hr/>
 
 ## 🔍 Search Engines
@@ -605,30 +712,12 @@ Webscout offers a comprehensive collection of AI chat providers, giving you acce
 | `DeepInfra` | Various open models | Multiple model options |
 | `Cohere` | Cohere's language models | Command models |
 | `PerplexityLabs` | Perplexity AI | Web search integration |
-| `Anthropic` | Claude models | Long context windows |
 | `YEPCHAT` | Yep.com's AI | Streaming responses |
 | `ChatGPTClone` | ChatGPT-like interface | Multiple model options |
-| `TypeGPT` | TypeChat models | Code generation focus |
+| `TypeGPT` | TypeChat models | Multiple model options |
 
 </div>
 
-<details>
-<summary><b>Example: Using Duckchat</b></summary>
-<p>
-
-```python
-from webscout import WEBS
-
-# Initialize and use Duckchat
-with WEBS() as webs:
-    response = webs.chat(
-        "Explain quantum computing in simple terms",
-        model='gpt-4o-mini'  # Options: mixtral-8x7b, llama-3.1-70b, claude-3-haiku, etc.
-    )
-    print(response)
-```
-</p>
-</details>
 
 <details>
 <summary><b>Example: Using Meta AI</b></summary>
@@ -740,41 +829,7 @@ print(response)
 </p>
 </details>
 
-<hr/>
-
-## 👨‍💻 Advanced AI Interfaces
-
-<details open>
-<summary><b>Direct Model Access with LLM and VLM</b></summary>
-<p>
-
-Webscout provides direct interfaces to language and vision-language models through the `LLM` and `VLM` classes.
-
-```python
-from webscout.LLM import LLM, VLM
 
-# Text-only model interaction
-llm = LLM("meta-llama/Meta-Llama-3-70B-Instruct")
-response = llm.chat([
-    {"role": "user", "content": "Explain the concept of neural networks"}
-])
-print(response)
-
-# Vision-language model interaction
-vlm = VLM("cogvlm-grounding-generalist")
-response = vlm.chat([
-    {
-        "role": "user",
-        "content": [
-            {"type": "image", "image_url": "path/to/image.jpg"},
-            {"type": "text", "text": "Describe what you see in this image"}
-        ]
-    }
-])
-print(response)
-```
-</p>
-</details>
 
 <details open>
 <summary><b>GGUF Model Conversion</b></summary>

{webscout-8.2.7 → webscout-8.2.8}/README.md

@@ -17,6 +17,7 @@
     <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>
   </p>
 </div>
 
@@ -27,6 +28,7 @@
 - [🌟 Key Features](#-features)
 - [⚙️ Installation](#️-installation)
 - [🖥️ Command Line Interface](#️-command-line-interface)
+- [🔄 OpenAI-Compatible API Server](#-openai-compatible-api-server)
 - [🔍 Search Engines](#-search-engines)
 - [🦆 DuckDuckGo Search](#-duckduckgo-search-with-webs-and-asyncwebs)
 - [💻 WEBS API Reference](#-webs-api-reference)
@@ -44,7 +46,7 @@
 > - **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)
 >
-> Choose the approach that best fits your needs! For OpenAI compatibility, check the [OpenAI Providers README](webscout/Provider/OPENAI/README.md).
+> 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.
 
 > [!NOTE]
 > Webscout supports over 90 AI providers including: LLAMA, C4ai, Venice, Copilot, HuggingFaceChat, PerplexityLabs, DeepSeek, WiseCat, GROQ, OPENAI, GEMINI, DeepInfra, Meta, YEPCHAT, TypeGPT, ChatGPTClone, ExaAI, Claude, Anthropic, Cloudflare, AI21, Cerebras, and many more. All providers follow similar usage patterns with consistent interfaces.
@@ -141,7 +143,6 @@ python -m webscout --help
 | Command | Description |
 |---------|-------------|
 | `python -m webscout answers -k "query"` | Perform an answers search |
-| `python -m webscout chat` | Start an interactive AI chat session |
 | `python -m webscout images -k "query"` | Search for images |
 | `python -m webscout maps -k "query"` | Perform a maps search |
 | `python -m webscout news -k "query"` | Search for news articles |
@@ -198,6 +199,111 @@ For more information, visit the [Inferno GitHub repository](https://github.com/H
 > - 32 GB of RAM for 33B models
 > - GPU acceleration is recommended for better performance
 
+<details open>
+<summary><b>🔄 OpenAI-Compatible API Server</b></summary>
+<p>
+
+Webscout includes an OpenAI-compatible API server that allows you to use any supported provider with tools and applications designed for OpenAI's API.
+
+### Starting the API Server
+
+#### From Command Line
+
+```bash
+# Start with default settings (port 8000)
+python -m webscout.Provider.OPENAI.api
+
+# Start with custom port
+python -m webscout.Provider.OPENAI.api --port 8080
+
+# Start with API key authentication
+python -m webscout.Provider.OPENAI.api --api-key "your-secret-key"
+
+# Specify a default provider
+python -m webscout.Provider.OPENAI.api --default-provider "Claude"
+
+# Run in debug mode
+python -m webscout.Provider.OPENAI.api --debug
+```
+
+#### From Python Code
+
+```python
+# Method 1: Using the helper function
+from webscout.Provider.OPENAI.api import start_server
+
+# Start with default settings
+start_server()
+
+# Start with custom settings
+start_server(port=8080, api_key="your-secret-key", default_provider="Claude")
+
+# Method 2: Using the run_api function for more control
+from webscout.Provider.OPENAI.api import run_api
+
+run_api(
+    host="0.0.0.0",
+    port=8080,
+    api_key="your-secret-key",
+    default_provider="Claude",
+    debug=True
+)
+```
+
+### Using the API
+
+Once the server is running, you can use it with any OpenAI client library or tool:
+
+```python
+# Using the OpenAI Python client
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your-secret-key",  # Only needed if you set an API key
+    base_url="http://localhost:8000/v1"  # Point to your local server
+)
+
+# Chat completion
+response = client.chat.completions.create(
+    model="gpt-4",  # This can be any model name registered with Webscout
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Hello, how are you?"}
+    ]
+)
+
+print(response.choices[0].message.content)
+```
+
+### Using with cURL
+
+```bash
+# Basic chat completion request
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your-secret-key" \
+  -d '{
+    "model": "gpt-4",
+    "messages": [
+      {"role": "system", "content": "You are a helpful assistant."},
+      {"role": "user", "content": "Hello, how are you?"}
+    ]
+  }'
+
+# List available models
+curl http://localhost:8000/v1/models \
+  -H "Authorization: Bearer your-secret-key"
+```
+
+### Available Endpoints
+
+- `GET /v1/models` - List all available models
+- `GET /v1/models/{model_name}` - Get information about a specific model
+- `POST /v1/chat/completions` - Create a chat completion
+
+</p>
+</details>
+
 <hr/>
 
 ## 🔍 Search Engines
@@ -534,30 +640,12 @@ Webscout offers a comprehensive collection of AI chat providers, giving you acce
 | `DeepInfra` | Various open models | Multiple model options |
 | `Cohere` | Cohere's language models | Command models |
 | `PerplexityLabs` | Perplexity AI | Web search integration |
-| `Anthropic` | Claude models | Long context windows |
 | `YEPCHAT` | Yep.com's AI | Streaming responses |
 | `ChatGPTClone` | ChatGPT-like interface | Multiple model options |
-| `TypeGPT` | TypeChat models | Code generation focus |
+| `TypeGPT` | TypeChat models | Multiple model options |
 
 </div>
 
-<details>
-<summary><b>Example: Using Duckchat</b></summary>
-<p>
-
-```python
-from webscout import WEBS
-
-# Initialize and use Duckchat
-with WEBS() as webs:
-    response = webs.chat(
-        "Explain quantum computing in simple terms",
-        model='gpt-4o-mini'  # Options: mixtral-8x7b, llama-3.1-70b, claude-3-haiku, etc.
-    )
-    print(response)
-```
-</p>
-</details>
 
 <details>
 <summary><b>Example: Using Meta AI</b></summary>
@@ -669,41 +757,7 @@ print(response)
 </p>
 </details>
 
-<hr/>
-
-## 👨‍💻 Advanced AI Interfaces
-
-<details open>
-<summary><b>Direct Model Access with LLM and VLM</b></summary>
-<p>
-
-Webscout provides direct interfaces to language and vision-language models through the `LLM` and `VLM` classes.
-
-```python
-from webscout.LLM import LLM, VLM
 
-# Text-only model interaction
-llm = LLM("meta-llama/Meta-Llama-3-70B-Instruct")
-response = llm.chat([
-    {"role": "user", "content": "Explain the concept of neural networks"}
-])
-print(response)
-
-# Vision-language model interaction
-vlm = VLM("cogvlm-grounding-generalist")
-response = vlm.chat([
-    {
-        "role": "user",
-        "content": [
-            {"type": "image", "image_url": "path/to/image.jpg"},
-            {"type": "text", "text": "Describe what you see in this image"}
-        ]
-    }
-])
-print(response)
-```
-</p>
-</details>
 
 <details open>
 <summary><b>GGUF Model Conversion</b></summary>