partython-brain

Python SDK for the Partython AI brain — embed conversational, sales-aware AI in your app or backend.

pip install partython-brain

Quick start

from partython_brain import Brain
import os

brain = Brain(api_key=os.environ["PARTYTHON_API_KEY"])

result = brain.respond(
    channel="web",
    channel_user_id="user-abc",
    message_text="I'm planning a 5-year-old's birthday with 12 guests — any unicorn theme ideas?",
)
print(result["response"])
# → "A unicorn theme for a 5-year-old with 12 guests — fun! Let me show you our..."

API

Brain(api_key, base_url=None, timeout=30, session=None)

brain.respond(...)

Keyword args (all required unless noted):

• channel: str — "web" | "whatsapp" | "sms" | "api" ...
• channel_user_id: str — stable id for the conversation participant
• message_text: str — the customer's message
• metadata: dict | None — optional pass-through metadata
• dedup_key: str | None — idempotency key (webhook event id)
• has_image: bool — hint for the smart router

Returns dict with response, assistant_name, request_id, metadata.

Errors

from partython_brain import BrainAuthError, BrainRateLimitError

try:
    brain.respond(...)
except BrainRateLimitError as e:
    # back off — retry-after info is in e.body
    ...
except BrainAuthError as e:
    # key invalid or revoked
    ...

License

MIT