webscout 6.2b0__tar.gz → 6.3__tar.gz

webscout-6.3/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/webscout.egg-info → webscout-6.3}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.1
 Name: webscout
-Version: 6.2b0
+Version: 6.3
 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,7 +24,6 @@ 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: curl_cffi
 Requires-Dist: nest-asyncio
@@ -74,9 +72,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>
 
@@ -819,7 +817,7 @@ with WEBS() as WEBS:
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager
+### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager, TalkaiImager
 
 **Every TTI provider has the same usage code, you just need to change the import.**
 
@@ -1357,7 +1355,7 @@ 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
 
 Code is similar to other providers.
 
@@ -1563,9 +1561,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>
 

{webscout-6.2b0 → webscout-6.3}/README.md

@@ -1,8 +1,8 @@
 <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>
 
@@ -745,7 +745,7 @@ with WEBS() as WEBS:
 ___
 </details>
 
-### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager
+### 🖼️ Text to Images - DeepInfraImager, PollinationsAI, BlackboxAIImager, AiForceimager, NexraImager, HFimager, ArtbitImager, NinjaImager, WebSimAI, AIUncensoredImager, TalkaiImager
 
 **Every TTI provider has the same usage code, you just need to change the import.**
 
@@ -1283,7 +1283,7 @@ 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
 
 Code is similar to other providers.
 
@@ -1489,9 +1489,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>
 

{webscout-6.2b0 → webscout-6.3}/setup.py

@@ -30,7 +30,6 @@ setup(
         "Topic :: Software Development :: Libraries :: Python Modules",
     ],
     install_requires=[
-        "docstring_inheritance",
         "click",
         "curl_cffi",
         "nest-asyncio",
@@ -67,6 +66,7 @@ setup(
         "colorlog",
         "yaspin",
         "cerebras-cloud-sdk",
+
     ],
     entry_points={
         "console_scripts": [
@@ -89,9 +89,8 @@ setup(
     },
     license="HelpingAI",
     project_urls={
-        "Documentation": "https://github.com/OE-LUCIFER/Webscout/wiki",
-        "Source": "https://github.com/OE-LUCIFER/Webscout",
-        "Tracker": "https://github.com/OE-LUCIFER/Webscout/issues",
+        "Source": "https://github.com/HelpingAI/Webscout",
+        "Tracker": "https://github.com/HelpingAI/Webscout/issues",
         "YouTube": "https://youtube.com/@OEvortex",
     },
 )

webscout-6.3/webscout/AIbase.py

@@ -0,0 +1,310 @@
+from abc import ABC
+from abc import abstractmethod
+from pathlib import Path
+from typing import AsyncGenerator, List, Union, Generator, Optional
+from typing_extensions import TypeAlias
+
+# Type aliases for better readability
+Response: TypeAlias = dict[str, Union[str, bool, None]]
+ImageData: TypeAlias = Union[bytes, str, Generator[bytes, None, None]]
+AsyncImageData: TypeAlias = Union[bytes, str, AsyncGenerator[bytes, None]]
+
+class AIProviderError(Exception):
+    """Base exception for AI provider errors"""
+    pass
+
+class Provider(ABC):
+    """Base class for text-based AI providers.
+    
+    This class defines the interface for synchronous AI text generation providers.
+    All text-based AI providers should inherit from this class and implement
+    its abstract methods.
+    """
+
+    @abstractmethod
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+    ) -> Response:
+        """Chat with AI and get detailed response.
+
+        Args:
+            prompt: The input text to send to the AI
+            stream: Whether to stream the response. Defaults to False
+            raw: Whether to return raw response as received. Defaults to False
+            optimizer: Optional prompt optimizer - choices: ['code', 'shell_command']
+            conversationally: Whether to maintain conversation context. Defaults to False
+
+        Returns:
+            A dictionary containing response details:
+            {
+                "completion": str,        # The AI's response
+                "stop_reason": str|None,  # Reason for response termination
+                "truncated": bool,        # Whether response was truncated
+                "stop": str|None,        # Stop token if any
+                "model": str,            # Model used for generation
+                "log_id": str,           # Unique log identifier
+                "exception": str|None    # Error message if any
+            }
+
+        Raises:
+            AIProviderError: If there's an error communicating with the AI provider
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+    ) -> str:
+        """Generate a simple text response from the AI.
+
+        Args:
+            prompt: The input text to send to the AI
+            stream: Whether to stream the response. Defaults to False
+            optimizer: Optional prompt optimizer - choices: ['code', 'shell_command']
+            conversationally: Whether to maintain conversation context. Defaults to False
+
+        Returns:
+            The AI's text response
+
+        Raises:
+            AIProviderError: If there's an error communicating with the AI provider
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    def get_message(self, response: Response) -> str:
+        """Extract the message content from a response dictionary.
+
+        Args:
+            response: Response dictionary from ask() method
+
+        Returns:
+            The extracted message text
+
+        Raises:
+            AIProviderError: If message cannot be extracted from response
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+class AsyncProvider(ABC):
+    """Asynchronous base class for text-based AI providers"""
+
+    @abstractmethod
+    async def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+    ) -> Response:
+        """Asynchronously chat with AI and get detailed response.
+
+        Args:
+            prompt: The input text to send to the AI
+            stream: Whether to stream the response. Defaults to False
+            raw: Whether to return raw response as received. Defaults to False
+            optimizer: Optional prompt optimizer - choices: ['code', 'shell_command']
+            conversationally: Whether to maintain conversation context. Defaults to False
+
+        Returns:
+            A dictionary containing response details:
+            {
+                "completion": str,        # The AI's response
+                "stop_reason": str|None,  # Reason for response termination
+                "truncated": bool,        # Whether response was truncated
+                "stop": str|None,        # Stop token if any
+                "model": str,            # Model used for generation
+                "log_id": str,           # Unique log identifier
+                "exception": str|None    # Error message if any
+            }
+
+        Raises:
+            AIProviderError: If there's an error communicating with the AI provider
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    async def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+    ) -> str:
+        """Asynchronously generate a simple text response from the AI.
+
+        Args:
+            prompt: The input text to send to the AI
+            stream: Whether to stream the response. Defaults to False
+            optimizer: Optional prompt optimizer - choices: ['code', 'shell_command']
+            conversationally: Whether to maintain conversation context. Defaults to False
+
+        Returns:
+            The AI's text response
+
+        Raises:
+            AIProviderError: If there's an error communicating with the AI provider
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    async def get_message(self, response: Response) -> str:
+        """Asynchronously extract the message content from a response dictionary.
+
+        Args:
+            response: Response dictionary from ask() method
+
+        Returns:
+            The extracted message text
+
+        Raises:
+            AIProviderError: If message cannot be extracted from response
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+class TTSProvider(ABC):
+    """Base class for text-to-speech providers.
+    
+    This class defines the interface for synchronous text-to-speech providers.
+    """
+
+    @abstractmethod
+    def tts(self, text: str) -> ImageData:
+        """Convert text to speech.
+
+        Args:
+            text: The text to convert to speech
+
+        Returns:
+            One of:
+            - Raw audio bytes
+            - Path to saved audio file
+            - Generator yielding audio chunks
+
+        Raises:
+            AIProviderError: If text-to-speech conversion fails
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+class AsyncTTSProvider(ABC):
+    """Base class for asynchronous text-to-speech providers."""
+
+    @abstractmethod
+    async def tts(self, text: str) -> AsyncImageData:
+        """Asynchronously convert text to speech.
+
+        Args:
+            text: The text to convert to speech
+
+        Returns:
+            One of:
+            - Raw audio bytes
+            - Path to saved audio file
+            - AsyncGenerator yielding audio chunks
+
+        Raises:
+            AIProviderError: If text-to-speech conversion fails
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+class ImageProvider(ABC):
+    """Base class for text-to-image generation providers."""
+
+    @abstractmethod
+    def generate(self, prompt: str, amount: int = 1) -> List[bytes]:
+        """Generate images from a text description.
+
+        Args:
+            prompt: Text description of desired image
+            amount: Number of images to generate (default: 1)
+
+        Returns:
+            List of generated images as bytes
+
+        Raises:
+            AIProviderError: If image generation fails
+            ValueError: If amount is less than 1
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    def save(
+        self, 
+        response: List[bytes], 
+        name: Optional[str] = None, 
+        dir: Optional[Union[str, Path]] = None
+    ) -> List[str]:
+        """Save generated images to disk.
+
+        Args:
+            response: List of image data in bytes
+            name: Base filename for saved images (default: auto-generated)
+            dir: Directory to save images (default: current directory)
+
+        Returns:
+            List of paths to saved image files
+
+        Raises:
+            AIProviderError: If saving images fails
+            ValueError: If response is empty
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+class AsyncImageProvider(ABC):
+    """Base class for asynchronous text-to-image generation providers."""
+
+    @abstractmethod
+    async def generate(
+        self, 
+        prompt: str, 
+        amount: int = 1
+    ) -> Union[AsyncGenerator[bytes, None], List[bytes]]:
+        """Asynchronously generate images from text.
+
+        Args:
+            prompt: Text description of desired image
+            amount: Number of images to generate (default: 1)
+
+        Returns:
+            Either:
+            - AsyncGenerator yielding image bytes for streaming
+            - List of image bytes if not streaming
+
+        Raises:
+            AIProviderError: If image generation fails
+            ValueError: If amount is less than 1
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")
+
+    @abstractmethod
+    async def save(
+        self,
+        response: Union[AsyncGenerator[bytes, None], List[bytes]],
+        name: Optional[str] = None,
+        dir: Optional[Union[str, Path]] = None
+    ) -> List[str]:
+        """Asynchronously save generated images.
+
+        Args:
+            response: Either AsyncGenerator yielding images or List of image bytes
+            name: Base filename for saved images (default: auto-generated)
+            dir: Directory to save images (default: current directory)
+
+        Returns:
+            List of paths to saved image files
+
+        Raises:
+            AIProviderError: If saving images fails
+            ValueError: If response is empty
+        """
+        raise NotImplementedError("Method needs to be implemented in subclass")