frootai-orchard
Programmatic Python SDK for the FrootAI Orchard catalog — type-safe list / search / show / bushel surface for partner apps, CI pipelines, and BI integrations.
Byte-equal contract with the npm @frootai/orchard v1.0.0 SDK: same enums, same filter expression language, same HMAC-signed pagination cursors, same retry semantics, same shared ~/.frootai/.token auth file. A query that returns 12 results in JS returns the same 12 results in Python.
Install
pip install frootai-orchard
Zero runtime dependencies. Python 3.10+. Stdlib only (urllib, hmac, base64, json, hashlib, pathlib).
Quickstart
from frootai_orchard import create_client
client = create_client()
# Anonymous catalog reads — no auth required
for fruit in client.list(variety="azure", where="ripeness:Mature OR ripeness:Bearing"):
print(fruit["name"], "—", fruit.get("tagline", ""))
# Search with scoring
for hit in client.search("rag", limit=10):
print(f'{hit["_score"]:>2} {hit["name"]}')
# Single fruit detail
detail = client.show("ms-azure-openai-rag")
# Authenticated — bushel sync (Team tier+)
client.bushel.add("ms-azure-openai-rag")
print(client.bushel.list()["ids"])
# Never-raises auth probe
print(client.whoami())
# → {"signed_in": True, "anonymous": False, "redacted": "…a3f9", ...}
Auth priority
token=keyword argumentFROOTAI_TOKENenvironment variable~/.frootai/.tokenshared file (same as thefrootaiCLI)
A frootai login in your terminal transparently authorizes Python SDK calls.
Typed errors
Every public surface raises only FrootaiOrchardError subclasses — partners catch by type, never by string match:
from frootai_orchard import errors as fai_err
try:
client.bushel.add("some-fruit")
except fai_err.NotSignedInError:
print("Run `frootai login` first")
except fai_err.EntitlementRequiredError as e:
print(f'Upgrade required: {e.context["entitlement"]}')
except fai_err.RateLimitError as e:
print(f"Slow down — retry after {e.retry_after_ms} ms")
Filter expression language
Identical grammar to the npm SDK:
client.list(where="tier_class:paid AND variety:azure")
client.list(where="ripeness:Mature OR (variety:gcp AND category:rag)")
client.list(where='NOT category:eval')
License
MIT
Metadata
Release files for frootai-orchard 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| frootai_orchard-1.0.0.tar.gz | 28.0 kB | Without provenance | Details for frootai_orchard-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| frootai_orchard-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for frootai_orchard-1.0.0-py3-none-any.whl |
Total release size: 59.4 kB
Release files / frootai_orchard-1.0.0.tar.gz
| Download URL | frootai_orchard-1.0.0.tar.gz |
|---|---|
| Size | 28.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
93e1a0fb6044096bf70e171dc1448e66042daa6b3cb5e2dd5d37e1068f8be4d6
|
|
BLAKE2b-256 checksum How to use checksums |
6eb81a82d74d9f99b5c61ab2f9702b0a38c100af7e79aaf579d3d4497a5f286f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / frootai_orchard-1.0.0-py3-none-any.whl
| Download URL | frootai_orchard-1.0.0-py3-none-any.whl |
|---|---|
| Size | 31.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64d59a70e03e87d121d86e0656ede577281320b509cba5db3a5e5da4d636bcbf
|
|
BLAKE2b-256 checksum How to use checksums |
37da86389f8bffebe89a94abecefbc22f41f1739727111e5ff11f9f90374feba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Security for frootai-orchard 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.