Getting Started

pip install git+https://github.com/xysq-ai/sdk_python_xysq.git

pip install 'xysq[agent] @ git+https://github.com/xysq-ai/sdk_python_xysq.git'
pip install 'xysq[claude] @ git+https://github.com/xysq-ai/sdk_python_xysq.git'
pip install 'xysq[all] @ git+https://github.com/xysq-ai/sdk_python_xysq.git'

XYSQ_API_KEY=xysq_...

from xysq import Xysq

client = Xysq(api_key="xysq_...")

from dotenv import load_dotenv
from xysq import Xysq

load_dotenv()

with Xysq() as client:
    # a vault: a context scope your code addresses by id
    vault = client.vaults.create("Support Bot")

    # push what happened, verbatim (turn by turn -- don't summarize)
    client.vaults.push(
        vault.vault_id,
        "user: what's our refund policy\nagent: 30 days, no questions asked.",
        metadata={"session_id": "conv-1"},
    )

    # pull it back later, ranked
    for hit in client.vaults.pull(vault.vault_id, "refund policy"):
        print(hit.score, hit.content)