Skip to main content

🌌 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


🚀 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)

Source distribution for luxur-ai 3.1.2
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)

Table of built distributions (wheels) for luxur-ai 3.1.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page