askai-python 0.3.3

AI Made Stupid Simple. Unified API for OpenAI, Groq, Google, and more.

askai-python 🚀

A minimal Python SDK to switch between LLM providers in one line.
No frameworks. No servers. No overengineering.

---

⚡ Quick Start (5 seconds)

pip install askai-python

from ask_ai import OpenAI, Groq

# Auto-detects OPENAI_API_KEY from environment
print(OpenAI().ask("Explain black holes like I'm 5").text)

# Switch provider instantly
print(Groq().ask("Explain black holes like I'm 5").text)

---

🧐 Why ask-ai?

• One function: Just call .ask()
• Multiple providers: OpenAI, Anthropic, Google Gemini, Groq, Azure, OpenRouter
• Zero config: Keys are pulled from the environment automatically
• SDK-first, not a framework: It stays out of your way.

🚫 What this project is NOT

❌ Not an AI framework
❌ Not an API gateway
❌ Not an agent memory system

It does one thing perfectly: Simplifying the API call to LLMs.

---

🛠️ Advanced Usage

🧰 Developer QoL Utilities (Auto-Parsing)

Stop writing Regex to clean up model outputs! `ask-ai` comes with built-in text processing flags:

from ask_ai import OpenAI
ai = OpenAI()

# 1. Clean Markdown (Removes ```json and ``` tags)
# Perfect for extracting raw data from models that wrap everything in markdown
clean_text = ai.ask("Write JSON", clean=True).text

# 2. Extract Code (Returns ONLY the code block, ignores conversational filler)
# Great for automation pipelines
code = ai.ask("Write a python ping script", code=True).text

# 3. Strip Tags (Removes <think> blocks and HTML)
# Essential for reasoning models like DeepSeek-R1
answer_only = ai.ask("What is 1+1?", strip=True).text

# 4. Enforce & Parse JSON (Directly returns a Parsed Python Dictionary)
# Adds JSON instructions to the prompt and safely runs json.loads()
data_dict = ai.ask("Extract user info", json=True).json
print(data_dict['name'])

🚀 Built-in Resiliency (Retries & Timeouts)

Build reliable apps without writing your own loops. askai-python handles rate limits (429) and network drops via an internal exponential backoff.

from ask_ai import OpenAI

ai = OpenAI()

# Automatically retries up to 3 times on transient errors, with a 15-second timeout
response = ai.ask(
    "Write a complex python script", 
    retry=3, 
    timeout=15 
)

🔌 Supported Providers

Provider	Class	Capabilities
OpenAI	OpenAI	Text, Images (DALL-E), Vision
Anthropic	Anthropic	Text, Vision (Claude 3.5)
Google	Google	Text, Images, Video, Audio
Groq	Groq	Ultra-fast Llama 3 & Mixtral
Azure	Azure	Enterprise-grade OpenAI
OpenRouter	OpenRouter	100+ community models

---

🗺️ Roadmap

• Baseline multiple providers
• Automated Retry & Timeout controls
• Async API (await ask_async)
• Provider Fallback (fallback=[Groq()])
• Structured Outputs (Pydantic Support)

---

🔗 Important Links

• GitHub Repository: Hosseinghorbani0/ask-ai (Star us! ⭐)
• Official Website: hosseinghorbani0.ir
• Bug Tracker: Report an Issue