sdk for boboyii, African Voice AI Startup
# Boboyii Python SDK
Official Python client library for the Boboyii AI Assistant Platform.
## Installation
Install the SDK using pip:
```bash
pip install boboyii
```
## Quick Start
```python
import os
from boboyii import Boboyii
# Initialize the client
client = Boboyii(api_key=os.environ.get("BOBOYII_API_KEY"))
# Create an assistant
assistant = client.assistants.create(
org_id=1,
name="Customer Support Bot",
template="blank",
description="Helpful customer support assistant"
)
# Publish the assistant
client.assistants.publish(assistant["id"])
# Create a session
session = client.sessions.create(
assistant_id=assistant["id"],
initial_balance=100.0
)
print(f"Session created: {session['id']}")
```
## Features
- **Full API Coverage**: Complete support for all Boboyii API endpoints
- **Async Support**: Built-in async/await support with `AsyncBoboyii`
- **Type Hints**: Full type annotations for better IDE support
- **Error Handling**: Comprehensive exception handling
- **Streaming**: Support for streaming responses
- **Retries**: Automatic retry logic for failed requests
## Authentication
Get your API key from the Boboyii Dashboard:
```python
from boboyii import Boboyii
# Option 1: Pass API key directly
client = Boboyii(api_key="your_api_key_here")
# Option 2: Use environment variable
# Set BOBOYII_API_KEY in your environment
client = Boboyii()
```
## Usage Examples
### Managing Assistants
```python
# List assistants
assistants = client.assistants.list(org_id=1, limit=10)
# Get an assistant
assistant = client.assistants.get(assistant_id=123)
# Update an assistant
client.assistants.update(
assistant_id=123,
name="Updated Name",
description="Updated description"
)
# Delete an assistant
client.assistants.delete(assistant_id=123)
```
### Working with Sessions
```python
# Create a session
session = client.sessions.create(
assistant_id=123,
initial_balance=100.0
)
# Send a message
response = client.sessions.messages.create(
session_id=session["id"],
rol …