awscli-local
Thin wrapper around the "aws" command line interface for use with LocalStack
Decision gist · record as of 2026-08-14
Yes, if you are actively developing or testing AWS-dependent code locally with LocalStack. The low install friction, permissive license, and straightforward command-line interface make it a practical choice. However, note that maintenance is aging (372 days since last release) and AWS CLI v2 support remains unofficial; if you rely on v2 features or need active maintenance, verify compatibility first or consider the documented bash alias alternative.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires LocalStack running on localhost:4566 (or configured via AWS_ENDPOINT_URL environment variable); AWS CLI v1 is recommended for full compatibility.
- Low install friction with a single runtime dependency (localstack-client).
- Maintenance status is aging—last release was 372 days ago, though the repository remains active with recent commits and moderate community engagement (1299 stars).
License · maintenance · safety
Apache License 2.0 (permissive) — Released under Apache License 2.0 (permissive), imposing no restrictions on use, modification, or distribution in proprietary or open-source projects.
last release 2025-08-07 (372 days) · last repo commit 2026-02-12 · 1,299 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,256,349 downloads/mo, #4,154 on PyPI
Alternatives
Verify before relying
pip install awscli-local
# Then use awslocal exactly like aws:
awslocal kinesis list-streams
# Instead of: aws --endpoint-url=http://localhost:4566 kinesis list-streams- Whether AWS CLI v2 support has been added since the last release (v0.22.2 notes indicate it was not officially supported).
- Current compatibility with Python 2.x versions listed in classifiers, given the package's age and Python 2 end-of-life.
What it is and what it does
awscli-local is a command-line wrapper that intercepts AWS CLI calls and redirects them to a LocalStack instance running locally, typically on localhost:4566. Instead of typing `aws --endpoint-url=http://localhost:4566 kinesis list-streams`, you simply run `awslocal kinesis list-streams` with the same syntax as the standard AWS CLI. The wrapper handles endpoint URL injection, placeholder credentials, and region defaults automatically, and includes patches for AWS CLI quirks like CloudFormation's `package` command, which normally cannot specify an S3 endpoint.
The package depends only on localstack-client and is designed for developers testing AWS-dependent code locally without hitting real AWS services. It supports shell command completion and respects environment variables like AWS_ENDPOINT_URL, LOCALSTACK_HOST, and USE_SSL for configuration. The wrapper works with AWS CLI v1 out of the box; v2 support is documented as technically possible but not officially packaged.
Use it for
- Local development and testing of AWS Lambda, DynamoDB, S3, and other services without incurring AWS costs or hitting real infrastructure.
- Integration testing in CI/CD pipelines where you spin up LocalStack in a container and run awslocal commands against it.
- CloudFormation template development and testing locally before deploying to production AWS accounts.
- Rapid prototyping of serverless applications with immediate feedback without AWS account setup overhead.
- Teaching or demonstrating AWS CLI workflows in isolated environments without risk of accidental production changes.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are actively developing or testing AWS-dependent code locally with LocalStack.
The low install friction, permissive license, and straightforward command-line interface make it a practical choice. However, note that maintenance is aging (372 days since last release) and AWS CLI v2 support remains unofficial; if you rely on v2 features or need active maintenance, verify compatibility first or consider the documented bash alias alternative.
Install
awscli-local on PyPI
Before you install
Low install friction with a single runtime dependency (localstack-client). Maintenance status is aging—last release was 372 days ago, though the repository remains active with recent commits and moderate community engagement (1299 stars).
Requires LocalStack running on localhost:4566 (or configured via AWS_ENDPOINT_URL environment variable); AWS CLI v1 is recommended for full compatibility.
License in practice
Released under Apache License 2.0 (permissive), imposing no restrictions on use, modification, or distribution in proprietary or open-source projects.
Quickstart
pip install awscli-local
# Then use awslocal exactly like aws:
awslocal kinesis list-streams
# Instead of: aws --endpoint-url=http://localhost:4566 kinesis list-streamsVerify before relying
- Whether AWS CLI v2 support has been added since the last release (v0.22.2 notes indicate it was not officially supported).
- Current compatibility with Python 2.x versions listed in classifiers, given the package's age and Python 2 end-of-life.
Package facts
| License | Apache License 2.0 permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagelocalstack-client |
| Maintenance | Aging 372 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,256,349 / month, #4,154 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 :: 2Programming Language :: Python :: 2.6Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.3Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Testing |
Evidence: awscli_local-0.22.2-py3-none-any.whl
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 › “localstack aws cli wrapper”
- awscli-localProvides the `awslocal` command, a thin wrapper around the AWS CLI…
- terraform-localA wrapper script that runs Terraform against LocalStack by…
- pulumi-localA command-line wrapper that adapts Pulumi infrastructure-as-code…
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 localstack-client · pulumi-local · terraform-local · awscliv2 · awscli · localstack · localstack-ext · awslogs · moto-ext · virtualenvwrapper