Metadata-Version: 2.4
Name: clawbud
Version: 0.1.0
Summary: Official Python SDK for the ClawBud Agent API — drive your ClawBud agent from your own app.
Author: ClawBud
License: MIT
Project-URL: Homepage, https://clawbud.ai/developers
Project-URL: Repository, https://github.com/Tweezamiza/clawbuddy-web
Keywords: clawbud,agent,ai,sdk,openclaw,llm
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25

# clawbud

Official Python SDK for the [ClawBud](https://clawbud.ai) Agent API. Drive your ClawBud agent from your own app with a couple of lines of code.

> Requires **Python 3.8+**.

## Install

```bash
pip install clawbud
```

## Quickstart

```python
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

```python
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:

```python
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](https://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](https://clawbud.ai/developers)

## Development

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

## License

MIT
