localstack-client
A lightweight Python client for LocalStack.
Decision gist · record as of 2026-08-14
Yes, if you are developing or testing AWS-dependent Python code and have LocalStack running locally. The high install friction is a minor drawback, but active maintenance, permissive license, zero runtime dependencies, and no known vulnerabilities make it solid for local cloud development. Not worth installing if you do not use boto3 or do not have LocalStack set up.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- LocalStack must be installed and running locally; the localstack command needs to be available.
- High install friction due to a source distribution requirement.
- The package is actively maintained with a recent release, but installation will require a build step rather than a wheel.
License · maintenance · safety
Apache License 2.0 (permissive) — Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions.
last release 2026-07-21 (24 days) · last repo commit 2026-07-21 · 191 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 964,129 downloads/mo, #4,627 on PyPI
Alternatives
Verify before relying
pip install localstack-client
import localstack_client.session as boto3
client = boto3.client('s3')
response = client.list_buckets()- Specific LocalStack server versions or release cycles that this client version is compatible with.
- Whether all AWS services supported by boto3 are fully functional through this wrapper.
What it is and what it does
localstack-client is a thin Python wrapper around boto3 that automatically configures AWS API endpoints to point to a local LocalStack instance instead of real AWS. It lets you write code using the standard boto3 API—creating S3 buckets, queuing messages to SQS, or any other AWS service operation—but have those calls execute against your local development environment.
The package supports multiple usage patterns: you can import it as a drop-in replacement for boto3, instantiate a session directly, or use a patch function to transparently redirect existing boto3 calls. Configuration is handled via environment variables like AWS_ENDPOINT_URL, LOCALSTACK_HOST, and USE_SSL. It has no external runtime dependencies and supports Python 3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
Use it for
- Write integration tests for AWS-dependent code without provisioning real cloud resources or incurring costs.
- Develop and debug multi-service cloud applications locally using S3, SQS, and other AWS services.
- Mock boto3 calls in pytest fixtures to test code that uses boto3 without modifying the original source.
- Prototype and iterate on cloud infrastructure code before deploying to production AWS.
- Run CI/CD pipelines that exercise AWS service interactions in an isolated, reproducible local environment.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are developing or testing AWS-dependent Python code and have LocalStack running locally.
The high install friction is a minor drawback, but active maintenance, permissive license, zero runtime dependencies, and no known vulnerabilities make it solid for local cloud development. Not worth installing if you do not use boto3 or do not have LocalStack set up.
Install
localstack-client on PyPI
Before you install
High install friction due to a source distribution requirement. The package is actively maintained with a recent release, but installation will require a build step rather than a wheel.
LocalStack must be installed and running locally; the localstack command needs to be available.
License in practice
Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions.
Quickstart
pip install localstack-client
import localstack_client.session as boto3
client = boto3.client('s3')
response = client.list_buckets()Verify before relying
- Specific LocalStack server versions or release cycles that this client version is compatible with.
- Whether all AWS services supported by boto3 are fully functional through this wrapper.
Package facts
| License | Apache License 2.0 permissive |
| Python support | Not specified |
| Install friction | High. Source build required |
| Runtime dependencies | None |
| Maintenance | Actively maintained 24 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 964,129 / month, #4,627 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Testing |
Evidence: localstack_client-2.12.tar.gz
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “boto3 localstack wrapper”
- localstack-clientA Python client that wraps boto3 to redirect AWS API calls to a local…
- moto-extMocks AWS services for testing by intercepting boto3 calls, allowing…
- terraform-localA wrapper script that runs Terraform against LocalStack by…
Give your agent the search over MCP, or paste the wish link into any chat.
More Testing packages
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
virtualenv creates isolated Python environments where packages can be installed independently without affecting the system Python or other projects.
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
pytest-asyncio is a pytest plugin that enables writing and running async test functions using the asyncio library, allowing developers to await code directly within test cases.
Install it if you write tests for any asyncio-based code.
A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist and pytest-playwright for distributed and browser-based testing.
Install it if you need CTRF-formatted test output for CI/CD integration or cross-tool reporting.
See also awscli-local · moto-ext · terraform-local · localstack · localstack-ext · pulumi-local · aws-error-utils · moto · boto · aiomoto