liyaengine

Official Python client for the Liya Engine public API.

Status: early access. This SDK currently covers the Collections resource. More resources (Domains, Run, Agents, Workflows, Evals) ship incrementally — see Roadmap.

Install

pip install liyaengine

Quickstart

from liyaengine import LiyaEngine

client = LiyaEngine(api_key="liya_...")

collection = client.collections.create(
    slug="contracts",
    label="Contracts",
    domain_keys=["legal-ops"],
)

collections = client.collections.list()

Or as a context manager (closes the underlying HTTP connection pool automatically):

with LiyaEngine(api_key="liya_...") as client:
    collections = client.collections.list()

Get an API key from your Liya Engine dashboard under Settings → API Keys.

Error handling

Every failed request raises LiyaEngineAPIError, carrying the API's code, message, and HTTP status:

from liyaengine import LiyaEngineAPIError

try:
    client.collections.create(slug="contracts", label="Contracts", domain_keys=["legal-ops"])
except LiyaEngineAPIError as err:
    if err.code == "SLUG_CONFLICT":
        # handle the conflict
        pass
    raise

Network failures and timeouts raise LiyaEngineNetworkError instead. Requests are retried automatically on 429/5xx responses and transient network errors (2 retries by default).

Configuration

LiyaEngine(
    api_key="liya_...",
    base_url="https://api.liyaengine.ai",  # override for local/staging
    timeout_s=30.0,
    max_retries=2,
)

Roadmap

• Collections
• Domains (custom domain + intent CRUD)
• Run / Run (streaming)
• Agents
• Workflows
• Evaluations
• Async client

Full docs: https://liyaengine.ai/docs/sdks/python

Development

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
mypy src
pytest

License

MIT