Metadata-Version: 2.4
Name: luxur-ai
Version: 3.0.0
Summary: Python SDK for LuxurAI — 322 Neural Voice Models, LLM Streaming, Unified History, Chat & Code
Home-page: https://luxurai.in
Author: NexInova
Author-email: dev@luxurai.in
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.20.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🌌 LuxurAI Python SDK (v3.0.0)

Welcome to the official Python SDK for **LuxurAI** — India's premier, state-of-the-art AI platform. High-performance neural voice synthesis (322 models across 140+ languages), real-time LLM token streaming with client-side punctuation chunking, unified generation history, smart chat, and bleeding-edge code synthesis directly in Python.

---

## 🚀 Quick Installation

Install locally in editable mode or from source:

```bash
cd luxurai-sdk
pip install -e .
```

---

## ✨ Features & Usage

The SDK supports both an elegant **dynamic global configuration** (perfect for quick scripts) and a structured **object-oriented Client instance** (best for concurrent multi-tenant production).

### 1. Global Setup
```python
import luxurai

# Set your API Key globally (lxr_v1_...)
luxurai.LuxurKey = "lxr_v1_your_api_key_here"
luxurai.Model    = "auto"
```

---

### 2. Neural Voice Synthesis (`luxurai.voice`)
Powered by 322 Microsoft Azure Neural Voices with sub-second latency and zero GPU expense:

```python
# 🎙️ Generate high-fidelity neural speech
audio = luxurai.voice.speak(
    text="नमस्ते! लक्ज़र एआई में आपका स्वागत है।",
    gender="female",      # "female" | "male"
    lang="hi",            # "hi", "en", "es", "ja", or "auto"
    speed=1.0,            # 0.5 to 2.0
    save_to="welcome.mp3" # Save directly to file
)

print(f"Model used: {audio.model_used}")
print(f"Permanent Hugging Face URL: {audio.audio_url}")
```

#### Direct Speaker Playback (`.play`)
Play audio through your speakers with zero external audio dependencies:
```python
# Plays directly through the speaker
luxurai.voice.play("Hello world! Welcome to LuxurAI voice engine.", gender="female")
```

---

### 3. Real-Time LLM Token Streaming (`type="chunk"`)
When generating text with an LLM token-by-token, use `type="chunk"` to stream speech without waiting for the full response:
- Buffers words on your local device until punctuation (`.`, `!`, `?`, `,`, `;`, `\n`).
- Sends each sentence chunk to the server immediately.
- Auto-plays the returned audio chunk through the speakers on arrival while continuing the LLM generation loop!

```python
# ⚡ Instant voice playback from an LLM token stream
def get_llm_stream():
    words = ["Hello", " there!", " Welcome", " to", " the", " future", " of", " voice", " AI."]
    for w in words:
        yield w

# Auto-chunks by punctuation and plays each sentence chunk seamlessly:
luxurai.voice.play(
    stream=get_llm_stream(),
    type="chunk",
    gender="female",
    lang="auto"
)
```

---

### 4. Browse the 322 Neural Voice Models
Search and inspect all available neural voice models across 140+ language locales:

```python
# Filter by language or gender
hindi_voices = luxurai.voice.list_voices(lang="hi", gender="female")
for v in hindi_voices:
    print(v["ShortName"], v["Gender"], v["LocaleName"])
```

---

### 5. Unified Generation History (`luxurai.history`)
Inspect past voice generations, chat sessions, and code generations:

```python
# List recent generations
history = luxurai.history.list(type="voice", limit=20)

for item in history.get("history", []):
    print(item["id"], item["created_at"], item["text"], item.get("audio_url"))

# Get specific generation details
item = luxurai.history.get("gen_123456")
```

---

### 6. Privacy & Ghost Mode (`store_voice=False`)
By default, voice generations made with an API key are safely backed up to the Hugging Face 8.3 TB dataset and your user history. To opt out for complete privacy:

```python
# Does NOT save to Hugging Face or history
audio = luxurai.voice.speak(
    text="Confidential audio synthesis",
    gender="male",
    store_voice=False
)
```

---

### 7. Smart Chat & Orchestration
Communicate with **Luxur**, the senior-dev brain of the platform:

```python
# 🧠 Smart chatbot routing & orchestration
reply = luxurai.chat.orchestrate(
    message="Write a clean binary search in Python",
    complexity="low"
)

print(reply["response_to_user"])
```

---

### 8. Code Generation
Direct structural code synthesis:

```python
# 💻 Code synthesis
code = luxurai.code.generate(
    prompt="A FastAPI middleware to validate JWT session tokens",
    language="python"
)
print(code["code"])
```

---

### 9. Rate Limits
All developer API keys are protected by multi-tier rate limiting:
- **Daily Quota:** 300 requests / day (Free tier)
- **Minute Limit:** 13 requests / minute
- **Burst Limit:** 2 requests / second
