About this project

AWS CLI is a unified command-line interface for Amazon Web Services. This README covers version 1, which is in maintenance mode from August 5, 2026 until end-of-support on July 15, 2027; maintenance releases are limited to critical bug fixes and security issues, and AWS recommends migrating to AWS CLI v2. The package requires Python 3.10 or later and can be installed with pip, preferably in a virtual environment, using `python -m pip install awscli`. It can also be installed globally or for the current user, upgraded with pip, or deployed through platform-specific bundled or MSI installers. Before use, credentials can be configured through `aws configure`, environment variables, the shared `~/.aws/credentials` file, an `~/./aws/config` file, or an IAM role when running on EC2. Multiple named profiles are supported and selected with `--profile`; configuration file locations can be overridden with environment variables. Commands follow the pattern `aws <command> <subcommand> [options and parameters]`, such as `aws s3 ls`. Built-in help is available through `aws help` and command-specific help subcommands. The CLI also supports version reporting, debug output, configurable default regions and output formats, and optional command completion for Unix-like shells. Support resources include GitHub issues, Stack Overflow, AWS discussion forums, AWS Support, changelogs, and official AWS documentation.