askai-python 0.1.2__tar.gz

askai_python-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hossein Ghorbani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

askai_python-0.1.2/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: askai-python
+Version: 0.1.2
+Summary: AI Made Stupid Simple. Unified API for OpenAI, Groq, Google, and more.
+Author-email: Hossein Ghorbani <hosseingh1068@gmail.com>
+License: MIT
+Project-URL: Homepage, https://hosseinghorbani0.ir/
+Project-URL: Bug Tracker, https://github.com/Hosseinghorbani0/ask-ai/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: groq
+Requires-Dist: google-generativeai
+Requires-Dist: anthropic
+Requires-Dist: requests
+Dynamic: license-file
+
+# ask-ai
+
+<p align="center">
+  🌍 <b>Readme:</b>
+  <a href="README.md"><img src="https://flagcdn.com/20x15/us.png" alt="English"> English</a> · 
+  <a href="docs/README_fa.md"><img src="https://flagcdn.com/20x15/ir.png" alt="Persian"> فارسی</a> · 
+  <a href="docs/README_zh.md"><img src="https://flagcdn.com/20x15/cn.png" alt="Chinese"> 中文</a> · 
+  <a href="docs/README_tr.md"><img src="https://flagcdn.com/20x15/tr.png" alt="Turkish"> Türkçe</a> · 
+  <a href="docs/README_ar.md"><img src="https://flagcdn.com/20x15/sa.png" alt="Arabic"> العربية</a> · 
+  <a href="docs/README_ru.md"><img src="https://flagcdn.com/20x15/ru.png" alt="Russian"> Русский</a> · 
+  <a href="docs/README_es.md"><img src="https://flagcdn.com/20x15/es.png" alt="Spanish"> Español</a> · 
+  <a href="docs/README_ja.md"><img src="https://flagcdn.com/20x15/jp.png" alt="Japanese"> 日本語</a>
+</p>
+
+<p align="center">
+  <b>AI Made Simple.</b><br/>
+  One unified Python client for OpenAI, Claude, Gemini, Groq & more.
+</p>
+
+> Stop rewriting AI code for every provider. Use one line. Switch models anytime.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+---
+
+## ⚡ Why ask-ai?
+
+- **No SDK lock-in**: Don't learn 5 different libraries. Learn one.
+- **Unified API**: `ai.ask()` works for text, images, and audio across all providers.
+- **Production Ready**: Built-in type safety, error handling, and environment management.
+- **Zero-Config**: Auto-detects API keys from your environment.
+
+---
+
+## 🚀 The Golden Example
+
+See the power of `ask-ai` in 3 lines of code:
+
+```python
+from ask_ai import OpenAI, Anthropic, Google
+
+prompt = "Explain quantum computing in one sentence."
+
+# Switch providers instantly
+print("OpenAI:   ", OpenAI().ask(prompt))
+print("Claude:   ", Anthropic().ask(prompt))
+print("Gemini:   ", Google().ask(prompt))
+```
+
+---
+
+## 📦 Installation
+
+```bash
+pip install askai-python
+```
+
+---
+
+## 📖 Quick Start
+
+### 1. Setup
+Export your API keys (or pass them explicitly).
+```bash
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+### 2. Standard Usage
+```python
+from ask_ai import OpenAI
+
+ai = OpenAI()
+print(ai.ask("Hello, World!"))
+```
+
+### 3. Advanced Usage
+Control `temperature`, `top_p`, and system personas for professional results.
+```python
+ai.advanced(
+    temperature=0.7,
+    prompt="You are a senior DevOps engineer."
+)
+
+print(ai.ask("How do I optimize a Dockerfile?"))
+```
+
+---
+
+## 🔌 Supported Providers
+
+| Provider | Class | Feature Set |
+|----------|-------|-------------|
+| **OpenAI** | `OpenAI` | All Models (GPT-4o, o1, etc.) |
+| **Anthropic** | `Anthropic` | All Models (Claude 3.5, Opus) |
+| **Google** | `Google` | All Models (Gemini 1.5 Pro/Flash) |
+| **Groq** | `Groq` | All Models (Llama 3, Mixtral) |
+| **Azure** | `Azure` | All Deployments |
+| **OpenRouter**| `OpenRouter`| All Models (100+) |
+
+---
+
+## ⭐ Support the Project
+
+If this project saved you time, please consider giving it a star on GitHub! It helps us grow.
+
+**[Give it a Star!](https://github.com/Hosseinghorbani0/ask-ai)**
+
+---
+*Built by [Hossein Ghorbani](https://hosseinghorbani0.ir/) | [GitHub](https://github.com/Hosseinghorbani0).*

askai_python-0.1.2/README.md

@@ -0,0 +1,111 @@
+# ask-ai
+
+<p align="center">
+  🌍 <b>Readme:</b>
+  <a href="README.md"><img src="https://flagcdn.com/20x15/us.png" alt="English"> English</a> · 
+  <a href="docs/README_fa.md"><img src="https://flagcdn.com/20x15/ir.png" alt="Persian"> فارسی</a> · 
+  <a href="docs/README_zh.md"><img src="https://flagcdn.com/20x15/cn.png" alt="Chinese"> 中文</a> · 
+  <a href="docs/README_tr.md"><img src="https://flagcdn.com/20x15/tr.png" alt="Turkish"> Türkçe</a> · 
+  <a href="docs/README_ar.md"><img src="https://flagcdn.com/20x15/sa.png" alt="Arabic"> العربية</a> · 
+  <a href="docs/README_ru.md"><img src="https://flagcdn.com/20x15/ru.png" alt="Russian"> Русский</a> · 
+  <a href="docs/README_es.md"><img src="https://flagcdn.com/20x15/es.png" alt="Spanish"> Español</a> · 
+  <a href="docs/README_ja.md"><img src="https://flagcdn.com/20x15/jp.png" alt="Japanese"> 日本語</a>
+</p>
+
+<p align="center">
+  <b>AI Made Simple.</b><br/>
+  One unified Python client for OpenAI, Claude, Gemini, Groq & more.
+</p>
+
+> Stop rewriting AI code for every provider. Use one line. Switch models anytime.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+---
+
+## ⚡ Why ask-ai?
+
+- **No SDK lock-in**: Don't learn 5 different libraries. Learn one.
+- **Unified API**: `ai.ask()` works for text, images, and audio across all providers.
+- **Production Ready**: Built-in type safety, error handling, and environment management.
+- **Zero-Config**: Auto-detects API keys from your environment.
+
+---
+
+## 🚀 The Golden Example
+
+See the power of `ask-ai` in 3 lines of code:
+
+```python
+from ask_ai import OpenAI, Anthropic, Google
+
+prompt = "Explain quantum computing in one sentence."
+
+# Switch providers instantly
+print("OpenAI:   ", OpenAI().ask(prompt))
+print("Claude:   ", Anthropic().ask(prompt))
+print("Gemini:   ", Google().ask(prompt))
+```
+
+---
+
+## 📦 Installation
+
+```bash
+pip install askai-python
+```
+
+---
+
+## 📖 Quick Start
+
+### 1. Setup
+Export your API keys (or pass them explicitly).
+```bash
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+### 2. Standard Usage
+```python
+from ask_ai import OpenAI
+
+ai = OpenAI()
+print(ai.ask("Hello, World!"))
+```
+
+### 3. Advanced Usage
+Control `temperature`, `top_p`, and system personas for professional results.
+```python
+ai.advanced(
+    temperature=0.7,
+    prompt="You are a senior DevOps engineer."
+)
+
+print(ai.ask("How do I optimize a Dockerfile?"))
+```
+
+---
+
+## 🔌 Supported Providers
+
+| Provider | Class | Feature Set |
+|----------|-------|-------------|
+| **OpenAI** | `OpenAI` | All Models (GPT-4o, o1, etc.) |
+| **Anthropic** | `Anthropic` | All Models (Claude 3.5, Opus) |
+| **Google** | `Google` | All Models (Gemini 1.5 Pro/Flash) |
+| **Groq** | `Groq` | All Models (Llama 3, Mixtral) |
+| **Azure** | `Azure` | All Deployments |
+| **OpenRouter**| `OpenRouter`| All Models (100+) |
+
+---
+
+## ⭐ Support the Project
+
+If this project saved you time, please consider giving it a star on GitHub! It helps us grow.
+
+**[Give it a Star!](https://github.com/Hosseinghorbani0/ask-ai)**
+
+---
+*Built by [Hossein Ghorbani](https://hosseinghorbani0.ir/) | [GitHub](https://github.com/Hosseinghorbani0).*

askai_python-0.1.2/ask_ai/__init__.py

@@ -0,0 +1,7 @@
+from .providers import OpenAI, Groq, Google, OpenRouter, Azure, Anthropic
+
+
+from .config import AdvancedConfig
+from .base import Response
+from .media import ImageObject, AudioObject
+from .exceptions import AskAIError, APIKeyError, ProviderError

askai_python-0.1.2/ask_ai/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

askai_python-0.1.2/ask_ai/base.py

@@ -0,0 +1,141 @@
+from typing import Optional, Union, List, Dict, Any
+import os
+from .config import AdvancedConfig
+from .media import ImageObject, AudioObject
+from .exceptions import APIKeyError
+
+class Response:
+    """
+    Unified response object for all easyai requests.
+    """
+    def __init__(self, text: str = "", media: Union[ImageObject, AudioObject, None] = None):
+        self.text = text
+        self.media = media
+
+    def __str__(self):
+        return self.text
+
+    def save(self, path: str):
+        """Smart save based on content type."""
+        if self.media:
+            self.media.save(path)
+        else:
+            with open(path, "w", encoding="utf-8") as f:
+                f.write(self.text)
+            print(f"Text saved to {path}")
+
+class BaseProvider:
+    """
+    Abstract base class for all AI providers.
+    Implements the core 'ask' logic and configuration management.
+    """
+    def __init__(self, api_key: str = None, model: str = None, persona: str = None, **kwargs):
+        # 1. Zero-Config: Try env var if key not provided
+        self.api_key = api_key or os.environ.get(self._get_api_key_env_var())
+        if not self.api_key:
+             # Some providers might not need it (e.g. local), but generally they do.
+             # We allow subclass to handle granular validation, but warn here.
+             pass
+
+        self.model = model or self._get_default_model()
+        self.persona = persona
+        
+        # Global Advanced Config
+        self.config = AdvancedConfig(**kwargs)
+
+    def _get_api_key_env_var(self) -> str:
+        """Subclasses should return the env var name, e.g. 'OPENAI_API_KEY'"""
+        raise NotImplementedError
+
+    def _get_default_model(self) -> str:
+        """Subclasses should return a default model"""
+        raise NotImplementedError
+
+    def advanced(self, **kwargs):
+        """
+        Update global advanced settings for this instance.
+        Merges new settings with existing ones.
+        """
+        new_conf = AdvancedConfig(**kwargs)
+        # primitive merge: update self.config with new values
+        for k, v in new_conf.__dict__.items():
+            if v is not None:
+                setattr(self.config, k, v)
+        
+        # Handle extra kwargs
+        if new_conf.extra:
+            self.config.extra.update(new_conf.extra)
+
+    def ask(self, query: str, **kwargs) -> Response:
+        """
+        The main entry point. 
+        Detects intent, manages config, and returns a unified Response.
+        """
+        # 1. Merge Request Config with Global Config
+        request_config = AdvancedConfig(**kwargs)
+        final_config = self._merge_configs(self.config, request_config)
+
+        # 2. Add System/Persona Message
+        messages = self._prepare_messages(query, final_config)
+
+        # 3. Check for specific output_type override (e.g. user forced image)
+        output_type = kwargs.get('output_type')
+        
+        # 4. Call Provider Implementation
+        return self._send_request(messages, final_config, output_type)
+
+    def _merge_configs(self, global_conf: AdvancedConfig, req_conf: AdvancedConfig) -> AdvancedConfig:
+        return global_conf.merge(req_conf) # We need to implement merge logic in AdvancedConfig properly or here
+
+    def _prepare_messages(self, query: str, config: AdvancedConfig) -> List[Dict[str, str]]:
+        messages = []
+        if config.system_message:
+            messages.append({"role": "system", "content": config.system_message})
+        elif self.persona:
+            messages.append({"role": "system", "content": self.persona})
+        
+        messages.append({"role": "user", "content": query})
+        return messages
+
+    def _send_request(self, messages: List[Dict[str, str]], config: AdvancedConfig, output_type: str = None) -> Response:
+        """Subclasses must implement this."""
+        raise NotImplementedError
+
+    # --- Tool Definitions for Smart Intent ---
+    def _get_media_tools(self) -> List[Dict[str, Any]]:
+        return [
+            {
+                "type": "function",
+                "function": {
+                    "name": "generate_image",
+                    "description": "Generate an image based on a prompt. Use this when the user asks to draw, create, or show an image.",
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "prompt": {
+                                "type": "string",
+                                "description": "The detailed description of the image to generate."
+                            }
+                        },
+                        "required": ["prompt"]
+                    }
+                }
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "generate_speech",
+                    "description": "Generate audio speech from text. Use this when the user asks to say something, speak, or read aloud.",
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "text": {
+                                "type": "string",
+                                "description": "The text to speak."
+                            }
+                        },
+                        "required": ["text"]
+                    }
+                }
+            }
+        ]

askai_python-0.1.2/ask_ai/cli.py

@@ -0,0 +1,77 @@
+import sys
+import argparse
+from .providers import OpenAI
+from .exceptions import EasyAIError
+
+def main():
+    parser = argparse.ArgumentParser(description="easyai CLI: Ask AI anything directly from your terminal.")
+    parser.add_argument("query", help="The text query to ask the AI.")
+    parser.add_argument("--provider", default="openai", choices=["openai", "groq", "google", "openrouter", "azure", "anthropic"], help="The AI provider to use.")
+    parser.add_argument("--model", help="Specific model to use (optional).")
+    parser.add_argument("--temp", type=float, help="Temperature setting (optional).")
+    
+    args = parser.parse_args()
+
+    # Map provider name to class
+    providers = {
+        "openai": OpenAI,
+        # Lazy load others to avoid unnecessary imports if cli is used often? 
+        # But we already imported OpenAI. 
+        # Let's import dynamically or just map if already imported in __init__.
+    }
+    
+    # We need to import others dynamically or statically. 
+    # Since __init__ exposes them, let's use that.
+    import easyai
+    
+    provider_class = getattr(easyai, args.provider.capitalize(), None)
+    if args.provider == "openrouter": # naming case mismatch
+        provider_class = easyai.OpenRouter
+    elif args.provider == "openai":
+         provider_class = easyai.OpenAI
+    elif args.provider == "groq":
+         provider_class = easyai.Groq
+    elif args.provider == "google":
+         provider_class = easyai.Google
+    elif args.provider == "azure":
+         provider_class = easyai.Azure
+    elif args.provider == "anthropic":
+         provider_class = easyai.Anthropic
+
+    if not provider_class:
+        print(f"Error: Provider '{args.provider}' not found.")
+        sys.exit(1)
+
+    try:
+        # Init provider
+        kwargs = {}
+        if args.model:
+            kwargs["model"] = args.model
+        
+        ai = provider_class(**kwargs)
+        
+        # Ask
+        ask_kwargs = {}
+        if args.temp is not None:
+            ask_kwargs["temperature"] = args.temp
+
+        print(f"[{args.provider.upper()}] Thinking...")
+        response = ai.ask(args.query, **ask_kwargs)
+        
+        if response.media:
+            print(f"Generated Media: {response.media.type}")
+            response.media.show()
+            # auto save to current directory?
+            filename = f"output.{'png' if response.media.type == 'image' else 'mp3'}"
+            response.media.save(filename)
+            print(f"Saved to {filename}")
+        else:
+            print(response.text)
+
+    except EasyAIError as e:
+        print(f"EasyAI Error: {e}")
+    except Exception as e:
+        print(f"Unexpected Error: {e}")
+
+if __name__ == "__main__":
+    main()

askai_python-0.1.2/ask_ai/config.py

@@ -0,0 +1,56 @@
+from typing import Optional, Dict, Any
+
+class AdvancedConfig:
+    """
+    Configuration class for advanced AI settings.
+    """
+    def __init__(
+        self,
+        temperature: Optional[float] = None,
+        max_tokens: Optional[int] = None,
+        top_p: Optional[float] = None,
+        frequency_penalty: Optional[float] = None,
+        presence_penalty: Optional[float] = None,
+        stop: Optional[list] = None,
+        system_message: Optional[str] = None,
+        safe_mode: bool = False,
+        **kwargs
+    ):
+        self.temperature = temperature
+        self.max_tokens = max_tokens
+        self.top_p = top_p
+        self.frequency_penalty = frequency_penalty
+        self.presence_penalty = presence_penalty
+        self.stop = stop
+        self.stop = stop
+        
+        # Smart Aliases for 10/10 Usability
+        # If user passes 'prompt' or 'system', treat it as 'system_message'
+        if system_message is None:
+            system_message = kwargs.get("prompt") or kwargs.get("system")
+        
+        self.system_message = system_message
+        self.safe_mode = safe_mode
+        self.extra = kwargs
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert config to a dictionary, filtering None values."""
+        return {k: v for k, v in self.__dict__.items() if v is not None and k != 'extra'}
+
+    def merge(self, other_config: 'AdvancedConfig') -> 'AdvancedConfig':
+        """Merge another config into this one (other overrides self)."""
+        new_config = AdvancedConfig()
+        # Copy self
+        for k, v in self.__dict__.items():
+            setattr(new_config, k, v)
+        
+        # Override with other
+        for k, v in other_config.__dict__.items():
+            if v is not None:
+                setattr(new_config, k, v)
+        
+        return new_config
+    
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> 'AdvancedConfig':
+        return cls(**data)

askai_python-0.1.2/ask_ai/exceptions.py

@@ -0,0 +1,15 @@
+class AskAIError(Exception):
+    """Base exception for all ask-ai errors."""
+    pass
+
+class APIKeyError(AskAIError):
+    """Raised when API key is missing or invalid."""
+    pass
+
+class ProviderError(AskAIError):
+    """Raised when the provider API fails (e.g. 500 error)."""
+    pass
+
+class MediaTypeNotSupportedError(AskAIError):
+    """Raised when a provider can't handle the requested media type."""
+    pass

askai_python-0.1.2/ask_ai/media.py

@@ -0,0 +1,63 @@
+import os
+import base64
+from PIL import Image
+from io import BytesIO
+import platform
+import subprocess
+
+class MediaObject:
+    def __init__(self, data: bytes, media_type: str):
+        self.data = data
+        self.type = media_type
+
+    @property
+    def bytes(self) -> bytes:
+        return self.data
+
+class ImageObject(MediaObject):
+    def __init__(self, data: bytes):
+        super().__init__(data, "image")
+
+    def save(self, path: str):
+        """Save the image to a file."""
+        with open(path, "wb") as f:
+            f.write(self.data)
+        print(f"Image saved to {path}")
+
+    def show(self):
+        """Display the image using the default OS viewer."""
+        try:
+            image = Image.open(BytesIO(self.data))
+            image.show()
+        except Exception as e:
+            print(f"Error showing image: {e}")
+
+class AudioObject(MediaObject):
+    def __init__(self, data: bytes):
+        super().__init__(data, "audio")
+
+    def save(self, path: str):
+        """Save the audio to a file."""
+        with open(path, "wb") as f:
+            f.write(self.data)
+        print(f"Audio saved to {path}")
+
+    def play(self):
+        """Play the audio using the default OS player."""
+        # Simple cross-platform play attempt
+        import tempfile
+        
+        # Save to temp file
+        with tempfile.NamedTemporaryFile(delete=False, suffix=".mp3") as f:
+            f.write(self.data)
+            temp_path = f.name
+            
+        try:
+            if platform.system() == "Windows":
+                 os.startfile(temp_path)
+            elif platform.system() == "Darwin":
+                subprocess.call(["open", temp_path])
+            else:
+                subprocess.call(["xdg-open", temp_path])
+        except Exception as e:
+            print(f"Error playing audio: {e}")

askai_python-0.1.2/ask_ai/providers/__init__.py

@@ -0,0 +1,11 @@
+from .openai_provider import OpenAIProvider as OpenAI
+from .groq_provider import GroqProvider as Groq
+from .google_provider import GoogleProvider as Google
+from .openrouter_provider import OpenRouterProvider as OpenRouter
+from .azure_provider import AzureProvider as Azure
+from .anthropic_provider import AnthropicProvider as Anthropic
+
+
+
+
+