🌌 3.1.1 LuxurAI SDK (Python)
Welcome to the official 3.1.1 LuxurAI SDK for Python — India's premier, enterprise-grade AI client library. Built with persistent HTTP connection pooling (httpx), native asynchronous support (AsyncLuxurAI), strongly-typed models with dual dot/subscript access, real-time SSE token streaming, zero-dependency audio playback, smart account state management, and 322 neural voice models across 140+ languages.
📚 Technical Deep-Dives & Architecture
- 🎙️ Ultra-Fast Voice API v3.0.0 Architecture & Benchmarks
- 🧠 Training Nova-Mini V1: 57M Coding Model from Scratch
- 🔒 Zero-Storage Passwordless Authentication Protocol
- 📖 LuxurAI Engineering Blog & Systems Changelog
🚀 Installation
Install via pip or in editable developer mode:
pip install luxur-ai
# Or local development mode:
cd luxurai-sdk && pip install -e .
⚡ Quickstart: Synchronous & Asynchronous
from luxurai import LuxurAI, AsyncLuxurAI
# 1. Synchronous Client (Context Managed with Connection Pooling)
with LuxurAI(api_key="lxr_v1_...") as client:
# Strongly-typed responses with dot-notation
plan = client.chat.orchestrate("Design a real-time analytics pipeline")
print(plan.response_to_user)
print(f"Cost: {plan.lc_cost} LC | Remaining: {plan.balance_lc} LC")
# Smart Auto-Preloaded Profile
print(f"User Rank: {client.me.rank} | Balance: {client.me.balance} LC")
Async / Await Support:
import asyncio
from luxurai import AsyncLuxurAI
async def main():
async with AsyncLuxurAI(api_key="lxr_v1_...") as client:
# Real-time SSE token streaming
async for chunk in client.stream.chat_async("Explain quantum computing"):
if chunk.get("type") == "token":
print(chunk["text"], end="", flush=True)
asyncio.run(main())
2. Neural Voice Synthesis (luxurai.voice)
Powered by 322 LuxurAI Neural Voices across 142 regional accents with sub-second latency:
# 🎙️ 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:
# 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!
# ⚡ 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:
# 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:
# 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:
# 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:
# 🧠 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:
# 💻 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
Metadata
Release files for luxur-ai 3.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| luxur_ai-3.1.2.tar.gz | 26.8 kB | Without provenance | Details for luxur_ai-3.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| luxur_ai-3.1.2-py3-none-any.whl | Python 3 | none | any | Details for luxur_ai-3.1.2-py3-none-any.whl |
Total release size: 56.6 kB
Release files / luxur_ai-3.1.2.tar.gz
| Download URL | luxur_ai-3.1.2.tar.gz |
|---|---|
| Size | 26.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3f04bab99040b77afe15e28fd2f2d36f885a67a32409c22e3476026518ba690a
|
|
BLAKE2b-256 checksum How to use checksums |
82551e32a0139a17549b34c2f6eeb5644922a3b6629846fb0376bc982ffcb555
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / luxur_ai-3.1.2-py3-none-any.whl
| Download URL | luxur_ai-3.1.2-py3-none-any.whl |
|---|---|
| Size | 29.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6cc2bf3669dda3e00ee4cce1ae99bc45ecb491fe336610d6d378b3a712974c63
|
|
BLAKE2b-256 checksum How to use checksums |
f6aa5055038494b9b1b7d5fbe1e6725bb38bcbb63169b6b230af188b6463951f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for luxur-ai 3.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.