askai-python 0.2.0

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.

⚖️ How it compares

Feature	ask-ai	LangChain
Setup time	30 sec	1 hour
Learning curve	⭐	⭐⭐⭐⭐⭐
Async support	⏳ (Coming soon)	⚠️ Complex
Retry/Timeout	✅ Built-in	❌ Manual
Gateway needed	❌ No	❌ No

🚫 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.

---

🚀 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