Quickstart

pip install superdialog

pip install superdialog[livekit]    # LiveKit adapter
pip install superdialog[pipecat]    # PipeCat adapter
pip install superdialog[fastapi]    # FastAPI adapter + uvicorn
pip install superdialog[ws]         # WebSocket runner
pip install superdialog[mcp]        # MCP tool support
pip install superdialog[langchain]  # LangChainAgent

import asyncio
from superdialog import create_dialog_flow

async def main():
    flow = await create_dialog_flow(
        prompt="Confirm customer appointment. Ask if Friday 4pm works; offer 5pm as an alternative if not.",
        llm="openai/gpt-5.1",
    )
    flow.save("appointment.json")   # version-control it

asyncio.run(main())

from superdialog import DialogMachine, Flow

flow = Flow.load("appointment.json")

dialog_machine = DialogMachine(
    flow=flow,
    llm="anthropic/claude-haiku-4-5",   # runtime model - can differ from the build model
)

import asyncio

async def chat():
    reply = await dialog_machine.turn("Hello, I'm calling about my appointment.")
    print(reply.text)

    reply = await dialog_machine.turn("Friday 4pm works for me.")
    print(reply.text)

asyncio.run(chat())

superdialog chat appointment.json

from superdialog import DialogMachine, Flow, PythonTool

def lookup_customer(phone_number: str) -> dict:
    """Look up customer record by phone number."""
    return crm.get_by_phone(phone_number)

dialog_machine = DialogMachine(
    flow=Flow.load("appointment.json"),
    llm="anthropic/claude-haiku-4-5",
    tools=[PythonTool.of(lookup_customer)],  # schema inferred from signature + docstring
)

from superdialog.tools import tool

@tool
def lookup_customer(phone_number: str) -> dict:
    """Look up customer record by phone number."""
    return crm.get_by_phone(phone_number)

dialog_machine = DialogMachine(
    flow=Flow.load("appointment.json"),
    llm="anthropic/claude-haiku-4-5",
    tools=[lookup_customer],  # decorated function is already a PythonTool
)