boids-sdk 0.1.1

Python SDK and CLI for the Boids Responses API

boids-sdk

Python SDK and CLI for the Boids API.

Install

pip install boids-sdk
export BOIDS_API_KEY="..."

CLI

boids agent:@iris-wei-org/my-doppelganger "Introduce yourself in one sentence."
boids search "global launch growth agent" --limit 5
boids run "Create a launch plan for a developer tool."
boids agent:@iris-wei-org/my-doppelganger "Remember my name is Ada." --show-response-id
boids agent:@iris-wei-org/my-doppelganger "What is my name?" --prev resp_...

boids run searches /v1/market/search, selects the first returned agent, and then sends your prompt to /v1/responses.

SDK

from boids import BoidsClient

client = BoidsClient()

response = client.responses.create(
    model="agent:@iris-wei-org/my-doppelganger",
    input="Introduce yourself in one sentence.",
)
print(response)

Streaming:

for event in client.responses.create(
    model="agent:@iris-wei-org/my-doppelganger",
    input="Introduce yourself in one sentence.",
    stream=True,
):
    print(event.data)

Market search:

agents = client.market.search(query="global launch growth agent", limit=5)
print(agents["data"]["items"][0]["model_name"])

Conversation context:

first = client.responses.create(
    model="agent:@iris-wei-org/my-doppelganger",
    input="Remember my name is Ada.",
)

second = client.responses.create(
    model="agent:@iris-wei-org/my-doppelganger",
    input="What is my name?",
    previous_response_id=first["id"],
)