Moonborn — Developers

Python SDK

SDK for Python applications

Installation

pip install moonborn

Setup

import os
from moonborn import Moonborn
 
client = Moonborn(api_key=os.environ["MOONBORN_API_KEY"])

Auto-generated from OpenAPI

The Python SDK is auto-generated from the Moonborn OpenAPI 3.1 spec using openapi-generator.

Source: packages/sdk-py/ in the Moonborn monorepo.

Usage examples

Create a persona

persona = client.personas.create(
 intent="A retired surgeon from Boston who gardens obsessively.",
 options={
 "pipeline": {
 "audit": {"enabled": True},
 "voice_fingerprint": {"enabled": True},
 }
 }
)
 
print(persona.surface.name.display)

Chat with a persona

session = client.chat.sessions.create(persona_id=persona.id)
 
response = client.chat.messages.create(
 session_id=session.id,
 content="What is your greatest fear?"
)
 
print(response.content)
print(f"Drift score: {response.metadata.drift_score}")

Async support

import asyncio
import os
from moonborn import AsyncMoonborn
 
async def main():
 async with AsyncMoonborn(api_key=os.environ["MOONBORN_API_KEY"]) as client:
 persona = await client.personas.create(intent="A digital nomad, 31, UX designer.")
 print(persona.id)
 
asyncio.run(main())