Neuratel AI — Python SDK

Official Python SDK for the Neuratel API — build and manage AI voice agents in a few lines of code.

Installation

pip install neuratelai
# or
uv add neuratelai

Quick Start

from neuratelai import NeuratelAI

client = NeuratelAI()  # reads NEURATEL_API_KEY from env

# Create an agent
agent = client.agents.create(
    name="Support Bot",
    brain={"provider": "groq", "model": "meta-llama/llama-4-scout-17b-16e-instruct", "instructions": "You are a helpful support agent."},
    voice={"provider": "cartesia", "voice_id": "8d8ce8c9-44a4-46c4-b10f-9a927b99a853", "model": "sonic-3"},
    transcriber={"provider": "deepgram", "model": "nova-3"},
)
print(agent["id"])

# Place an outbound call
call = client.voice_sessions.outbound(
    agent_id=agent["id"],
    to_number="+14155551234",
    number_id="your-number-uuid",
)
print(call["status"])

# Iterate all agents (auto-paginates)
for agent in client.agents.list().auto_paging_iter():
    print(agent["id"], agent["name"])

Async

import asyncio
from neuratelai import AsyncNeuratelAI

async def main():
    async with AsyncNeuratelAI() as client:
        agent = await client.agents.create(
            name="Bot",
            brain={"provider": "groq", "model": "meta-llama/llama-4-scout-17b-16e-instruct", "instructions": "..."},
        )
        async for a in await client.agents.list():
            print(a["id"])

asyncio.run(main())

Resources

Error Handling

from neuratelai import AuthenticationError, NotFoundError, RateLimitError, APIError

try:
    agent = client.agents.get("ag_unknown")
except AuthenticationError:
    print("Invalid API key")
except NotFoundError:
    print("Agent not found")
except RateLimitError:
    print("Rate limited")
except APIError as e:
    print(f"HTTP {e.status_code}: {e}")

Links

• Documentation · API Reference · Changelog
• Contributing · Security · Code of Conduct

Requirements

Python 3.10+