rightnow-ai 0.1.0

Python SDK for the Arabic API by RightNow — chat, embeddings, STT, TTS for Arabic

RightNow — Arabic AI SDK

Python SDK for the Arabic API by RightNow. Chat, embeddings, speech-to-text, and text-to-speech — all optimized for Arabic.

Install

pip install rightnow-ai

Quick Start

from rightnow import RightNow

client = RightNow(api_key="rn-...")

response = client.chat.completions.create(
    model="falcon-h1-arabic-7b",
    messages=[{"role": "user", "content": "ما هي عاصمة الأردن؟"}],
)
print(response.choices[0].message.content)

Streaming

stream = client.chat.completions.create(
    model="falcon-h1-arabic-7b",
    messages=[{"role": "user", "content": "مرحبا"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
stream.close()

Embeddings

response = client.embeddings.create(
    model="bge-m3-arabic",
    input="مرحبا بالعالم",
)
print(response.data[0].embedding[:5])

Async

from rightnow import AsyncRightNow

async with AsyncRightNow(api_key="rn-...") as client:
    response = await client.chat.completions.create(
        model="falcon-h1-arabic-7b",
        messages=[{"role": "user", "content": "مرحبا"}],
    )

Available Models

Model	Type	Size
falcon-h1-arabic-3b	Chat	3B
falcon-h1-arabic-7b	Chat	7B
falcon-h1-arabic-34b	Chat	34B
bge-m3-arabic	Embeddings	568M
whisper-v3-arabic	Speech-to-Text	809M
chatterbox-arabic	Text-to-Speech	~1B