Skip to content

Getting Started

This guide will help you get started with the AIBS Informatics AWS Utils library.

Installation

Using pip

pip install aibs-informatics-aws-utils

Using uv

uv add aibs-informatics-aws-utils

Prerequisites

AWS Credentials

This library requires valid AWS credentials to interact with AWS services. You can configure credentials using:

  1. Environment Variables

    export AWS_ACCESS_KEY_ID=your_access_key
    export AWS_SECRET_ACCESS_KEY=your_secret_key
    export AWS_DEFAULT_REGION=us-west-2
    

  2. AWS Credentials File (~/.aws/credentials)

    [default]
    aws_access_key_id = your_access_key
    aws_secret_access_key = your_secret_key
    

  3. IAM Roles (recommended for EC2/Lambda/ECS)

Basic Examples

Working with S3

from aibs_informatics_aws_utils.s3 import get_s3_client

# Get an S3 client
s3_client = get_s3_client()

# List buckets
response = s3_client.list_buckets()
for bucket in response['Buckets']:
    print(bucket['Name'])

Working with ECR

from aibs_informatics_aws_utils.ecr import get_ecr_client

# Get ECR client
ecr_client = get_ecr_client()

# List repositories
repos = ecr_client.describe_repositories()

Working with Lambda

from aibs_informatics_aws_utils.lambda_ import call_lambda_function_url

# Invoke a Lambda function
response = call_lambda_function_url(
    function_name="my-function",
    payload={"key": "value"}
)

Next Steps