Introduction - Pawa AI Docs

The Pawa AI Python SDK (pawa-ai) is the official client for the Pawa AI API. It wraps chat, models, voice, embeddings, document parsing, agents, knowledge bases, and transcription behind a typed Python interface — with sync and async clients, streaming helpers, and automatic retries. Use it when you want to call the same surface documented in the API reference without hand-writing HTTP requests.

Requirements

Python 3.9+
A Pawa AI API key from the Builders Dashboard

Installation

pip install pawa-ai

Authentication

Set your API key as an environment variable (recommended):

export PAWA_AI_API_KEY="your_api_key_here"

Then create a client:

from pawa_ai import PawaAI

client = PawaAI()

Or pass the key explicitly:

from pawa_ai import PawaAI

client = PawaAI(api_key="your_api_key_here")

Quick example

from pawa_ai import PawaAI

client = PawaAI()

response = client.chat.create(
    model="pawa-v1-ember-20240924",
    messages=[
        {
            "role": "user",
            "content": [{"type": "text", "text": "Habari yako?"}],
        }
    ],
    stream=False,
)

print(response["data"]["request"][0]["message"]["content"])

API coverage

Resource	SDK path	Methods
Models	`client.models`	`list`, `retrieve`
Chat	`client.chat`	`create`, `completions`
Voice	`client.voice`	`text_to_speech.create`, `speech_to_text.create`
Vectors	`client.vectors`	`create`, `embeddings`
Documents	`client.documents`	`parse`
Agents	`client.agents`	`create`, `update`, `delete`, `list`, `retrieve`, `chat.create`
Storage	`client.storage.knowledge_base`	CRUD, `list_files`, `semantic_retrieval`
Transcribe	`client.transcribe.workspaces`	CRUD + transcription management

Chat and agent chat support both non-streaming (stream=False) and streaming (stream=True) responses.

Source & package

PyPI: pypi.org/project/pawa-ai
GitHub: github.com/Sartify/pawa-ai-python

PyPI package

Install with pip and read the package description.

Source on GitHub

Browse the SDK source, examples, and issue tracker.

​Requirements

​Installation

​Authentication

​Quick example

​API coverage

​Source & package