TibaBot Python Client

Typed Python SDK for the TibaBot Healthcare AI API.

Installation

pip install tibabot-client

Quick Start

from tibabot import TibaBotClient, ChatRequest, TriageRequest, ClinicalAssistRequest

client = TibaBotClient(
    base_url="https://tibabot.vitora.nexora.africa",
    api_key="sk-your-api-key",
)

# Health check
print(client.health())

# Chat with the AI assistant
resp = client.chat(ChatRequest(message="I have a headache for 3 days"))
print(resp.reply)

# Triage symptoms
triage = client.triage(TriageRequest(symptoms=["headache", "fever", "neck stiffness"]))
print(f"Triage level: {triage.triage_level}")
print(f"Red flags: {triage.red_flags_detected}")

# Clinical decision support (provider)
assist = client.clinical_assist(
    ClinicalAssistRequest(query="Treat malaria in pregnancy 2nd trimester")
)
print(assist.recommendation)

# ICD-10 coding
codes = client.icd10_code({"text": "Type 2 diabetes with hypertension"})
print(codes.codes)

client.close()

Authentication

# API key (default)
client = TibaBotClient(base_url="...", api_key="sk-...")

# Bearer token
client = TibaBotClient(base_url="...", bearer_token="eyJ...")

Error Handling

from tibabot import (
    AuthenticationError,
    RateLimitError,
    ValidationError,
    ServerError,
)

try:
    resp = client.chat(ChatRequest(message="Hello"))
except AuthenticationError:
    print("Check your API key")
except RateLimitError as e:
    print(f"Slow down! Retry after {e.retry_after}s")
except ValidationError as e:
    print(f"Invalid request: {e.details}")
except ServerError:
    print("Something went wrong on the server")