Quickstart

pip install backboard-sdk

import asyncio
from backboard import BackboardClient

async def main():
    client = BackboardClient(api_key="YOUR_API_KEY")

    assistant = await client.create_assistant(
        name="My First Assistant",
        system_prompt="You are a helpful assistant that responds concisely."
    )
    print(f"Created assistant: {assistant.assistant_id}")

asyncio.run(main())

thread = await client.create_thread(assistant.assistant_id)
print(f"Created thread: {thread.thread_id}")

response = await client.add_message(
    thread_id=thread.thread_id,
    content="What is the capital of France?",
    stream=False
)
print(f"Assistant: {response.content}")

full_content = ""
async for chunk in await client.add_message(
    thread_id=thread.thread_id,
    content="What is the capital of France?",
    stream=True
):
    if chunk.get("type") == "content_streaming":
        content_piece = chunk.get("content", "")
        full_content += content_piece
        print(content_piece, end="", flush=True)
    elif chunk.get("type") == "run_ended":
        break

print(f"\nFull response: {full_content}")

response = await client.add_message(
    thread_id=thread.thread_id,
    content="What is its population?",
    stream=False
)
print(f"Assistant: {response.content}")  # Will know you're asking about Paris

full_content = ""
async for chunk in await client.add_message(
    thread_id=thread.thread_id,
    content="What is its population?",
    stream=True
):
    if chunk.get("type") == "content_streaming":
        content_piece = chunk.get("content", "")
        full_content += content_piece
        print(content_piece, end="", flush=True)
    elif chunk.get("type") == "run_ended":
        break

print(f"\nAssistant: {full_content}")  # Will know you're asking about Paris