aws-cdk.aws-s3-assets
Deploy local files and directories to S3
Decision gist · record as of 2026-08-14
No—this package is part of AWS CDK v1, which reached End-of-Support on 2023-06-01 and is no longer being updated. AWS explicitly recommends migrating to AWS CDK v2. Install only if maintaining legacy v1 infrastructure; for new projects or migrations, use the v2 equivalent instead.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires AWS CDK core and construct libraries to be installed; asset bundling with Docker requires Docker to be available or a local bundling provider to be implemented.
- Low friction installation with 10 runtime dependencies.
- Package is in active maintenance status but reached End-of-Support on 2023-06-01; AWS CDK v1 is no longer being updated and users should migrate to AWS CDK v2.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.
last release 2023-06-19 (1152 days) · last repo commit 2026-08-14 · 12,868 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 184,821 downloads/mo, #10,024 on PyPI
Alternatives
Verify before relying
from aws_cdk import aws_s3_assets as assets
import os
asset = assets.Asset(None, "SampleAsset",
path=os.path.join(os.path.dirname(__file__), "sample-asset-directory")
)
print(asset.s3_bucket_name)
print(asset.s3_object_key)- Whether v1 packages continue to receive security patches despite End-of-Support status
- Migration path complexity and effort for existing v1 applications moving to v2
What it is and what it does
aws-cdk.aws-s3-assets is a component of AWS CDK v1 that automates the packaging and deployment of local files and directories to S3 during CDK stack synthesis. When you define an Asset construct pointing to a local path, the toolkit automatically archives the content (if it's a directory), calculates an MD5 hash, uploads it to an environment-specific S3 bucket, and injects the S3 location as CloudFormation parameters into your stacks. This is commonly used to bundle Lambda function code, static assets, or any artifact needed by your infrastructure.
The package supports optional Docker-based bundling for preprocessing assets before upload—for example, compiling code, converting file formats, or installing dependencies. You can also implement local bundling providers to avoid Docker overhead. Assets expose deploy-time attributes like bucket name, object key, and HTTP URL that can be referenced in your stack outputs or passed to other constructs. The package integrates deeply with CDK's synthesis and deployment pipeline, handling asset versioning and deduplication transparently.
Use it for
- Package Lambda function handler code and dependencies into a zip file for upload to S3 during CDK deployment
- Bundle static web assets or configuration files and inject their S3 URLs into CloudFormation stacks
- Use Docker containers to preprocess assets (e.g., compile TypeScript, minify CSS) before uploading to S3
- Grant IAM roles read permissions on deployed assets using the grantRead() method for runtime access
- Export asset S3 locations as stack outputs for reference by other stacks or external tools
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—this package is part of AWS CDK v1, which reached End-of-Support on 2023-06-01 and is no longer being updated.
AWS explicitly recommends migrating to AWS CDK v2. Install only if maintaining legacy v1 infrastructure; for new projects or migrations, use the v2 equivalent instead.
Install
aws-cdk-aws-s3-assets on PyPI
Before you install
Low friction installation with 10 runtime dependencies. Package is in active maintenance status but reached End-of-Support on 2023-06-01; AWS CDK v1 is no longer being updated and users should migrate to AWS CDK v2.
Requires AWS CDK core and construct libraries to be installed; asset bundling with Docker requires Docker to be available or a local bundling provider to be implemented.
License in practice
Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.
Quickstart
from aws_cdk import aws_s3_assets as assets
import os
asset = assets.Asset(None, "SampleAsset",
path=os.path.join(os.path.dirname(__file__), "sample-asset-directory")
)
print(asset.s3_bucket_name)
print(asset.s3_object_key)Verify before relying
- Whether v1 packages continue to receive security patches despite End-of-Support status
- Migration path complexity and effort for existing v1 applications moving to v2
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release ~=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesaws-cdk.assetsaws-cdk.aws-iamaws-cdk.aws-kmsaws-cdk.aws-s3aws-cdk.coreaws-cdk.cx-apiconstructsjsiipublicationtypeguard |
| Maintenance | Actively maintained 1,152 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 184,821 / month, #10,024 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 7 - InactiveFramework :: AWS CDKFramework :: AWS CDK :: 1Intended Audience :: DevelopersLicense :: OSI ApprovedOperating System :: OS IndependentProgramming Language :: JavaScriptProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Typing :: Typed |
Evidence: aws_cdk.aws_s3_assets-1.204.0-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 › “aws cdk s3 asset deployment”
- aws-cdk.aws-s3-assetsPackages local files and directories for deployment to S3 as part of…
- aws-cdk.aws-s3-deploymentDeploys files and directories to AWS S3 buckets as part of AWS CDK…
- cdk-ecr-deploymentA CDK construct that copies Docker images between registries (ECR,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also aws-cdk.aws-ecr-assets · aws-cdk.aws-s3-deployment · aws-cdk.asset-awscli-v1 · aws-cdk.asset-node-proxy-agent-v6 · aws-cdk.asset-node-proxy-agent-v5 · aws-cdk.integ-tests-alpha · cdk-ecr-deployment · aws-cdk.aws-lambda-python-alpha · aws-cdk.aws-imagebuilder · aws-cdk.region-info