hyperneuronai 0.1.20

Official Python SDK for HyperNeuron AI services

hyperneuronai

Official Python SDK for HyperNeuron AI — TTS streaming and AI telephony services.

Install

pip install hyperneuronai

Quick start

"""Make an outbound AI voice call (sync)."""
import time
import hyperneuronai

client = hyperneuronai.HyperNeuron(
    api_key="<api-key-get-from-your-account>",
    base_url="https://ai.hyperneuron.in/",
)

### Uncomment for oneway outbound calls
# call = client.telephony.outbound(
#     to_number="+91<10digitphone>",
#     text="Hello! This is an automated call from HyperNeuron. How are you today?",
#     voice="deepraj",
#     language="en",
# )
call = client.telephony.agent_call(
    to_number="+91<10digitphone>",
    greetings="Hello! This is an automated call from HyperNeuron. How are you today?",
    voice="deepraj",
    language="en",
)
print(f"Call initiated: {call.call_uuid}")
print(f"State: {call.state}")

# Poll until call ends
while True:
    time.sleep(5)
    status = client.telephony.status(call.call_uuid)
    print(f"  → {status.state}")
    if status.is_terminal:
        print(f"\nCall ended: {status.state}")
        if status.duration_sec:
            print(f"Duration: {status.duration_sec}s ({status.duration_min:.1f} min)")
        break


client.close()

import hyperneuronai

client = hyperneuronai.HyperNeuron(
    api_key="hn_key_xxxx",
    base_url="https://ai.hyperneuron.in",
)

# TTS — save to WAV
audio = client.tts.generate("Hello, world!", voice="sanjana")
with open("hello.wav", "wb") as f:
    f.write(audio)

# TTS — stream in real time
for chunk in client.tts.stream("Hello, world!", voice="sanjana"):
    your_speaker.write(chunk)

# One-way outbound call
call = client.telephony.outbound(
    to="+91<10digitIndianNumber>",
    text="Hi! Your order has shipped and arrives tomorrow.",
    voice="sanjana",
)
print(call.call_uuid, call.state)

Async

import asyncio
import hyperneuronai

async def main():
    async with hyperneuronai.AsyncHyperNeuron(api_key="hn_key_xxxx") as client:
        audio = await client.tts.generate("Hello!")
        call  = await client.telephony.outbound(to="+91<10digitIndianNumber>", text="Hi there!")

asyncio.run(main())

License

MIT