SAIA Python Wrapper#

A Python wrapper for the GWDG SAIA platform REST API, providing object-oriented and functional interfaces to Chat AI, Voice AI, ARCANA (RAG), and document conversion services.

Getting Started

Installation, authentication, and initial API calls.

Getting Started
Explanations

Architecture, implementation rationale, and configuration reference.

Explanations
API Reference

Complete reference for all classes and functions.

API Reference
Extensions

Higher-level recipes built on the wrapper — e.g. ARCANA incremental sync and tokenizers.

Extensions
Development

Local setup, testing, documentation builds, and release workflow.

Development
Architecture Decisions

Records of significant design decisions (MADR format) and their rationale.

Architecture Decision Records

Wrapped Services#

  • Chat AI — chat completions with streaming and tool calling

  • Voice AI — audio transcription and translation (Whisper)

  • ARCANA — RAG: knowledge base management and retrieval-augmented chat

  • Documents (Docling) — PDF and document conversion to Markdown, HTML, JSON

  • Models — list available models and probe tool-calling support

  • Rate Limits — inspect current quota and usage

Minimal example#

from saia_python import SAIAClient

client = SAIAClient()  # API key resolved from env var, .saia_api, or .env

print(client.models.list_ids())

response = client.chat.completions(
    model="meta-llama-3.1-8b-instruct",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response["choices"][0]["message"]["content"])
print(client.get_rate_limits())

Institutions & Funding#


CIDBN Logo

The developer team is part of the Göttingen Campus Institute for Dynamics of Biological Networks (CIDBN).