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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file istari_digital_client-13.0.1.tar.gz.
File metadata
- Download URL: istari_digital_client-13.0.1.tar.gz
- Upload date:
- Size: 580.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
48467fd087eb512af809600549903590745537d66ef0815ca9c5c2f5d76d5ac1
|
|
| MD5 |
71083de716f15d55f8fb9bd3b06d2507
|
|
| BLAKE2b-256 |
d36989f044842f8cbd9a064ac4fd74b4e579d0753f01a97d2337df7f21bea0a2
|
Provenance
The following attestation bundles were made for istari_digital_client-13.0.1.tar.gz:
Publisher:
release.yml on Istari-digital/istari-python-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
istari_digital_client-13.0.1.tar.gz -
Subject digest:
48467fd087eb512af809600549903590745537d66ef0815ca9c5c2f5d76d5ac1 - Sigstore transparency entry: 2618199712
- Sigstore integration time:
-
Permalink:
Istari-digital/istari-python-client@908fbf5c0d05e7ab8c4015c625e313d89af79a4a -
Branch / Tag:
refs/tags/v13.0.1 - Owner: https://github.com/Istari-digital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@908fbf5c0d05e7ab8c4015c625e313d89af79a4a -
Trigger Event:
push
-
Statement type:
File details
Details for the file istari_digital_client-13.0.1-py3-none-any.whl.
File metadata
- Download URL: istari_digital_client-13.0.1-py3-none-any.whl
- Upload date:
- Size: 1.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a6ef2e201225c0423a0079a50f7c94e409170ec370f2c87a633b7e855b64b779
|
|
| MD5 |
241ffed6e23f26312e4a46dbcf5f5807
|
|
| BLAKE2b-256 |
a3dae3f05860b1a92c6d2a40cacfe15dcad72c4f9b7e119fd25fca4f3a184002
|
Provenance
The following attestation bundles were made for istari_digital_client-13.0.1-py3-none-any.whl:
Publisher:
release.yml on Istari-digital/istari-python-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
istari_digital_client-13.0.1-py3-none-any.whl -
Subject digest:
a6ef2e201225c0423a0079a50f7c94e409170ec370f2c87a633b7e855b64b779 - Sigstore transparency entry: 2618199747
- Sigstore integration time:
-
Permalink:
Istari-digital/istari-python-client@908fbf5c0d05e7ab8c4015c625e313d89af79a4a -
Branch / Tag:
refs/tags/v13.0.1 - Owner: https://github.com/Istari-digital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@908fbf5c0d05e7ab8c4015c625e313d89af79a4a -
Trigger Event:
push
-
Statement type: