Install & Compatibility
Where this runs
tested against v1.25.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 1.826s · 39.3MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.9s · import 1.690s · 40MB
38MB installed
● package 38MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Client
✓ from aistore.sdk import Client
✗ from aistore import Client
The SDK is in aistore.sdk subpackage
Bucket
✓ from aistore.sdk import Bucket
Object
✓ from aistore.sdk import Object
Create a client, a bucket, put and get an object
from aistore.sdk import Client
# Initialize client with AIS gateway endpoint
gateway_url = os.environ.get('AIS_ENDPOINT', 'http://localhost:8080')
client = Client(gateway_url)
# Create a bucket (if not exists)
try:
client.create_bucket('my-bucket')
except Exception as e:
print(f'Bucket may already exist: {e}')
# Put an object
bucket = client.bucket('my-bucket')
bucket.object('hello.txt').put_content('Hello, AIStore!')
# Get the object back
obj = bucket.object('hello.txt').get()
print(obj.read_text()) # Hello, AIStore!
Errors
Common errors & fixes
ImportError: cannot import name 'Client' from 'aistore'
Trying to import Client from the top-level aistore package instead of aistore.sdk.
fixUse: from aistore.sdk import Client
aistore.sdk.errors.AISConnectionError: Failed to connect to ...
The client is trying to connect to a target node instead of the gateway/proxy, or the gateway is not reachable.
fixEnsure AIS_ENDPOINT points to the proxy URL (usually http://<PROXY_IP>:8080) and that the proxy is running.
aistore.sdk.errors.AISBadArgument: Bucket provider is required
Attempting to access a remote bucket (S3, GCS) without specifying the provider.
fixPass provider='s3' or provider='gcs' to bucket() or create_bucket().
AttributeError: 'Object' object has no attribute 'put_content'
Using an older SDK version (<1.20.0) that still uses put_object/get_object.
fixUpgrade to latest aistore with: pip install --upgrade aistore
Upgrade
Version history
1.25.0latest on PyPI · released May 20, 2026
Audit
Dependencies
requestsrequiredHTTP client for API calls
urllib3requiredUnderlying HTTP transport