clawbud 0.1.0

Official Python SDK for the ClawBud Agent API — drive your ClawBud agent from your own app.

clawbud

Official Python SDK for the ClawBud Agent API. Drive your ClawBud agent from your own app with a couple of lines of code.

Requires Python 3.8+.

Install

pip install clawbud

Quickstart

from clawbud import ClawBud

client = ClawBud(api_key="clawbud_live_...")
print(client.send("hi")["reply"])

send() returns a dict with reply, runId, and usage.

Streaming

from clawbud import ClawBud

client = ClawBud(api_key="clawbud_live_...")
for t in client.stream("write me a haiku"):
    print(t, end="")

stream() is a generator that yields incremental text chunks as the agent responds.

Sessions

Pass a session to keep a conversation in the same thread:

client.send("remember my name is Ada", session="sess_123")
client.send("what is my name?", session="sess_123")

Where do I get a key?

Sign in at clawbud.ai, then go to Settings → Agent API to create a key. Keys look like clawbud_live_… and are shown once.

Docs

Full API reference: clawbud.ai/developers

Development

python3 -m venv .venv
.venv/bin/pip install -e . -r requirements-dev.txt
.venv/bin/pytest

License

MIT