This release is a pre-release and may not be stable for production use.
Statsig helps you move faster with feature gates (feature flags), and/or dynamic configs. It also allows you to run A/B/n tests to validate your new features and understand their impact on your KPIs. If you're new to Statsig, check out our product and create an account at statsig.com.
Getting Started
Read through the Documentation or check out the Samples.
ID-list file routing and fallback
download_id_list_file_api selects the preferred base URL for file downloads.
Enable fallback_to_statsig_api to try the original file URL from the manifest
after an overridden request exhausts its retries, provided that URL belongs to
the trusted HTTPS OpenAI CDN origin:
let options = statsig_rust::StatsigOptions {
download_id_list_file_api: Some("http://statsig-proxy:8080".to_string()),
fallback_to_statsig_api: Some(true),
..Default::default()
};
Fallback accepts only https://statsigcdn.openai.com with the default port or
explicit :443. Fallback sends no request or SDK credentials to other manifest
origins; the original request error is returned. Fallback does not follow redirects.
Custom network providers must implement send_without_redirects; otherwise the
fallback returns an error without sending a request. Fallback preserves the URL's
path and query, the file identity, and the byte offset for incremental updates.
Each destination uses its own range protocol: a range query for the OpenAI CDN, or Range and
statsig-id-list-file-size headers for other hosts.
Set fallback_to_statsig_api to Some(false) or leave it unset to keep file
downloads strictly on the selected destination. There is no second attempt when
the override resolves to the original URL, no override is set, or the request
fails with an authentication rejection (401/403) or another non-retryable error.
Response parsing failures do not trigger fallback. This uses the existing option
across language bindings; wrappers that disable it continue to opt out.
A successful proxy request makes no additional request. An eligible failure can add one request to the trusted CDN URL using the existing network timeout and retry policy. The next synchronization starts with the configured override again.
Read-only data stores
Rust data stores can override DataStoreTrait::is_read_only(); Python DataStore
subclasses can override the synchronous is_read_only() method:
def is_read_only(self) -> bool:
return not self.is_leader
The default is False, preserving existing writable stores. Return True for a
follower that only consumes shared cache entries. Bootstrap/polling reads and
config hydration/evaluation remain enabled, but full network responses no longer
build or compress hydrated cache snapshots or call the datastore's write methods.
Delta responses continue to skip snapshot writes. Keep the role stable during an
update. A failing Python capability check is treated as read-only.
Packages
Python protobuf-typed reads and explicit publication callbacks are described in Python typed configs.
Bindings
Community
If you need any assitance or just have a question, feel free to reach out to us on Slack.
3 maintainers
Metadata
3 maintainers
Release files for oai-statsig-python-core 0.33.0b202609301850
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 63.9 MB
Release files / oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 25.9 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ae0efd78d88ea1676a788ada410dec7dddf6e4777c2edc914f028d9e56c5be3e
|
|
BLAKE2b-256 checksum How to use checksums |
4b73f82e06d0ac3e8970a57beee06493ba0ec081ceae2bb1bb36df269eee575b
|
| 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 Oct 1, 2026.
Transparency logRelease files / oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 23.6 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
4e3c6c31c8500ba229c446f5c4cad1022bd604cd714507eb48c47ab7d7921634
|
|
BLAKE2b-256 checksum How to use checksums |
f778ffa4fc9bcb868c212e3fa0d9b5d5b53a095924d756cc68f2ea727ef6fdcf
|
| 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 Oct 1, 2026.
Transparency logRelease files / oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.0 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
18b9468f80100a801d67465df23b4a7ea0628a11b8a7540a8e277f96aff2df7f
|
|
BLAKE2b-256 checksum How to use checksums |
d55d1ecb546f6b43a190bbe2bb056172c774fde7cb8ae8101995537af82c764f
|
| 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 Oct 1, 2026.
Transparency logRelease files / oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | oai_statsig_python_core-0.33.0b202609301850-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 7.3 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
2b8dcfc9b30ae3e37410d2c7726cbf22aeb3a5b579f22edb5a7e39fcfe317799
|
|
BLAKE2b-256 checksum How to use checksums |
135170bb0a4d51333187ff5742e3c165fdc00d194bf0aa4f6d40cd407debb24f
|
| 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 Oct 1, 2026.
Transparency log
