Rafflesia Python SDK

A typed Python client for the Rafflesia public API, generated from the server's OpenAPI contract by the oagen product generator.

pip install rafflesia-sdk

from rafflesia import Rafflesia

client = Rafflesia(api_key="...")  # or RAFFLESIA_API_KEY env var
databases = client.homology.databases.list()
releases = client.homology.databases.releases.list("tomato")
result = client.homology(
    database="tomato",
    query={
        "kind": "protein_sequence",
        "sequence": "MTEYKLVVVGAGGVGKSALTIQLIQNHFVDEYDPTIEDSYRKQ",
    },
)
batch = client.homology_many(
    database_release_id=releases.data[0].id,
    queries=[
        {"kind": "protein_sequence", "sequence": "MTEYK"},
        {"kind": "protein_sequence", "sequence": "GAGGVGKS"},
    ],
    include=[],
    limit=100,
)

Async:

from rafflesia import AsyncRafflesia

async with AsyncRafflesia(api_key="...") as client:
    result = await client.homology(
        database="tomato",
        query={"kind": "protein_sequence", "sequence": "MTEYK"},
    )
    batch = await client.homology_many(
        database="tomato",
        queries=[
            {"kind": "protein_sequence", "sequence": "MTEYK"},
            {"kind": "protein_sequence", "sequence": "GAGGVGKS"},
        ],
    )

base_url defaults to https://api.rafflesia.ai (override via the base_url argument or RAFFLESIA_API_BASE_URL). When no API key is configured the client sends anonymous requests, which is convenient against a local unauthenticated server.

Layout

• rafflesia/resources/, rafflesia/types/ — generated from the OpenAPI contract; do not edit by hand. Regenerate with factory/generators/oagen/retab-gen → node scripts/generate-product.mjs python.
• rafflesia/client.py, rafflesia/_resource.py, rafflesia/exceptions.py, rafflesia/utils/ — hand-written runtime the emitter reuses; kept stable across regeneration (the emitter only prunes files it previously generated).