Skip to main content
Storage • 2 mins read

Python (boto3 & minio)

Python

Two libraries work well with Hippius S3: boto3 (AWS SDK) and minio (MinIO SDK). Both are fully supported.

boto3​

Install​

pip install boto3

Connect​

import boto3
from botocore.config import Config

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.hippius.com",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
    region_name="decentralized",
    config=Config(
        signature_version="s3v4",
        s3={"addressing_style": "path"},
    ),
)

Create a bucket​

s3.create_bucket(Bucket="my-bucket")

Upload a file​

# Upload from disk
s3.upload_file("local-file.txt", "my-bucket", "remote-name.txt")

# Upload from memory
s3.put_object(
    Bucket="my-bucket",
    Key="hello.txt",
    Body=b"Hello from Hippius!",
)

Download a file​

# Download to disk
s3.download_file("my-bucket", "remote-name.txt", "local-file.txt")

# Download to memory
response = s3.get_object(Bucket="my-bucket", Key="hello.txt")
content = response["Body"].read()
print(content.decode())

List objects​

response = s3.list_objects_v2(Bucket="my-bucket")
for obj in response.get("Contents", []):
    print(obj["Key"], obj["Size"])

Delete an object​

s3.delete_object(Bucket="my-bucket", Key="hello.txt")

Presigned URL​

url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "hello.txt"},
    ExpiresIn=3600,  # 1 hour
)
print(url)

minio SDK​

Install​

pip install minio

Connect​

from minio import Minio

client = Minio(
    "s3.hippius.com",
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    secure=True,
    region="decentralized",
)

Create a bucket​

client.make_bucket("my-bucket")

Upload a file​

# From disk
client.fput_object("my-bucket", "remote-name.txt", "local-file.txt")

# From memory
from io import BytesIO

data = b"Hello from Hippius!"
client.put_object(
    "my-bucket", "hello.txt",
    BytesIO(data), len(data),
    content_type="text/plain",
)

Download a file​

# To disk
client.fget_object("my-bucket", "remote-name.txt", "local-file.txt")

# To memory
response = client.get_object("my-bucket", "hello.txt")
print(response.read().decode())
response.close()
response.release_conn()

List objects​

for obj in client.list_objects("my-bucket", recursive=True):
    print(obj.object_name, obj.size)

Presigned URL​

from datetime import timedelta

url = client.presigned_get_object(
    "my-bucket", "hello.txt",
    expires=timedelta(hours=1),
)
print(url)

Complete Working Example (boto3)​

Save this script as hippius_s3.py and run it with your credentials:

import boto3
from botocore.config import Config

# 1. Connect to Hippius S3
s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.hippius.com",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
    region_name="decentralized",
    config=Config(
        signature_version="s3v4",
        s3={"addressing_style": "path"},
    ),
)

bucket_name = "hippius-demo-bucket"
file_key = "greeting.txt"

# 2. Create bucket
print(f"Creating bucket: {bucket_name}")
try:
    s3.create_bucket(Bucket=bucket_name)
except s3.exceptions.BucketAlreadyOwnedByYou:
    print("Bucket already exists.")

# 3. Upload string
print(f"Uploading file: {file_key}")
s3.put_object(
    Bucket=bucket_name,
    Key=file_key,
    Body=b"Welcome to Hippius S3 Storage!",
)

# 4. List objects
print("Listing objects:")
response = s3.list_objects_v2(Bucket=bucket_name)
for obj in response.get("Contents", []):
    print(f" - {obj['Key']} ({obj['Size']} bytes)")

# 5. Download file
print("Downloading file:")
response = s3.get_object(Bucket=bucket_name, Key=file_key)
content = response["Body"].read().decode("utf-8")
print(f" File content: {content}")

# 6. Generate presigned URL
print("Generating presigned URL:")
url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": bucket_name, "Key": file_key},
    ExpiresIn=3600,
)
print(f" URL: {url}")