Skip to main content

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_BUNDLE or SSL_CERT_FILE, or the ca_bundle setting. 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

istari_digital_client-13.0.1.tar.gz (580.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

istari_digital_client-13.0.1-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

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

Hashes for istari_digital_client-13.0.1.tar.gz
Algorithm Hash digest
SHA256 48467fd087eb512af809600549903590745537d66ef0815ca9c5c2f5d76d5ac1
MD5 71083de716f15d55f8fb9bd3b06d2507
BLAKE2b-256 d36989f044842f8cbd9a064ac4fd74b4e579d0753f01a97d2337df7f21bea0a2

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file istari_digital_client-13.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for istari_digital_client-13.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a6ef2e201225c0423a0079a50f7c94e409170ec370f2c87a633b7e855b64b779
MD5 241ffed6e23f26312e4a46dbcf5f5807
BLAKE2b-256 a3dae3f05860b1a92c6d2a40cacfe15dcad72c4f9b7e119fd25fca4f3a184002

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

13.0.1 This release

2 files

13.0.0

2 files

12.0.0

2 files

11.2.0

2 files

11.1.0

2 files

11.0.0

2 files

10.14.0

2 files

10.11.1

2 files

10.11.0

2 files

10.10.5

2 files

10.10.3

2 files

10.10.2

2 files

10.10.1

2 files

10.10.0

2 files

10.9.5

2 files

10.9.4

2 files

10.9.2

2 files

10.8.6

2 files

10.8.4

2 files

10.8.2

2 files

10.7.0

2 files

10.6.0

2 files

10.5.0

2 files

10.4.0

2 files

10.3.1

2 files

10.3.0

2 files

10.2.0

2 files

10.1.0

2 files

10.0.0

2 files

9.0.0

2 files

8.0.1

2 files

8.0.0

2 files

7.21.2

2 files

7.21.1

2 files

7.20.1

2 files

7.20.0

2 files

7.19.3

2 files

7.19.2

2 files

7.19.1

2 files

7.19.0

2 files

7.18.1

2 files

7.18.0

2 files

7.17.0

2 files

7.16.1

2 files

7.16.0

2 files

7.15.1

2 files

7.15.0

2 files

7.14.0

2 files

7.13.0

2 files

7.12.0

2 files

7.11.0

2 files

7.10.0

2 files

7.9.0

2 files

7.8.0

2 files

7.7.0

2 files

7.6.2

2 files

7.6.1

2 files

7.6.0

2 files

7.5.0

2 files

7.4.0

2 files

7.3.7

2 files

7.3.6

2 files

7.3.5

2 files

7.3.4

2 files

7.3.3

2 files

7.3.2

2 files

7.3.1

2 files

7.3.0

2 files

7.2.0

2 files

7.0.0

2 files

6.5.1

2 files

6.5.0

2 files

6.4.0

2 files

6.3.0

2 files

6.2.0

2 files

6.0.4

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page