Istari Digital Client
The istari-digital-client library is a client SDK for interacting with the Istari Digital platform.
- Install:
pip install istari-digital-client - Documentation and Usage: Please see docs.istaridigital.com.
- Supported Versions: This library supports Python 3.10, 3.11, 3.12, and 3.14
- License: This library is released under an MIT license with the following clarification:
No license is hereby implied or granted to any patent or patent application relating to the Istari Digital platform itself. The list of patents applicable to the Istari Digital platform may be found at istaridigital.com/patent-list.
Direct S3 Upload
For environments with direct access to the backing S3 bucket, the client can bypass presigned URLs and upload via boto3 instead. This can improve throughput and simplifies large-file handling (boto3 manages multipart automatically).
Install the optional dependency:
# S3-compatible storage (minio, AWS, etc.)
pip install istari-digital-client[s3]
# AWS with high-speed CRT transfers (recommended for EC2 containers in same s3 environment as the data plane buckets)
pip install istari-digital-client[s3-crt]
Then configure via environment variables or constructor arguments:
| Environment Variable | Constructor Arg | Description |
|---|---|---|
ISTARI_CLIENT_S3_DIRECT_UPLOAD |
s3_direct_upload_enabled |
Set to true to enable direct S3 uploads |
ISTARI_CLIENT_S3_BUCKET_NAME |
s3_bucket_name |
Target S3 bucket name (required when enabled) |
Standard AWS credentials (environment variables, profile, or instance role) must be available for boto3 to authenticate.
Proxy Support
The client honors the conventional proxy environment variables — HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and NO_PROXY (upper or lower case; lowercase wins) — for all of its HTTP traffic, including presigned object-store downloads. No configuration is needed on a host that already has these set.
There are two common proxy shapes:
- CONNECT tunneling (the proxy passes TLS through untouched): proxy settings alone are enough.
- TLS termination (the proxy re-signs TLS with its own certificate authority): additionally provide the CA bundle that trusts the proxy's CA, via
REQUESTS_CA_BUNDLEorSSL_CERT_FILE, or theca_bundlesetting. Certificate verification is always required — there is no insecure mode.
| Environment Variable | Constructor Arg | Description |
|---|---|---|
ISTARI_CLIENT_PROXY_URL |
proxy_url |
Explicit proxy for HTTP(S) traffic; overrides HTTP_PROXY/HTTPS_PROXY/ALL_PROXY. Credentials may be embedded (http://<user>:<password>@proxy:8080) and are sent as a Proxy-Authorization header. |
ISTARI_CLIENT_CA_BUNDLE |
ca_bundle |
PEM CA bundle for TLS verification; overrides REQUESTS_CA_BUNDLE/SSL_CERT_FILE. |
ISTARI_CLIENT_TRUST_ENV |
trust_env |
Set to false to ignore the proxy and CA environment variables entirely (explicit settings above still apply). Defaults to true. |
NO_PROXY is honored with exact and dot-boundary suffix matching (NO_PROXY=internal.example bypasses the proxy for registry.internal.example), including when proxy_url is set explicitly. When the Istari control plane is reached over a direct route (for example a site-to-site VPN) while object storage requires the proxy, list the control-plane host in NO_PROXY.
SOCKS proxies are not supported: an explicit SOCKS proxy_url is rejected with an error, while a SOCKS URL arriving via environment variables (for example ALL_PROXY=socks5://...) is ignored with a warning and the client connects directly — it does not route traffic through the SOCKS proxy.
Contributing
See the contributing doc for additional info.
1 maintainer
Release files for istari-digital-client 13.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| istari_digital_client-13.1.1.tar.gz | 590.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| istari_digital_client-13.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / istari_digital_client-13.1.1.tar.gz
| Download URL | istari_digital_client-13.1.1.tar.gz |
|---|---|
| Size | 590.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
492d7bf48696d330f9142d63e56ab599b641afa8c6273ccc1aa37421f42242ea
|
|
BLAKE2b-256 checksum How to use checksums |
8dc42a88e410ddc83ae90055e7724f7f4da20c990b3e83b9456e06ebd189dfff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency logRelease files / istari_digital_client-13.1.1-py3-none-any.whl
| Download URL | istari_digital_client-13.1.1-py3-none-any.whl |
|---|---|
| Size | 1.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a218934be854b7860a95ecd2ad2f2538434f3707b3949343629800297e4df9eb
|
|
BLAKE2b-256 checksum How to use checksums |
d692d3a56a7f50c75e157b9cc74229b76431cef8e3359c431bb086d4273edbcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency log
