---
id: boto-session-manager
version: "2.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# boto_session_manager — Provides an alternative, or maybe a more user friendly way to use the native boto3 API.

License: permissive · Maintenance: active · Downloads: 893.4K/mo

## What it is and what it does

boto_session_manager is a lightweight wrapper around boto3.Session that adds IDE auto-complete, type hints, and credential management. It exposes 400+ typed client properties (like bsm.s3_client, bsm.ec2_client) that cache underlying boto3 clients on first access, reducing connection overhead. The library supports multiple credential sources—default chain, named profiles, explicit keys, or custom botocore sessions—and provides utilities to inspect AWS identity (account ID, user ID, principal ARN, region) with optional masking for safe logging.

The package also handles IAM role assumption, returning a new fully-independent BotoSesManager under the assumed role, and offers credential snapshots for cross-process serialization. It integrates with boto3-stubs to deliver method-level auto-complete and argument type hints when that package is installed. With zero runtime dependencies and a pure-Python wheel, it adds minimal friction to existing boto3 workflows.

Use it for:

- Build AWS applications with IDE auto-complete and type checking for all boto3 service clients.
- Reduce boto3 client creation overhead by caching clients across your application.
- Assume IAM roles programmatically and get a ready-to-use session manager for cross-account operations.
- Log AWS identity information safely by masking sensitive account and user IDs.
- Inject AWS credentials into subprocess environments for AWS CLI commands via context manager.
- Serialize and restore AWS credentials across process boundaries for distributed workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wraps boto3 sessions with typed client properties, caching, and credential management to simplify AWS SDK use in Python applications.

Yes. Zero runtime dependencies, low install friction, active maintenance, and no known vulnerabilities make this a safe addition. It meaningfully improves the boto3 developer experience through type hints and caching without imposing operational burden. Recommended for teams already using boto3 who want better IDE support and credential management.

## Install

pip install boto-session-manager
uv add boto-session-manager
poetry add boto-session-manager

## Installing boto_session_manager

Before you install: Low install friction with zero runtime dependencies and a pure-Python wheel. Active maintenance with recent releases; last commit 2026-04-24.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install boto_session_manager

from boto_session_manager.api import BotoSesManager

bsm = BotoSesManager()
bsm.s3_client.list_buckets()

Requires Python 3.10 or later; boto3 must be installed separately as a peer dependency.

Verify before relying:

- Whether boto3-stubs integration requires explicit installation or works automatically
- Performance impact of credential caching in high-concurrency scenarios
- Support for AWS credential providers beyond those documented in the excerpt

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 893.4K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

boto3 session management, AWS SDK wrapper, typed boto3 clients, AWS credential handling, boto3 client caching, IAM role assumption, AWS identity inspection, aws-sdk, credential-management, type-hints

[View on SkillFed](https://skillfed.io/packages/boto-session-manager) · [View on PyPI](https://pypi.org/project/boto-session-manager/)