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

  🌍 Readme:
  English English · 
  Persian فارسی · 
  Chinese 中文 · 
  Turkish Türkçe · 
  Arabic العربية · 
  Russian Русский · 
  Spanish Español · 
  Japanese 日本語

  AI Made Simple.
  One unified Python client for OpenAI, Claude, Gemini, Groq & more.

> 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).*
