ayva-ingest

Thin Python client for AYVA automated data sources.

Upload a pandas DataFrame, CSV file, or Parquet file to the source bound to your API key. The client normalizes to Snappy Parquet and enforces the 1 MiB canonical limit before the request leaves your machine.

Install

pip install ayva-ingest

Usage

import pandas as pd
from ayva_ingest import AyvaSource

source = AyvaSource(
    api_key="ayva_live_…",
    # Use your AYVA deployment origin (no trailing path).
    base_url="https://ayva-staging.onrender.com",
)

source.upload(
    pd.DataFrame({"period": ["2026-Q1"], "revenue": [100]}),
    idempotency_key="revenue-2026-q1",
)
source.upload("revenue.csv", idempotency_key="revenue-csv-2026-q2")
source.upload("revenue.parquet", idempotency_key="revenue-pq-2026-q3")

Create and rotate keys in Report Library → Data Integration → Keys.

API contract (summary)

• PUT {base_url}/api/v1/source/data
• Authorization: Bearer ayva_live_…
• Required unique Idempotency-Key
• Body: canonical Parquet (application/vnd.apache.parquet)

Publish (maintainers)

cd sdk/python
python -m pip install -U build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*

Use __token__ as the username and a PyPI API token as the password. Bump version in pyproject.toml for every release (PyPI versions are immutable).

License

MIT