Python SDK

pip install persona-agent-sdk

git clone https://github.com/hasanraiyan/agent-marketplace.git
cd agent-marketplace/sdk/python
python -m venv .venv
.venv/Scripts/pip install .   # .venv/bin/pip on macOS/Linux

pip install -e /path/to/agent-marketplace/sdk/python

import os
from personaai import PersonaClient

# Control-plane client — acts as the Project itself.
persona = PersonaClient(
    os.environ["PERSONA_BASE_URL"],
    credential=os.environ["PERSONA_CREDENTIAL"],
)

# Runtime-plane client — acts as one specific end user of yours (per request).
user_persona = PersonaClient(
    os.environ["PERSONA_BASE_URL"],
    credential=os.environ["PERSONA_CREDENTIAL"],
    external_user_id=current_user.id,
)

from personaai import PersonaClient

persona = PersonaClient(
    "https://api.persona.hasanraiyan.me",
    credential="<keyId>.<secret>",  # minted via Developer Studio
)

# Sanity-check the credential wiring first — side-effect free.
who = persona.whoami()
print(who["principalType"], who["domain"])

# First real operation: provision an Agent.
agent = persona.agents.create(
    {
        "name": "Career Launchpad",
        "systemPrompt": "You help students find internships.",
        "providerId": "...",  # an existing Provider's id, from providers.create()
        "visibility": "unlisted",
    }
)
print(agent["_id"])

import asyncio
from personaai import AsyncPersonaClient

async def main():
    async with AsyncPersonaClient(
        "https://api.persona.hasanraiyan.me", credential="<keyId>.<secret>"
    ) as persona:
        who = await persona.whoami()
        print(who["principalType"], who["domain"])

asyncio.run(main())

from personaai import EventType

# Full event stream — build your own UI from the raw events.
for event in user_persona.chat.stream(
    agent["_id"], [{"role": "user", "content": "What internships are open right now?"}]
):
    if event["type"] == EventType.TEXT_MESSAGE_CHUNK and event.get("delta"):
        print(event["delta"], end="")

# Or the convenience wrapper — drains the stream, returns the final text.
result = user_persona.chat.send_message(
    agent["_id"], [{"role": "user", "content": "What internships are open right now?"}]
)
print(result["text"])